-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 On Wed, Dec 21, 2016 at 12:25:59AM -0800, Andrew David Wong wrote: > On 2016-12-20 13:51, Marek Marczykowski-Górecki wrote: > > On Tue, Dec 20, 2016 at 04:04:20PM -0500, Nicklaus McClendon wrote: > >> Currently, there are multiple ways manpages are generated and handled > >> for Qubes tooling, listed below are repositories that likely should > >> have manpages (primarily command line tools)
(snip) > >> qubes-core-admin: pandoc (rst) and separate docs package, in doc > >> folder in repo (snip) > >> I propose that each package have a separate docs package, generated from > >> pandoc, with the source having restructured text in the doc folder in > >> each repo. > > > > I think separate doc package for man pages was a mistake. But other than > > that I agree. core-admin core3 generates manpages from RST using sphinx. This will remain that way, since it makes easier to post them also in HTML using readthedocs.io: https://qubes-core-admin.readthedocs.io/en/latest/manpages/index.html Sphinx is however specific to python. One obviously can write manpages for other tools using sphinx and rst, but there is no obvious benefit aside from nice sphinx extensions to RST. > Tracking: > > https://github.com/QubesOS/qubes-issues/issues/2528 Should I also post a comment to this bug? - -- pozdrawiam / best regards _.-._ Wojtek Porczyk .-^' '^-. Invisible Things Lab |'-.-^-.-'| | | | | I do not fear computers, | '-.-' | I fear lack of them. '-._ : ,-' -- Isaac Asimov `^-^-_> -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJYWoY0AAoJEL9r2TIQOiNRMeoP/AkNUkYTEUXFsZErXtqhAabB 5Y8QIgHb2MJMlZXhHN7XEoQcBAh9j12Co1fkwZPHaaYw66+NPlZPUthZpgd5XgJq Rsk7RZNpuDPNK5YxCgAX7FDOOEkAJdeDssOh6jOCD7fUGqIYQsOI/fQw9AG8a2IY Strk7DLWmOD57Zisw/lu3jCj6D8Vpz3KV+loQFrSG1BS4a09I8U1bzhbzwMhjfgH 2qBAmadNd4d2pIjPGbDBIEPVH0bYtpOQoAFQigQhzqfEdIlU6HdGUGOQ7wZF42w1 e9m885XA/mlkqc6Z145SrmJYfYc9/Ds9pA4EVVrZp4tXqlxtvgJ3TRoX5sxJNpLj 7oQjtL5z4cJGSqn7gylpi9I/DNirwR5wUImeaSXSYaJxMR9E7XOAYg9ZY4ZMsspz 3BTN8Foo/WzccQwpurVTUNzKWkiZlmO0xsCZ1bL9jtHBpOC6LaGu0TzwOZhqI77V HcNxZzVuo92KwbmQti035Njzo1wlqqBDxDpnFq/d8LamOnnGoJIJG2UeXDWKITAI taeWfjOa3d+i99Ak3hk1H9SqnfWvkvEzGRd3g930KvGwNTW/yvrkh1iINwZCdi+Y kmr0CZdUTc8Gp9CiQljxnnmjnR9vJcFP1cTzbYeGFiy56jahJLe4bDafKuZ+SkrO c1qzoPb2/c/i+VMiGHfP =6pys -----END PGP SIGNATURE----- -- You received this message because you are subscribed to the Google Groups "qubes-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to qubes-devel+unsubscr...@googlegroups.com. To post to this group, send email to qubes-devel@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/qubes-devel/20161221134006.GI1114%40invisiblethingslab.com. For more options, visit https://groups.google.com/d/optout.