who maintains the man pages?
in [General Linux]
|
From: Todd on 15 Mar 2010 00:02 Hi All, Who maintains the "man" pages? The author of the program or somewhere/someone else? -T
From: unruh on 15 Mar 2010 01:06 On 2010-03-15, Todd <todd(a)invalid.com> wrote: > Hi All, > > Who maintains the "man" pages? The author of > the program or somewhere/someone else? Did no one notify you? You do. Seriously, Linux is a community project, and various features are done by various people, volunteers. If there is some program you feel close to, start writing. > > -T
From: Sidney Lambe on 15 Mar 2010 01:36 On comp.os.linux.misc, Todd <todd(a)invalid.com> wrote: > Hi All, > > Who maintains the "man" pages? The author of > the program or somewhere/someone else? > > -T It's usually the author(s). That's why they come with the source code. You'll notice that "Unruh" didn't include any links that would allow you to join his mythical teams of volunteer manpage writers. :-) I wouldn't trust manpages from any other other source. I've gotten into trouble with some man pages obtained from web man- page archives. I think it's because a lot of them are way out of date but also suspect that some of them are written by people who don't know what they are doing. If you knew the app/utility, etc., really well and want to see your helpful improvements to the manpage published, then I'd advise you to format your improved manpage properly using nroff or troff and email it to the maintainers of the software. If they like it, it will show up in their source code packages and maybe on their websites. Sid
From: Sidney Lambe on 15 Mar 2010 01:48 On comp.os.linux.misc, Sidney Lambe <sidneylambe(a)nospam.invalid> wrote: > On comp.os.linux.misc, Todd <todd(a)invalid.com> wrote: >> Hi All, >> >> Who maintains the "man" pages? The author of >> the program or somewhere/someone else? >> >> -T > > It's usually the author(s). That's why they come with the source > code. > > You'll notice that "Unruh" didn't include any links that would > allow you to join his mythical teams of volunteer manpage > writers. :-) > > I wouldn't trust manpages from any other other source. I've > gotten into trouble with some man pages obtained from web man- > page archives. I think it's because a lot of them are way out of > date but also suspect that some of them are written by people who > don't know what they are doing. > > If you knew the app/utility, etc., really well and want to see > your helpful improvements to the manpage published, then I'd > advise you to format your improved manpage properly using nroff > or troff and email it to the maintainers of the software. > > If they like it, it will show up in their source code packages > and maybe on their websites. > > Sid > > And for GNU's sake include lots of usage examples! Sid
From: Lew Pitcher on 15 Mar 2010 11:52
On March 15, 2010 00:02, in comp.os.linux.misc, todd(a)invalid.com wrote: > Hi All, > > Who maintains the "man" pages? The author of > the program or somewhere/someone else? It depends. Primarily, the software author maintains the manpage for his/her own software. But, there are a number of manpages that are maintained by 3rd-parties, including both the Free Software Foundation (the GNU people), and The Open Group (the owners of the Unix trademark, and the authors of the POSIX/Single Unix Specification standard for Unix-like systems). Manual pages have standard headings, including an AUTHORS heading. You should be able to find who maintains a specific manpage from there. If you have software that lacks a manpage, then please contact the author or publisher of that software, and request that they create the appropriate documentation in manpage form. -- Lew Pitcher Master Codewright & JOAT-in-training | Registered Linux User #112576 Me: http://pitcher.digitalfreehold.ca/ | Just Linux: http://justlinux.ca/ ---------- Slackware - Because I know what I'm doing. ------ |