59 | | Agenda TBD |
| 59 | * man page |
| 60 | * Currently formatted in groff (nroff supported too?), which is a cumbersome format for humans to edit. |
| 61 | * OpenVPN 3 Linux decided to use [http://docutils.sourceforge.net/docs/user/rst/quickstart.html rst2man] which converts [https://github.com/OpenVPN/openvpn3-linux/tree/master/docs/man/ .rst files] to man pages with quite good results. It can also produce other formats as well, such as html, xml, latex, odt. |
| 62 | * Downside: rst2man is a Python utility |
| 63 | * Upside: Much easier to write man pages where even the [https://raw.githubusercontent.com/OpenVPN/openvpn3-linux/master/docs/man/openvpn2.1.rst source file is readable]. |
| 64 | * There might be other tools similar to rst2man, which does not require Python. |
| 65 | * (...more.topics...) |