If you would like to create html documentation of your source-code
install, you can do the following ...
$ cd /path/to/couchdb/src/couchdb
$ erl -noshell -eval "edoc:application(couchdb, \".\", [])" -s init stop
$ cd /path/to/couchdb/src/mochiweb
$ erl -noshell -eval "edoc:application(mochiweb, \".\", [])" -s init stop
The erl command will create a /src/mochiweb/doc and src/couchdb/doc
directory with the html.
edoc had no complaints compiling the documentation as of version
$ couchdb -V
couchdb - Apache CouchDB 0.9.0a729929-incubating
Then, point browser to file:///path/to/couchdb/src/couchdb/doc/index.html
~Michael
P.S. perhaps a doc/index.html target could be added to Makefiles,
something similar to
doc/index.html : $(SRC)
erl -noshell -eval "edoc:application(couchdb, \".\", [])" -s init stop
--
Michael McDaniel
Portland, Oregon, USA
http://autosys.us
http://trip.autosys.us