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@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
