-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 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)
qubes-app-linux-img-converter: native in same package, in root of repository qubes-app-linux-pdf-converter: none qubes-app-linux-split-gpg: none qubes-core-admin: pandoc (rst) and separate docs package, in doc folder in repo qubes-core-admin-linux: pandoc (rst) in same package, in doc folder in repo qubes-core-qubesdb: none qubes-mgmt-salt: none Standardizing manpages and how they should be generated would allow new users to more easily contribute, new packages to be more easily on-boarded, and new distros to more easily package Qubes tools. 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. As somewhat an aside, it might also be worth adding a README to each repo with a brief explanation of what the repository is for, again to easy the process of on-boarding new user. kulinacs <nickl...@kulinacs.com> -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEPL+ie5e8l/3OecVUuXLc0JPgMlYFAlhZnMMACgkQuXLc0JPg MlYUlA/9Fmm3lifJb/ZjgS7IrMP07BmxifDq7uzqgDiyCQnNj8x7IwDM4jsDJhrQ yhWeGgCZ2YPMD6qDjmnXYSyOuygSoRfRHg32VakwbQlXg6PuBgVAwdEphwdQC6qA rRgh0vYxSxjZjmd0RMyKwPF9S7aY6NicGMjJIcuDftMteBDgCBtsPTG3Qmc0b1Eg RRQXFDwOnGqHYTNZi1dPGqX0y1aYLKwN0yLSyc0S/+CKiz7rUVLYhjx0bcE3bs9K wRxzW4kDQdZUZiTCVhAP3H5rILhVDt4ioe8IUj6HdPErgft+tW7Ro7+IGM/RHi3r H1LZhV90bJobQ2YM/zixx9pUUOqBwUAHWYd/T1rsmp3BUcAffvjS2XfxgKNFvI30 j0KC/ewhHl5b/5vhbdVlD6FWJiKevQYmYJgcSdtyI2D4j3NwQgrECTzWZxahUWaX 8S+3yTgqdbST6Jo/N/HaN+gvZuSa2AKbp6mR20gbBA0fRI7ReulmV5c0/QtJL4+o xGBOWz1mVQLlhTWT3RXNAtJGe+9NLFmJ7ASZ6qalNXHVP1T+IpoGTMRD+4yWndGu rtvJpkxYu+IzyFz2EWOmy1ifPOaF+TipUQkM+piH1f/2Rw2x+LlzJMJttkIoemtI La3PxSsdxk6c23wXp9lepumbkrf15sdAmzSVNhhSdzqhwiBx4A4= =4CFO -----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/3db11045-41eb-a4a5-c16f-c6564fd339f5%40kulinacs.com. For more options, visit https://groups.google.com/d/optout.