On Tue, Nov 12, 2002 at 05:33:06PM +0000, Colin Watson wrote: > The reason why I'm supporting this proposal is because I find the > symlinks to undocumented(7) technically less than ideal in a number of > ways. [...] > Indeed it is useful to have better-than-nothing documentation for > newbies, so let's arrange for the pointer to be kept in a central place, > something like: > > No manual entry for foo. Either you mistyped, or there is no > documentation for this feature: try 'man 7 undocumented'.
That would be good, yes. I'd trade the technical deficiencies for a helped newbie any day, but if we can avoid the former, even better :) > > > + It is not very hard to write a man page. See the <url > > > + id="http://www.schweikhardt.net/man_page_howto.html"; > > > + name="Man-Page-HOWTO">, <tt>man(7)</tt>, the examples > > > + created by <tt>debmake</tt> or <tt>dh_make</tt>, or the > > > + directory <file>/usr/share/doc/man-db/examples</file>. > > > > Oh, and that should be <manref name="man" section="7">. > > Again, I'm happy to leave it to a policy editor to fix the markup if > desired. Another reason why requiring SGML patches instead of pure content is wrong... -- 2. That which causes joy or happiness.
