[Top][All Lists]

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

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

From: amores perros
Subject: Re: ls 6.7 man page bugs (unterminated bold macros)
Date: Sun, 15 Apr 2007 22:15:57 +0000

From: Eric Blake
Subject: Re: ls 6.7 man page bugs (unterminated bold macros)
Date: Sun, 15 Apr 2007 15:00:33 -0600

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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]