Re: undocumented man pages

["Stéphane Aulery" <saulery-GANU6spQydw@public.gmane.org>]

Hello Michael,

Le dimanche 08 mars 2015 à 09:08:09, Michael Kerrisk (man-pages) a écrit :
> 
> On 03/07/2015 03:57 PM, Stéphane Aulery wrote:
> > 
> > What do you think about to add a "undocumented" page for each section (as
> > undocumented.3) and create each missing pages with a reference to the
> > appropriate "undocumented" page. Thus we can also encourage users to become
> > contributors and avoid unnecessary reports.
> 
> My problem with this idea is that my simple test when wondering if
> a man page exists for an API is to look in the appropriate man?/ 
> directory for a file with the right name. With the scheme above, I then
> need to look inside the file to see if it is a link to undocumented.x.
> That would be a small inconvenience.

How is obtained the list of missing pages? Another solution would be to
provide a script that generates the missing pages with the redirection.

> Yes, the reports about missing pages are a minor irritation, but I'm
> a little doubtful that such an "undocumented" page would encourage much
> contribution. (I could be wrong, that's just my guess.)

I too could be wrong. I'm probably too optimistic. I feel that if the
user sees clearly that the page is not yet written and needs of its
contribution, it is better information for him and a better chance for
us.

PS: Thank you for patches, you are very responsive !

Cheers,

-- 
Stéphane Aulery
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html