Plans for my web application framework continue. I now have a wealth of notes and ideas at http://wiki.digital-scurf.org/Aranha and I continue to add to it. I am currently pondering documentation styles and am interested in how various scripting languages document themselves. I am familiar with Perl’s POD documentation format, and also the Python docstring format (at least as far as .py files go) but I’m interested in how Python documents functions etc provided by its C interfacing layer. (I know Perl uses POD again). Also I’m interested in how languages like Ruby etc do it (assuming they do). I’ve got rudimentary ideas for documenting things in the Lua side of things using the styles and format shown at http://aranha.pepperfish.net/docs/ but I currently lack any good ideas for doing the equivalent from the C side (short of producing the Lua skeleton in a separate file and documenting the C side there).

Comments on this page are closed.