[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [groff] groff as the basis for comprehensive documentation?
From: |
Ralph Corderoy |
Subject: |
Re: [groff] groff as the basis for comprehensive documentation? |
Date: |
Wed, 25 Apr 2018 17:00:01 +0100 |
Hi Ingo,
> I work on mdoc(7) manual pages a lot, and i almost never look at any
> kind of output to see whether the final formatting comes out in the
> desired visual form. While writing, i exclusively think about the
> logical structure of the text and the semantic function of each word
> and symbol. (I do periodically check the rendered console output,
> though - but only because finding typos is easier in the rendered form
> than in the source code.) I certainly never look at HTML or
> PDF/PostScript output to see whether it comes out right. I just
> *know* it will - or if it won't then that's a bug in the formatter
> which i have to fix.
Don't you ever forget to `\&' after a `.' that's not the end of
sentence, for example, and not notice because it fortunately falls where
it doesn't matter on the TTY but stands out when viewed in a
higher-resolution format? I find looking at the PostScript/PDF valuable
precisely because it's a different rendering and thus shows problems
hidden by the rendering used when writing.
--
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy
- Re: [groff] groff as the basis for comprehensive documentation?, (continued)
- Re: [groff] groff as the basis for comprehensive documentation?, Nate Bargmann, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, John Gardner, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, Ralph Corderoy, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, John Gardner, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, John Gardner, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, Ralph Corderoy, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, Nate Bargmann, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, James K. Lowden, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, G. Branden Robinson, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, Ingo Schwarze, 2018/04/22
- Re: [groff] groff as the basis for comprehensive documentation?,
Ralph Corderoy <=
- Re: [groff] groff as the basis for comprehensive documentation?, Steve Izma, 2018/04/25
- Re: [groff] groff as the basis for comprehensive documentation?, Mike Bianchi, 2018/04/25
- Re: [groff] groff as the basis for comprehensive documentation?, Ralph Corderoy, 2018/04/25
- Re: [groff] groff as the basis for comprehensive documentation?, Steve Izma, 2018/04/25
- Re: [groff] groff as the basis for comprehensive documentation?, Ralph Corderoy, 2018/04/26
- Re: [groff] groff as the basis for comprehensive documentation?, Ingo Schwarze, 2018/04/25
- Re: [groff] groff as the basis for comprehensive documentation?, Larry Kollar, 2018/04/21
- Re: [groff] groff as the basis for comprehensive documentation?, Ingo Schwarze, 2018/04/22
- Re: [groff] groff as the basis for comprehensive documentation?, Ingo Schwarze, 2018/04/22
- Re: [groff] groff as the basis for comprehensive documentation?, Keith Marshall, 2018/04/20