Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.debian.user > #236196 > unrolled thread
| Started by | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| First post | 2021-06-18 18:10 +0200 |
| Last post | 2021-06-20 09:00 +0200 |
| Articles | 14 — 8 participants |
Back to article view | Back to linux.debian.user
This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by
below is the oldest one visible, not the original post.
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... "Susmita/Rajib" <bkpsusmitaa@gmail.com> - 2021-06-18 18:10 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Michael Grant <mgrant@grant.org> - 2021-06-18 23:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... "Susmita/Rajib" <bkpsusmitaa@gmail.com> - 2021-06-19 04:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Richard Hector <richard@walnut.gen.nz> - 2021-06-19 09:00 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... The Wanderer <wanderer@fastmail.fm> - 2021-06-19 11:30 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Andrei POPESCU <andreimpopescu@gmail.com> - 2021-06-20 08:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... "Susmita/Rajib" <bkpsusmitaa@gmail.com> - 2021-06-19 10:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... "Susmita/Rajib" <bkpsusmitaa@gmail.com> - 2021-06-20 07:40 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... "Susmita/Rajib" <bkpsusmitaa@gmail.com> - 2021-06-21 08:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Greg Wooledge <greg@wooledge.org> - 2021-06-21 13:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Greg Wooledge <greg@wooledge.org> - 2021-06-19 15:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Curt <curty@free.fr> - 2021-06-19 17:50 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Dan Ritter <dsr@randomstring.org> - 2021-06-19 20:40 +0200
Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... Andrei POPESCU <andreimpopescu@gmail.com> - 2021-06-20 09:00 +0200
| From | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| Date | 2021-06-18 18:10 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <Crpe9-6ZR-3@gated-at.bofh.it> |
The subject line is being amended to add the word "Online " before "... Debian Man pages ..." for the thread at: https://lists.debian.org/debian-user/2021/06/msg00432.html, continued till https://lists.debian.org/debian-user/2021/06/msg00438.html, to further clarify confusion of rhkramer <r***@gmail.com>, who privately communicated, and for Jonathan Dowland <j***@debian.org>, who showed interest on the topic. I also hope that with this Email I shall also be able to address the confusions inadvertently caused to Mr. David Wright <de***@lio***.uk>,. The Drive Folder for a sample Man file and an attempt at pictorial analysis of a sample command: https://bit.ly/Apt_readingManPages An analysis of the Drive File : DebianApt-get.txt https://manpages.debian.org/buster/apt/apt-get.8.en.html apt-get [-asqdyfmubV] [-o=config_string] [-c=config_file] [-t=target_release] Please look at the parts: Let A = apt-get B = [-asqdyfmubV] C = [-o=config_string] D = [-c=config_file] E = [-t=target_release] An apt-get command is a Text String formed by one particular choice of all the options available, of each of A, B, C, D and E, with a space in between. Say, in abstraction, a Text-String formed by, say: Aₕ Bₖ Cₘ Dₙ Eₚ, where each of h,k,m,n and p is any one of all the options available for each of them individually. For example, one code-line could be A₁ B₂ C₅ D₆ E₁₂, as an illustration. I was just trying to say this illustratively for writers (without a general mathematical background) who would help edit the code lines, by the svg picture. No authorisation required. Please have all the files downloaded to your local HDD and then use EOG (or any other image viewer you are comfortable with) for viewing the images, and plain text reader like leafpad to read the text files. Ideally, if your browser if properly set up, you need not download. You could view/read files from your browser-tab itself. I use Mozilla Firefox. But for any Mozilla forked web-browser like Google Chrome or Chromium, operations are similar. A GUI user would usually click the link on the Email (Gmail) Tab. If settings are standard on the web-browser, the link shall open on a separate Tab. My proposal is, by a specific example, for the Debian Apt Man Online Page, Let M be The Debian Apt Man Online Webpage. i.e., M = https://manpages.debian.org/buster/apt/apt.8.en.html Then my proposal: M = M + Examples of all the representative combinations of code-lines related to Command, at the bottom, like my file (i have, for illustration, presented pictorially the scheme, whereas what's required are all example/representative code lines, into rows of code lines, with, if required, one line/phrase explanations) Pictorially illustrated on the Drive folder. Best, Rajib
[toc] | [next] | [standalone]
| From | Michael Grant <mgrant@grant.org> |
|---|---|
| Date | 2021-06-18 23:50 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <Cruxb-1A7-1@gated-at.bofh.it> |
| In reply to | #236196 |
[Multipart message — attachments visible in raw view] — view raw
On Fri, Jun 18, 2021 at 09:20:56PM +0530, Susmita/Rajib wrote: > The subject line is being amended to add the word "Online " before > "... Debian Man pages ..." for the thread at: > https://lists.debian.org/debian-user/2021/06/msg00432.html, continued > till https://lists.debian.org/debian-user/2021/06/msg00438.html, to > further clarify confusion of rhkramer <r***@gmail.com>, who privately > communicated, and for Jonathan Dowland <j***@debian.org>, who showed > interest on the topic. I also hope that with this Email I shall also > be able to address the confusions inadvertently caused to Mr. David > Wright <de***@lio***.uk>,. > > The Drive Folder for a sample Man file and an attempt at pictorial > analysis of a sample command: > https://bit.ly/Apt_readingManPages > > An analysis of the Drive File : DebianApt-get.txt > > https://manpages.debian.org/buster/apt/apt-get.8.en.html > > apt-get [-asqdyfmubV] [-o=config_string] [-c=config_file] [-t=target_release] > > Please look at the parts: > Let > A = apt-get > B = [-asqdyfmubV] > C = [-o=config_string] > D = [-c=config_file] > E = [-t=target_release] > > An apt-get command is a Text String formed by one particular choice of > all the options available, of each of A, B, C, D and E, with a space > in between. > > Say, in abstraction, a Text-String formed by, say: > Aₕ Bₖ Cₘ Dₙ Eₚ, where each of h,k,m,n and p is any one of all the > options available for each of them individually. > > For example, one code-line could be A₁ B₂ C₅ D₆ E₁₂, as an illustration. > > I was just trying to say this illustratively for writers (without a > general mathematical background) who would help edit the code lines, > by the svg picture. > > No authorisation required. Please have all the files downloaded to > your local HDD and then use EOG (or any other image viewer you are > comfortable with) for viewing the images, and plain text reader like > leafpad to read the text files. > > Ideally, if your browser if properly set up, you need not download. > You could view/read files from your browser-tab itself. > > I use Mozilla Firefox. But for any Mozilla forked web-browser like > Google Chrome or Chromium, operations are similar. > > A GUI user would usually click the link on the Email (Gmail) Tab. If > settings are standard on the web-browser, the link shall open on a > separate Tab. > > My proposal is, by a specific example, for the Debian Apt Man Online Page, > Let M be The Debian Apt Man Online Webpage. > i.e., M = https://manpages.debian.org/buster/apt/apt.8.en.html > > Then my proposal: > > M = M + Examples of all the representative combinations of code-lines > related to Command, at the bottom, like my file (i have, for > illustration, presented pictorially the scheme, whereas what's > required are all example/representative code lines, into rows of code > lines, with, if required, one line/phrase explanations) > > Pictorially illustrated on the Drive folder. > > Best, > Rajib > > I honestly couldn't decode this message but I have been following this thread. If I understand correctly what I think Rajib wants is: 1) when a package is added to debian's repo, some automation which looks at the package, determines if it has man pages, and for each of those man pages, create a corresponding wiki page in a debian owned man page wiki. 2) somehow automatically patch the man page to include a link to said wiki page. (note, this will be hard). Maybe some automation could be created to create these wiki pages. But I see problems. Packages change, become obsolete, sometimes get renamed. Even command names change over time. It's a little odd for Debian to host a documentation wiki for upstream tools. The package maintainers would need to look after the wiki page that corresponds to the package they are maintaining. Not everyone is going to be happy with more work. Even if they are not the ones writing it, they will need to be aware of it and if things change, tweak it. It seems like Rajib is looking for something at a higher level, not at the level of Debian, but at the level of Unix/Linux itself, as in, how to document things you've worked on in a standard way in a globally editable/extendable forum. Wikis tend to be GUI based and man pages are text files used generally at the command propt. The closest text based thing I can think of is the gnu info system which is/was meant for this sort of thing but is not very widely used. It predates markdown and wikis by many years. I'm all for better documentation but I don't see how Debian can be the documentation repository for all tools that just happen to be Debian packages. It feels like you should try to start a sort of "unixepedia" thing like wikipedia and then one by one try to get people to create pages for their tools. Then, eventually people will put links into their man pages pointing at this global resource. That's my best opinion after reading all your posts. Michael Grant
[toc] | [prev] | [next] | [standalone]
| From | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| Date | 2021-06-19 04:50 +0200 |
| Message-ID | <Crzdv-4p5-1@gated-at.bofh.it> |
| In reply to | #236197 |
On 19/06/2021, Michael Grant <mgrant@grant.org> wrote: [...] Thank you, Mr. Grant, for posting to my thread. The link to address your queries may please be referred to: https://lists.debian.org/debian-user/2021/06/msg00454.html, The Drive Folder for a sample Man file and an attempt at pictorial analysis along with visual explanations of a sample command: https://bit.ly/Apt_readingManPages I shall leapfrog. Mr. Grant says: > It's a little odd for Debian to host a documentation wiki for upstream > [...] > writing it, they will need to be aware of it and if things change, > tweak it. Aren't the ML members aware that Debian already has a Man Wiki pages repository? Debian Man Wiki Pages are available at: https://manpages.debian.org/ > Wikis tend to be GUI based and man pages are text files used generally > at the command propt ... Debian Wikis _are_ GUI. > I'm all for better documentation but I don't see how Debian can be the > documentation repository for all tools that just happen to be Debian > packages. Okay. This point could be discussed on a separate thread. I have a few questions: (1) Is uploading the Debian Man Wiki Pages at: https://manpages.debian.org/ automated? (2) Aren't the posters and senior members of the ML aware that Debian Man Wiki pages already exist? (3) Don't all the programmers spend at least some time on the internet? (4) Don't all the programmers spend at least some time on the Debian MLs or forums? 90% of the problem appears to have been solved here itself. Each programmer must be using some form of codes, and they are permanently etched on to their memory. (5) Can't one line of code example per day to a text file for One familiar Command each in the same Debian Wiki repository be possible? Now, if the offline Man Pages installed on a Debian System is uploaded on to the Debian Wiki by some automation, then patching M (man file) + C (Example code lines) to be a better M (Man page) shouldn't be much of an effort. Example: "AptDebianManpages.png" and "Modified_AptDebianManpages.png" at https://bit.ly/Apt_readingManPages If the above isn't automated, then patching M(man file) + C (Example code lines) to be a better M (Man page) would be a tiny effort per person and one Ctrl+C and Ctrl+V, and the effort is a tiny fraction of preparing the man pages. [...] > ... ... Not everyone is > going to be happy with more work. Even if they are not the ones > writing it, they will need to be aware of it and if things change, > tweak it. [...] Work averse? After so much of reading, writing codes? For one line of familiar code line per day for at most 10-12 days? Programmers having their creations on GitHub and willing to have them included in Debian Repo could be advised to write illustrative example code lines on the program's Man pages. [...] > It feels like you should try to start a sort of "unixepedia" thing > like wikipedia and then one by one try to get people to create pages > for their tools. Then, eventually people will put links into their > man pages pointing at this global resource. That's my best opinion > after reading all your posts. [...] I am not thinking along these lines presently. Best. Rajib
[toc] | [prev] | [next] | [standalone]
| From | Richard Hector <richard@walnut.gen.nz> |
|---|---|
| Date | 2021-06-19 09:00 +0200 |
| Message-ID | <CrD7r-6J4-5@gated-at.bofh.it> |
| In reply to | #236200 |
On 19/06/21 2:28 pm, Susmita/Rajib wrote: > Aren't the ML members aware that Debian already has a Man Wiki pages > repository? Debian Man Wiki Pages are available at: > https://manpages.debian.org/ I'm pretty sure that's not a wiki. It looks like a set of automatically generated static pages. Richard
[toc] | [prev] | [next] | [standalone]
| From | The Wanderer <wanderer@fastmail.fm> |
|---|---|
| Date | 2021-06-19 11:30 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrFsC-8dj-7@gated-at.bofh.it> |
| In reply to | #236201 |
[Multipart message — attachments visible in raw view] — view raw
On 2021-06-19 at 02:51, Richard Hector wrote: > On 19/06/21 2:28 pm, Susmita/Rajib wrote: > >> Aren't the ML members aware that Debian already has a Man Wiki >> pages repository? Debian Man Wiki Pages are available at: >> https://manpages.debian.org/ > > I'm pretty sure that's not a wiki. > > It looks like a set of automatically generated static pages. In particular, I suspect that it is automatically generated from the exact same data set as the man pages themselves (if not *from* the man pages themselves), and therefore will by definition have the exact same content as those man pages. Tweaks and adjustments, beyond the purely mechanical sort involved in converting the formatting to HTML etc., are almost certainly either A: not possible or B: excluded from the scope. -- The Wanderer The reasonable man adapts himself to the world; the unreasonable one persists in trying to adapt the world to himself. Therefore all progress depends on the unreasonable man. -- George Bernard Shaw
[toc] | [prev] | [next] | [standalone]
| From | Andrei POPESCU <andreimpopescu@gmail.com> |
|---|---|
| Date | 2021-06-20 08:50 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrZrj-4Jx-5@gated-at.bofh.it> |
| In reply to | #236203 |
[Multipart message — attachments visible in raw view] — view raw
On Sb, 19 iun 21, 05:23:04, The Wanderer wrote: > On 2021-06-19 at 02:51, Richard Hector wrote: > > > On 19/06/21 2:28 pm, Susmita/Rajib wrote: > > > >> Aren't the ML members aware that Debian already has a Man Wiki > >> pages repository? Debian Man Wiki Pages are available at: > >> https://manpages.debian.org/ > > > > I'm pretty sure that's not a wiki. > > > > It looks like a set of automatically generated static pages. > > In particular, I suspect that it is automatically generated from the > exact same data set as the man pages themselves (if not *from* the man > pages themselves), and therefore will by definition have the exact same > content as those man pages. This is correct as far as I know, by design, and it's been very useful to be able to the manpage from other online documentation (the wiki, Release Notes, etc.). > Tweaks and adjustments, beyond the purely > mechanical sort involved in converting the formatting to HTML etc., are > almost certainly either A: not possible or B: excluded from the scope. It surely would be possible to somehow attach a wiki-like editable part at the bottom. Whether that actually makes sense has already been addressed. Kind regards, Andrei -- http://wiki.debian.org/FAQsFromDebianUser
[toc] | [prev] | [next] | [standalone]
| From | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| Date | 2021-06-19 10:50 +0200 |
| Message-ID | <CrEPU-7Lq-5@gated-at.bofh.it> |
| In reply to | #236200 |
To: debian-user@lists.debian.org From: Richard Hector <richard@walnut.gen.nz> Date: Sat, 19 Jun 2021 18:51:04 +1200 [...] > I'm pretty sure that's not a wiki. > It looks like a set of automatically generated static pages. > Richard Okay, thank you Mr. Hector, for correcting my notion. The proposal remains the same with this correction. Best
[toc] | [prev] | [next] | [standalone]
| From | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| Date | 2021-06-20 07:40 +0200 |
| Message-ID | <CrYlA-48J-1@gated-at.bofh.it> |
| In reply to | #236202 |
The file: "ls_proposal_man_debian.html", in the Drive folder: https://bit.ly/Apt_readingManPages, contains the example on how I would have wanted all the man pages to be, for Newcomers to learn coding and systems handling with minimum / optimal help when in need. I desire that GNU FSF and Debian, as a part of Free and Open Source Software (when I joined in 2008), become beautiful, enriching and fulfilling to use. I find so much possibilities by the Free and Open Source Software by the Idea of GNU being Wasted! It appears to me that some groups have grabbed a HUGE control over free interactions and ideas getting generated and exchanged. Conspiracy Theory: ---------------------------- Strategy #1: As a jealous individual, trying to sell my broken ware, I don't need to do anything other than find out like-minded individuals/groups and hijack a thread with promise and continue posting mindless questions/comments, expecting that any ideator, trying to share meaningful ideas, shall become engaged with me, eventually get irritated, and ultimately leave. Strategy #2: I get paid by the Proprietary Universe just to disrupt ideas getting generated collectively, shared FREELY and getting improved, by strategy #1. ---------------------------------------------------------------------- Wind flows, clouds form, rain falls, day and night cycles. Universe carries on, with or without me. I am NOT the Controller of the Universe. I have been given Human Rights. As an extension, the Freedom to choose my friends circle. To decide whom to engage with. I also have the Freedom to Express to someone that I wouldn't like to engage with that one. The problem in a Mailing List is that anyone can post anything and quickly get things CLUTTERED. I am willing to be BARRED from posting on to a group that I have joined. But I shall reserve my rights to say to a person that I consider him my friend. I also shall reserve my rights to say to a person that I wouldn't like to engage with him. So ideally, I would have liked to have such rights here too. I shall still be successful separating the Chaff from the Grain. Best.
[toc] | [prev] | [next] | [standalone]
| From | "Susmita/Rajib" <bkpsusmitaa@gmail.com> |
|---|---|
| Date | 2021-06-21 08:50 +0200 |
| Message-ID | <CslUR-1lg-7@gated-at.bofh.it> |
| In reply to | #236215 |
From: Andrei POPESCU <andreimpopescu@gmail.com> To: debian-user@lists.debian.org Date: Sun, 20 Jun 2021 09:52:50 +0300 Message-id: <[🔎] 20210620065250.qdmrs6vgg3jnkx4g@acr13.nuvreauspam> In-reply-to: <YM0S0n9+Fdv/gZht@grant.org> References: <CAEG4cZXz4ws=HQbEmsqx3QgjguNmx99PcQwCGCZZHQMXJ9srJg@mail.gmail.com> <[🔎] CAEG4cZXE5g_nxaEZLLF7ecHPf+gL81n=6rCAZpy57UG3pA44yg@mail.gmail.com> <YM0S0n9+Fdv/gZht@grant.org> [...] > ... Agreed, except for the ... upstream maintainers > ... have enough work actually developing the > software ... certain the Arch wiki ... > (praised here again and again) is written by the users. > The Arch wiki is GFDL 1.3 (or later) ... be copied > ... (with appropriate attribution ... > license requires ... with small tweaks ... > remove the Arch-specific parts. One tiny alteration: it was learnt from Mr. Hektor that the debian Man Pages aren't wiki. The file: "ls_proposal_man_debian.html", in the Drive folder: https://bit.ly/Apt_readingManPages, contains the example on how I would have wanted all the man pages to be, for Newcomers to learn coding and systems handling with minimum / optimal help when in need. Uploaded on my Drive, as well as attached in my earlier post, that wasn't allowed. This post is to check if I am Blocked from the List. Best wishes. P.S.: Ref: https://lists.debian.org/debian-user/2021/06/msg00473.html
[toc] | [prev] | [next] | [standalone]
| From | Greg Wooledge <greg@wooledge.org> |
|---|---|
| Date | 2021-06-21 13:50 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CsqBb-476-1@gated-at.bofh.it> |
| In reply to | #236236 |
On Mon, Jun 21, 2021 at 11:57:13AM +0530, Susmita/Rajib wrote: > This post is to check if I am Blocked from the List. Nobody ever suggested "blocking" you. Who could even do that? You'd have to violate the list's policy in some egregious way, such as sending commercial spam, to get the attention of the list administrators. YOU, on the other hand, have accosted at least two people and asked them to stop posting in threads that you had started. At this point, if you expect anyone to engage with you, you need to stop repeating yourself and spewing invective. Instead, focus on the tasks that people have asked you to do. Show us an example of the work that you propose to do. Create a page on the Debian wiki containing additional EXAMPLES for some man page that you consider to be in need of this enhancement. This means you will need to work out how you plan to manage the page namespace. For example, are you going to differentiate between different releases (buster/ls.1 bullseye/ls.1 and so on)? How about alternative implementations of the same command across different packages within the same release? For example, consider: https://manpages.debian.org/buster/moreutils/parallel.1.en.html https://manpages.debian.org/buster/parallel/parallel.1.en.html Two implementations of the parallel(1) command, from two separate sources. Very different. How do you plan to handle this situation? Once you've written up new EXAMPLES for a few man pages to get the ball rolling, it's possible that you'll find other people interested enough to help you out. But until then, I doubt anyone's going to step up and do your work for you.
[toc] | [prev] | [next] | [standalone]
| From | Greg Wooledge <greg@wooledge.org> |
|---|---|
| Date | 2021-06-19 15:50 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrJwd-2ef-3@gated-at.bofh.it> |
| In reply to | #236200 |
On Sat, Jun 19, 2021 at 07:58:58AM +0530, Susmita/Rajib wrote: > The Drive Folder for a sample Man file and an attempt at pictorial > analysis along with visual explanations of a sample command: > https://bit.ly/Apt_readingManPages OK, I finally took the bait and clicked on this link. For informational purposes, in case anyone else was considering it: it redirects to a drive.google.com page, which contains 5 files. Four of them are PNG images, and one of them is ".txt" but it contains subscripted letters. (This also explains some confusion I had with the author's previous email in which they referred to letters "A B C D E, where each of h, k, m, n and p is..." with no antecedent for the h, k, m, n or p. It turns out the A B C D E were actually supposed to be A<sub>h</sub> and so on, but the subscripts were lost in conversion somewhere along the line.) None of the images make any sense to me, but perhaps they will make sense to someone else. Two of them are renderings of web pages, but they're so tall that they are displayed with extreme resizing in my browser, and since those two images are composed mostly of words on a white background, the reduction in the size of the image of the words makes them unreadable to me. Actual text (or HTML) would be far superior to an image of a rendered web page. Now, I will also note that this poster has sent me private email telling me in flowery language to shut up and stay out of their threads. Screw you. I will respond when I feel there's a reason to respond. I also mention this primarily for informational purposes, to let others on the list know what kind of personality they're dealing with. I have yet to see an actual example of the work you're proposing to do. Show us one man page that you feel is lacking in its EXAMPLES section, and then show us the wiki page (on https://wiki.debian.org / -- I mean actually *create* one and then post its URL on the mailing list) with your contribution that you believe would be worth referencing in the man page.
[toc] | [prev] | [next] | [standalone]
| From | Curt <curty@free.fr> |
|---|---|
| Date | 2021-06-19 17:50 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrLol-3oi-1@gated-at.bofh.it> |
| In reply to | #236204 |
On 2021-06-19, Greg Wooledge <greg@wooledge.org> wrote: > > Now, I will also note that this poster has sent me private email telling > me in flowery language to shut up and stay out of their threads. > Screw you. I will respond when I feel there's a reason to respond. > I also mention this primarily for informational purposes, to let others > on the list know what kind of personality they're dealing with. > Thanks illustrious team leader, but I long ago concluded this guy is a nutball (to put it in a nutshell, as it were, and without the delicate touch for which I am renown).
[toc] | [prev] | [next] | [standalone]
| From | Dan Ritter <dsr@randomstring.org> |
|---|---|
| Date | 2021-06-19 20:40 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrO2R-63w-1@gated-at.bofh.it> |
| In reply to | #236204 |
Greg Wooledge wrote: > Now, I will also note that this poster has sent me private email telling > me in flowery language to shut up and stay out of their threads. > Screw you. I will respond when I feel there's a reason to respond. > I also mention this primarily for informational purposes, to let others > on the list know what kind of personality they're dealing with. Same here, which is why I dropped them in my spam filter. Nevertheless, it's just them; I'm not locking myself out of whatever threads they happen to post in. -dsr-
[toc] | [prev] | [next] | [standalone]
| From | Andrei POPESCU <andreimpopescu@gmail.com> |
|---|---|
| Date | 2021-06-20 09:00 +0200 |
| Subject | Re: A Proposal: Each of Online Debian Man pages could have a wiki (Main page / Talk Page, etc.) at its bottom, with only Example Code Lines ... |
| Message-ID | <CrZAZ-4MM-3@gated-at.bofh.it> |
| In reply to | #236197 |
[Multipart message — attachments visible in raw view] — view raw
On Vi, 18 iun 21, 17:40:34, Michael Grant wrote: > > It's a little odd for Debian to host a documentation wiki for upstream > tools. The package maintainers would need to look after the wiki page > that corresponds to the package they are maintaining. Not everyone is > going to be happy with more work. Even if they are not the ones > writing it, they will need to be aware of it and if things change, > tweak it. Agreed. > It feels like you should try to start a sort of "unixepedia" thing > like wikipedia and then one by one try to get people to create pages > for their tools. Then, eventually people will put links into their > man pages pointing at this global resource. That's my best opinion > after reading all your posts. Agreed, except for the "get people to create pages for their tools". The upstream maintainers have enough work actually developing the software. I'm fairly certain the Arch wiki (praised here again and again) is written by the users. The Arch wiki is GFDL 1.3 (or later), so the initial content could just be copied from there (with appropriate attribution and whatever else the license requires, of course), with small tweaks to remove the Arch-specific parts. Kind regards, Andrei -- http://wiki.debian.org/FAQsFromDebianUser
[toc] | [prev] | [standalone]
Back to top | Article view | linux.debian.user
csiph-web