man: move from xmltoman to rst2man
xmltoman looks dead and uses XML as well as pulls in a long list of Perl dependencies. This replaces it with rst2man that has almost no dependencies beyond Python, which is already required for the Meson build system.
Naturally rst2man uses reStructuredText and the pages were rewritten via regex and manual editing to be as close to original XML format as possible. A few fixes and updates were done too. Most notably a note was added to indicate that production deployments should not be starting the session manager via pipewire.conf file.
There's three slight formatting issues/differences:
- rst2man produces simpler footer.
- "-f | --foo=value" confuses the parser and it fails to correctly add argument specific syntax highlighting to assignment value.
- XML version had inconsistent use of
<arg>and<opt>which has been partially addressed. But various manual pages still have their differences to what and how is highlighted.
Additionally I threw in a second commit which updates two remaining HTTP links to pipewire.org to HTTPS.
Closes: #1564 (closed)
Edited by Niklāvs Koļesņikovs