Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks
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.
Reply to: