[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Groff] Re: Simplifying groff documentation
From: |
Eric S. Raymond |
Subject: |
Re: [Groff] Re: Simplifying groff documentation |
Date: |
Wed, 27 Dec 2006 06:42:10 -0500 |
User-agent: |
Mutt/1.4.2.2i |
Werner LEMBERG <address@hidden>:
>
> > I could also have it emit a FIXME warning that hand polishing might
> > be needed here. I try to avoid those without a really good reason,
> > though. Presently I think there's only one, attached to a truly
> > wacky edge case in processing of list markup.
>
> Is it possible to have a `verbose' mode of doclifter which suggests
> improvements to the man page, or rather, which tells the user that
> handling of some snippets is probably flawed?
Certainly.
I think I may be able to avoid this, though. I had an idea yesterday
about how to handle .ti in the general case; I'm following it up now.
FYI, I found that only 78 of 13,466 (0.03%) pages contain .ti. That's
a low enough hit rate that I won't feel bad if we have to punt this case
with a warning.
--
<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>
- Re: [Groff] Re: Simplifying groff documentation, (continued)
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/25
- Re: [Groff] Re: Simplifying groff documentation, Gunnar Ritter, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Gunnar Ritter, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Gunnar Ritter, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Larry Kollar, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/26
- Re: [Groff] Re: Simplifying groff documentation, Werner LEMBERG, 2006/12/27
- Re: [Groff] Re: Simplifying groff documentation,
Eric S. Raymond <=