Hi, Martijn van Duren wrote on Wed, Nov 06, 2019 at 06:40:51AM +0100: > On 11/6/19 12:07 AM, Steve Litt wrote: >> On Tue, 5 Nov 2019 23:12:52 +0100
>>> https://www.openbsd.org/papers/bsdcan18-mandoc.pdf >> If the preceding presentation was authored in mdoc(7), could you please >> post the mdoc code that created it, and the mandoc(1) command and any >> filter programs that caused it to be a presentation instead of a man >> page? > You mean this one? > https://www.openbsd.org/papers/bsdcan18-mandoc.roff Exactly. Note that it does not use mdoc(7), though, but textproc/gpresent (groff_present(7)) on top of groff_mm(1) and roff(7). The mdoc(7) macro set has a very narrow scope: documentation. It isn't adequate for anything else, in particular neither presentations nor books nor even short journal articles. On the other hand, roff(7) can be used for any kind of typesetting, usually with one of the other macro sets. The most modern and most actively maintained of the general purpose macro sets is Peter Schaffter's groff_mom(7). Also note that i did not say pandoc is useless; all i intended to say is that if you need to write documentation, *that* is not a good reason to look at pandoc - merely because somebody on this list recommended pandoc specifically for writing documentation, which seems very misleading to me. > There are more examples at: > https://www.openbsd.org/events.html True. When it comes to gpresent, examples are arguably easier to find in this shorter list: http://mandoc.bsd.lv/press.html Yours, Ingo
