On 03/12/2015 09:49 PM, Eric Blake wrote: > We also want to minimize effort - maintaining full > documentation by hand in both texinfo and roff formats would be too much > effort, so we have to generate the man page from something. It's easy > to use help2man to generate man pages from --help output, but I don't > know of any good conversion from texinfo to man.
I get the best result with 'pandoc' converting the .info file to markdown, followed by 'ronn' converting the markdown to man. The texi file would have to be split per command, of course. But I doubt that it would be easy to maintain the current texinfo structure while at the same time being able to have proper man pages with appropriate sections. Furthermore, pandoc and ronn have quite a big list of dependencies (Haskell, Ruby, ...). Thus said, it seems there is no proper way to maintain the documentation in one place to get both the texinfo manual and man pages. > I have to wonder if you actually hate 'info', rather than 'texinfo'. I prefer 'pinfo' over 'info' for viewing texinfo files. Have a nice day, Berny
