Prevent duplication of documentation in man pages

[jdorel]

Hi,
Currently there is some duplication of documentation between the website and the manpages.

Shoud a tool be used to generate both manpages and online documentation, or should manpages and the online documentation contain different content ?

[tbabej]

I think this is a direction we'd like to adopt moving forward. The website should contain a superset of information contained in the man pages. In order to get there, we need to do two things:

• Convert the website to statically generated site (i.e. using jekyll or hugo)
• Prototype conversion of static docs to manpages (i.e. using pandoc)

[lauft]

Timewarrior has chosen to use asciidoc as the new documentation format and generates both, the man pages and the HTML pages from it. Asciidoctor delivers the man pages we want and integrates well with Hugo which is used by ti.net.

However, the HTML pages are currently not crosslinked (automatically), see GothenburgBitFactory/ti.net#10. But I think you can define special macros in Asciidoctor which generate the desired result depending on the output format.