And so I'm looking for documentation generators. The end-user documentation, so Doxygen won't do.
The only thing I can think of is Qt Help system, which can be integrated quiet well.
Maintaining documentation in Wiki is ok, but will be incompatible with older versions.
Requirements are:
- Can generate documentation from command line
- Multi-platform (at least Win/Unix/Mac) support
- TOC (Table of Contents) autogeneration
- Preferable output type (one of):
- Single HTML
- Standard-compliant PDF
- Binary (like QtHelp; it actually uses sqlite3 database btw)
- Input files can be easily put under vcs (aka 'input files are text files')
- Do not require a lot of fancy stuff at runtime (like perl or python)
I currently have 3 candidates: AsciiDoc, Sphinx and markdown. Can't find any good sources on Qt documentation markup, will need to examine end-user documentation sources for designer/assistant/creator to see what it's made of.