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
