I've just begun a project in #Guile #Scheme, and I'm looking for tooling -- especially documentation tooling. #Clojure has Marginalia and Codox, both of which I like; Common #Lisp has Codex, Coo, Stable, cl-domain and others.
But the only thing I could find for Scheme is SchemeDoc, which is 'NOT MAINTAINED ANY MORE'.
https://people.cs.aau.dk/~normark/schemedoc/
Doxygen does not support Scheme out of the box, nor does Sphinx.
What else should I be looking at?
@tusharhero OK, can Texinfo pull comments out of a source file, automatically index and cross reference them, generate calling and caller graphs?
I am asking because I don't know; but I thought Texinfo was essentially just a markup language, and frankly, for my purposes, Markdown is better for that.
@simon_brooke I was looking for a generic R7RS documentation solution a while ago and ended up writing my own tooling: https://git.8pit.net/scmdoc/
Probably not feasible for general use right now, but the readme has some pointer to prior art. I personally use it for the documentation of the edward text editor, which you can browse here: https://files.8pit.net/edward/latest/doc/
If you find something better that (ideally) works with different R{5,7}RS Scheme implementations, please let me know :)
@nmeum My current thinking is that I'm probably going to abandon the first-pass compiler written in #Scheme. The reasons are:
1. I haven't found Scheme tooling I like;
2. The compiler has eventually to be written in #Lisp 1.5 if it's to be part of a Lisp 1.5 implementation, so I might as well just do it in Lisp 1.5.
It feels really disappointing that there doesn't seem to be -- or I haven't found -- nearly such a rich infrastructure for Scheme as there is for e.g. #Clojure.
Simon Brooke
tusharhero
nmeum