Re: [PATCH 0/1] buildstream man pages portability fix
On Mon, Aug 28, 2017 at 11:37:03AM -0400, Tristan Van Berkom wrote:
[snip]
Hi Richard !
Thanks for showing an interest :)
Please feel free to join us on buildstream-list[0] and discuss
buildstream things there too.
Also, sorry if this was not obvious to you but that is not the correct
thing to fix. We use click for the CLI frontend which has a little
extension for generating documentation (called click-man[1]).
There are some notes in HACKING.rst about man page generation, and an
open issue about automating the docs generation[2] (we are currently
just committing the generated files as a workaround for that bug).
What is non portable about the generated man pages and do you think you
could file a bug about that with the click-man project ?
Hello Tristan :)
The source for a man page should not contain blank lines,
and indentation should be done using the commands for setting the
indent level (.RS, .RE).
I'll join the buildstream list then and meanwhile try to see
if the click-man developers think this a bug or not.
Thanks,
Richard