Re: ls 6.7 man page bugs (unterminated bold macros)

[amores perros]

> From: Eric Blake
> Subject: Re: ls 6.7 man page bugs (unterminated bold macros)
> Date: Sun, 15 Apr 2007 15:00:33 -0600
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> According to amores perros on 4/15/2007 1:04 PM:
> > ls 6.7
> > In the man page, the options are in bold, and the explanations are not,
> > except
>
> Thanks for the report.  However, the man page is generated using the
> 'help2man' tool from the 'ls --help' output, so you may want to
> investigate whether these are bugs in that tool, rather than in ls.

If you're inviting me to take ownership of the bug, I'm afraid I must
decline. I did try to look at the current coreutils source, as I mentioned,
but the cvs viewer wasn't working -- and even if it was, I wouldn't have
the autotools skill to be a package maintainer of something like that.

So, if the implicit message here is that the bug isn't going anywhere
unless I pursue it, then go ahead and drop it -- that's fine.


> > --------------
> >
> > I was figuring out how to write a man page,
> > and looked at the ls one for reference, and
> > noticed these.
>
> Manually writing man pages tends to be a pretty harsh way to do things.
> Man pages are relatively obsolete, and not required by the GNU Coding
> Standards.  These days, it is easier to generate a man page using an
> automated tool that parses input from another format.

I am not writing them due to standards, but due to user requests,
actually -- users are more fun to please than standards :)

Anyway, no problem.

_________________________________________________________________
Can’t afford to quit your job? – Earn your AS, BS, or MS degree online in 1 
year. 
http://www.classesusa.com/clickcount.cfm?id=866145&goto=http%3A%2F%2Fwww.classesusa.com%2Ffeaturedschools%2Fonlinedegreesmp%2Fform-dyn1.html%3Fsplovr%3D866143