After seeing mandoc mentioned in the past, I thought I would look into writing a man page for the Oil shell (http://www.oilshell.org/). I've never written a man page before but thought I'd try to use some decent tools to start with.

I'm a little confused about distribution/workflow for distributing man pages (in general). If osh.1 is an mdoc flavored file, would that be used (with mandoc -T man) to output a man page that could then be setup when Osh is installed? Then how do you distinguish those? Oil uses autoconf for some things, would that get tied into generating/installing the man pages on the manpath?

Sorry if these are dumb questions, but I'm not even sure what kind of documentation I need to look through yet.

Thanks,

Matt