Re: [comp.emacs.xemacs] Documenting elisp code

APA> Any comments? APA> From: Jarl Friis <jarl(a)diku.dk&gt; jf> according to the "elisp refference" (lispref.info) there are jf> som elisp commenting tips. It describes when to use one, two, jf> three, and four semicolons and where they should be put and jf> alligned. jf> But those tips don't fit to well with the tips given in the jf> "library headers" section (same info-file) , here ";;" is used jf> where, according to the commenting tips, ";;;" should be jf> used. similarily ";;;" is used where ";;;;" should be used. jf> The outline-mode seem to follow the library header tips, and jf> *not* the elisp commenting tips. Do you mean outline-mode _in use_ groks the library header tips? Or that the source code is written in conformance with them? jf> Why are the tips so contradicting? Probably because they were written by different people. For my money, the lisp-mnt library explicitly supports the "library header" approach, I think there are other tools (maybe outline mode?) that do too. What does emacs-lisp-mode do? If it is compatible with lisp-mnt style, we should settle on that style. -- Institute of Policy and Planning Sciences http://turnbull.sk.tsukuba.ac.jp University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN Don't ask how you can "do" free software business; ask what your business can "do for" free software.