[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks



On Tue, Nov 12, 2002 at 06:52:28PM +0100, Josip Rodin wrote:
> > > > +	      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...

I don't think SGML patches are required anywhere. I also tried
creating one once, and it's not worth the trouble, especially if your
editor is not setup to grok SGML and how to break lines correctly. Can
we make a recommendation somewhere visible that people modify and diff
against policy.txt.gz instead?

-- 
  .''`.  ** Debian GNU/Linux ** | Andrew Suffield
 : :' :  http://www.debian.org/ | Dept. of Computing,
 `. `'                          | Imperial College,
   `-             -><-          | London, UK



Reply to: