-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 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) > > 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.
I think separate doc package for man pages was a mistake. But other than that I agree. > 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> > - -- Best Regards, Marek Marczykowski-Górecki Invisible Things Lab A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBCAAGBQJYWaf3AAoJENuP0xzK19csmhMH+gKQ/c/qeDci3Y8/xapJ5gea 0PaL5aDGbrowD4+i3LUYBr+JRV65CHNNU9QhEMoOobGmJO0G6wST3oE/l8YXiH7O 1ttezROK5Nt7LLzgTpHjtp+yylF40LcCHe/G/70Bv/RGY0HbA2vTY4i3LM5lLc9U QnVr4PIwg81gfT1wlZCENShdTsc7aN0pRBxiQZvc5WzfDHQax3lzTDE1tfVEM2L9 HaCrSPqPS+oiP45qCZgspOn/IkHm1EACWMIMuvWylVnS6/8fQGasDOYkr4Es+5dd Etwe9Z+Kbr72Jn0QMDlkZjFOoxMwxbbFd7MDC9QK0HxjtBl27TFyHuP1HwfkMJU= =+F/+ -----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/20161220215150.GU1239%40mail-itl. For more options, visit https://groups.google.com/d/optout.