Re: "Writing my PhD using groff"

[DJ Chase]

On Sun Jul 24, 2022 at 12:11 PM EDT, G. Branden Robinson wrote:
> 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.

> https://www.dropbox.com/sh/17ftu3z31couf07/AAC_9kq0ZA-Ra2ZhmZFWlLuva?dl=0
>
> 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".

I’ve read ms.2022-07-24.pdf — I loved it! The examples and descriptions
are so clear and concise.

My only critique is that you may want to embed the fonts when distribu-
ting to prevent missing character issues.

Cheers,
-- 
DJ Chase
They, Them, Theirs