[Top][All Lists]

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

Re: "Writing my PhD using groff"

From: G. Branden Robinson
Subject: Re: "Writing my PhD using groff"
Date: Sun, 24 Jul 2022 11:11:10 -0500

At 2022-07-24T15:45:46+0000, DJ Chase wrote:
> On Sun Jul 24, 2022 at 8:06 AM EDT, G. Branden Robinson wrote:
> > At 2022-07-24T03:17:44+0000, DJ Chase wrote:
> > > I’ve never read the Texinfo manual; I learned *roff through Unix
> > > For People,[1] then various online materials maybe half a year
> > > ago. The turn-off for me was how cryptic all of the troff examples
> > > (from any source) I saw were, and how it felt like I was always
> > > fighting the typesetter to get it to do even basic things.
> >
> > As someone who's done a lot of work on the Texinfo manual (and other
> > groff documentation) over the past 5 years, that is disappointing to
> > hear.
> I just read some of it. I wish I read it when it felt like I was
> fighting with the typesetter — it’s very helpful.

I should correct myself.  I've only been hacking on our Texinfo manual
for about 4 years, so if you're looking at the one from groff 1.22.4, I
deserve no credit for any helpful material you find there.  (There was
already an immense amount!)

> It seems that the document you attached is your GPG key in PDF form.
> Could you try resending it, or if the issue is appears to be on my end,
> sending a link to it?

I believe there were _two_ attachments to the mail, or should have been,
but no matter.  How about I make life easier for everyone?

The above link goes to a folder where you can find the 9 PDF files I
regenerate frequently as part of my development work on groff.  Save
anything you're interested in immediately; I have to replace the files
often to keep myself under the storage limit.  (Nothing there is
truly precious; the groff Git repository houses the source forms.  The
documents are generated from my personal working tree which differs
little if at all, depending on what I'm hacking on.  I push regularly.)

Apropos of our conversation, I recommend the 'ms.2022-07-24.pdf'
document, and 'groff.2022-07-24.pdf', specifically the beginning of
chapter 5, "gtroff Reference".

The other 7 files of course may also be of interest.  (Warning: perusal
of the ChangeLog document may require consumption of illegal stimulants
to maintain wakefulness.)

> Good luck; It’s out of print and physical copies are very hard to
> come by.

That's a shame.  Guess I should move it up the priority queue and read
the IA version while I can, and take external notes.


Attachment: signature.asc
Description: PGP signature

reply via email to

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