groff
[Top][All Lists]
Advanced

[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



reply via email to

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