1. 12
  1.  

  2. 3

    Documentation for the syntax is at http://mandoc.bsd.lv/man/mdoc.7.html.

    1. 2

      https://manpages.bsd.lv/ is also a good resource if one has never written [gt]roff and/or manpages before.

      1. 1

        Oof, that looks like a much better resource. The syntax still needs some getting used to, but being shown the benefits of semantic markup (i.e. how does the PDF conversion look? Does it work well?) might persuade me to write some mandoc.

        1. 1

          The syntax still needs some getting used to

          It becomes fairly pleasant. I’ve converted a few pages from man to mdoc for the suckless project (although my patches haven’t been accepted) and all you really need is the manpage you linked as a reference. I’ve also written a few myself, and once you understand the boilerplate + semantic, the rest is easy.

          how does the PDF conversion look? Does it work well?

          It’s really easy: running

          $ mandoc -Tpdf ed.1 > ed.pdf
          

          on ed.1 results in this file. Nothing too special imo.

    2. 1

      Is there a better tag to use for documentation and/or markup languages?