[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Bug 57416: repair .AT and .UC in the groff_man(7) macros
From: |
Bjarni Ingi Gislason |
Subject: |
Bug 57416: repair .AT and .UC in the groff_man(7) macros |
Date: |
Tue, 17 Dec 2019 02:21:06 +0000 |
User-agent: |
Mutt/1.5.20 (2009-12-10) |
Web: savannah.gnu.org/bugs/?group=groff
I miss comments, so that the patch (the new part) alone will be easy
to understand.
1) what is it doing (on the meta plain)
2) why is it here in the code and not some other place
3) why is it doing it (the reason)
4) ?
Possible comments:
1. part
Give the page header a sensible text
before the first (next) page break,
so its text will appear on the first (next) page.
2. part
Give the page footer its text after the (first) page break,
so it will _not_ appear on the first (previous) page.
3. part
(Add an explanation about the macro "an-header".)
N.B.
The reader of a patch should not have to know in advance,
what the variables mean.
Patches are an ideal opportunity to add explanations to any piece of
code (that appears in the patch).
--
Bjarni I. Gislason
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Bug 57416: repair .AT and .UC in the groff_man(7) macros,
Bjarni Ingi Gislason <=