Emacs and changing documentation formats

Posted Dec 11, 2014 6:51 UTC (Thu) by smurf (subscriber, #17840)
Parent article: Emacs and changing documentation formats

I wouldn't dismiss ReST and Sphinx quite so readily. Python is high-profile enough for my taste.

https://docs.python.org/devguide/documenting.html

Emacs and changing documentation formats

Posted Dec 11, 2014 9:44 UTC (Thu) by willnewton (guest, #68395) [Link] (1 responses)

LLVM also uses Sphinx.

Emacs and changing documentation formats

Posted Dec 11, 2014 14:05 UTC (Thu) by dave_malcolm (subscriber, #15013) [Link]

...and fwiw we're using Sphinx experimentally within GCC, for Ada, and for the new JIT feature in GCC 5; see:
https://dmalcolm.fedorapeople.org/gcc/libgccjit-api-docs/...

(yes, I need to get those docs built onto the gcc.gnu.org site)

Emacs and changing documentation formats

Posted Dec 11, 2014 22:34 UTC (Thu) by kjp (guest, #39639) [Link]

Asciidoc is also forked (github's asciidoctor is not 100% compatible). The grammar and official docs for asciidoc is also ... imprecise and not a formal grammar, to say the least.

Very interested seeing a sphinx vs asciidoc comparison from someone who has used both.