On Tue, 17 Jan 2012 12:17:54 -0800, Jameson Graef Rollins <jrollins@finestructure.net> wrote: > > We're not currently in the habit of adding doc strings for > non-interactive programs. Do we need to go down that route? It is handy for developers, since the usual documentation facilities (describe-function, apropos, ...) will then work for that function too. Emacs documentation recommends(-ish) this: ,----[ Elisp manual Section D.6 ] | An internal variable or subroutine of a Lisp program might as well | have a documentation string. In earlier Emacs versions, you could | save space by using a comment instead of a documentation string, | but that is no longer the case--documentation strings now take up | very little space in a running Emacs. `---- -- Aaron Ecay