Hello alls, I'm a neatroff user, and feels, as a result, compelled to give my opinion. I'll second everyone stating that "Nroff/Troff User Manual" (CSTR 54) is the manual of choice. It's 37 pages of well written documentation, and should cover all your needs: https://www.troff.org/54.pdf
Then, you'll need to know what are the differences between the old troff and neatroff: http://litcave.rudi.ir/neatroff.pdf http://litcave.rudi.ir/neatstart.pdf If you use preprocessors (refer, pic, tbl...), you'll have to read their documentation separately. Then, if you want to write your own macros, you'll probably want to begin by adapting one of them, and get used with its internals. Maybe ms is a good candidate, as it's quite short, and yet used that way by Ali Gholami Rudi for neatroff, with: https://github.com/aligrudi/neatroff_make/tree/master/demo and https://github.com/aligrudi/neatroff_ths To fetch for ideas on how to do this or that, maybe can I also point to my macros, as they'll work with neatroff too, and implement a lot of things: https://github.com/pjfichet/utmac/ I figured that despite appearing unreadable at first glance, the troff formatting language is easy. I quickly could have my first working layout. Then comes the harder part of the work when complexity increases the risk of glitches, and glitches become harder to track and fix. But in the end, the journey is worth the effort, imho. Hoping that helps! Pierre-Jean.
