groff
[Top][All Lists]
Advanced

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

Re: Some comments on the documentation (here: groff manual)


From: Oliver Corff
Subject: Re: Some comments on the documentation (here: groff manual)
Date: Sun, 28 May 2023 12:08:36 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.10.0

Hi Branden,

that's great! I immediately spotted the little magic keyword "infix" in
the third paragraph on p. 79, and full-fledged examples on p. 81.
Question answered!

And my second question gets answeres on pp. 165 and following.

Thank you very much,

Enjoy the weekend,

Oliver.


On 28/05/2023 11:50, G. Branden Robinson wrote:
Hi Oliver,

At 2023-05-28T11:34:27+0200, Oliver Corff wrote:
as I am trying to learn more of the groff language, not so much for
modifying existing layouts or creating layout macros, but rather for
the purpose of computing contents like character tables etc., I came
across two issues in the groff manual (at least in the version which
is currently available as:
https://www.gnu.org/software/groff/manual/groff.html)
Unfortunately that version of groff's Texinfo manual corresponds to the
most recent groff release, which is sadly 4½ years old: groff 1.22.4 of
December 2018.

There have been some changes to it since then:

$ COLUMNS=72 git diff --stat 1.22.4 doc/groff.texi
warning: refname '1.22.4' is ambiguous.
  doc/groff.texi | 20342 +++++++++++++++++++++++++----------------------
  1 file changed, 11020 insertions(+), 9322 deletions(-)

Bertrand and I trying to get 1.23.0 finalized, but his availability is
pretty limited.  When it _does_ release, the copy of the manual at the
GNU website will be updated.

In the meantime, I recommend checking out my Dropbox account for much
more up to date copies.  At present there is a folder for 1.23.0.rc4,
but in the parent is even more up-to-date documentation generated from
groff Git HEAD.

https://www.dropbox.com/sh/17ftu3z31couf07/AAC_9kq0ZA-Ra2ZhmZFWlLuva?dl=0

I think the current state of the manual is responsive to your questions;
please check out the sections "Numeric Expressions" (pp. 79-82) and
"Conditional Blocks" (pp. 165-167).

Please advise me if the material seems incomplete, misleading, or
unclear to you.

Regards,
Branden
--

[2018] Sicherheit und Verteidigung Japans im Wandel

[2019] Eckpunkte der Sicherheits- und Verteidigungspolitik Japans:
https://www.baks.bund.de/sites/baks010/files/arbeitspapier_sicherheitspolitik_2019_15.pdf

Dr. Oliver Corff
Wittelsbacherstr. 5A
10707 Berlin
G E R M A N Y
Tel.: +49-30-85727260
Mail:oliver.corff@email.de


reply via email to

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