Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.user > #236196 > unrolled thread

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 ...

Started by"Susmita/Rajib" <bkpsusmitaa@gmail.com>
First post2021-06-18 18:10 +0200
Last post2021-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.


Contents

  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

#236196 — 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 ...

From"Susmita/Rajib" <bkpsusmitaa@gmail.com>
Date2021-06-18 18:10 +0200
SubjectRe: 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]


#236197 — 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 ...

FromMichael Grant <mgrant@grant.org>
Date2021-06-18 23:50 +0200
SubjectRe: 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]


#236200

From"Susmita/Rajib" <bkpsusmitaa@gmail.com>
Date2021-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]


#236201

FromRichard Hector <richard@walnut.gen.nz>
Date2021-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]


#236203 — 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 ...

FromThe Wanderer <wanderer@fastmail.fm>
Date2021-06-19 11:30 +0200
SubjectRe: 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]


#236216 — 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 ...

FromAndrei POPESCU <andreimpopescu@gmail.com>
Date2021-06-20 08:50 +0200
SubjectRe: 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]


#236202

From"Susmita/Rajib" <bkpsusmitaa@gmail.com>
Date2021-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]


#236215

From"Susmita/Rajib" <bkpsusmitaa@gmail.com>
Date2021-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]


#236236

From"Susmita/Rajib" <bkpsusmitaa@gmail.com>
Date2021-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]


#236238 — 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 ...

FromGreg Wooledge <greg@wooledge.org>
Date2021-06-21 13:50 +0200
SubjectRe: 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]


#236204 — 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 ...

FromGreg Wooledge <greg@wooledge.org>
Date2021-06-19 15:50 +0200
SubjectRe: 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]


#236206 — 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 ...

FromCurt <curty@free.fr>
Date2021-06-19 17:50 +0200
SubjectRe: 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]


#236212 — 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 ...

FromDan Ritter <dsr@randomstring.org>
Date2021-06-19 20:40 +0200
SubjectRe: 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]


#236217 — 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 ...

FromAndrei POPESCU <andreimpopescu@gmail.com>
Date2021-06-20 09:00 +0200
SubjectRe: 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