From: ldo@nz.invalid   
      
   On Sat, 3 Jan 2026 09:59:25 +0100, highcrew wrote:   
      
   > On the same topic, I find basic roff a little rough, so I evaluated   
   > a few options over time.   
   >   
   > My personal rank:   
   > 1. openbsd's "mdoc"   
   > 2. perl POD -> pod2man   
   > 3. asciidoc (hint: this is how git manpages are built)   
      
   Interesting, no mention of tex/latex. ;)   
      
   I did try that once or twice, got a whole lot of warnings (and no   
   usable output as I recall), couldn’t easily figure out what was wrong,   
   gave up, went back to Markdown.   
      
   Man pages with groff, on the other hand, have been relatively painless   
   to write. I can get output that looks just like other people’s man   
   pages. And I have the option for nicely-typeset output (e.g. PDF) from   
   the same source, which is even nicer.   
      
   (In fairness, I do use Mathjax in Jupyter notebooks. This is just the   
   maths-notation subset of latex, which gives me reasonable results with   
   minimal work.)   
      
   --- SoupGate-Win32 v1.05   
    * Origin: you cannot sedate... all the things you hate (1:229/2)