Theo Buehler writes: >> Are there any guidelines anywhere on what we are going for in a man >> page? If not is there a page which is very good and can be held up as a >> standard? > > Ingo's EuroBSDCon 2014 tutorial slides might be a good place to start: > > https://www.openbsd.org/papers/eurobsdcon2014-mandoc-slides.pdf > > It should contain all the important pointers and while mandoc has > evolved since then, I think it shouldn't be too outdated. > > One of my favorite pages is the (relatively) new sh(1) manual, but > usually things aren't that complex :)
Both those links are useful, thanks.