Bastien <b...@altern.org> writes: > Hi François,
>> Carsten Dominik <carsten.domi...@gmail.com> writes: >>> Note that there is a million variables which are not referred to >>> in the manual - simply too many to mention them all. >> A million? You *always* exaggerate! :-) > Well, I counted more than 1070 variables... describing 5 of them > per page would take 214 pages. Not something I'd like to read :) That's why I suggested an appendix. We search in them, more than we really read them. On the other hand, it would considerably augment the weight of a printed manual, and so, be more harmful to our forests. > Wrt documentation, Emacs is its own reference, by letting you access > everything with C-h v org-*. Emacs has impressive ways to offer its own documentation. Still a bit uneasy to use C-h v (or C-h f) on everything. M-x apropos org- RET is more handy and searchable, yet the documentation is likely limited to the first line of each docstring (so at least this convention for a complete sentence in the first line of a docstring). > Another point: there is a lot to do to improve the current docstrings > and the manual. This is a matter of 1) pulling from git, 2) modifying > the file, 3) run `C-x v =' in the buffer, 4) send the patch. [...] > If you're interested in improving this, please go ahead, I'd be > interested in getting something working along these lines. Oh, the problem is surely not the lack of interest, but the sore lack of free hours in a week, and the quantity of ways to occupy those rare hours already (something Org mode is tremendously helpful at organizing, by the way). Surely that given enough free time, I would just love to contribute. The truth is that I can only offer tiny crumbs. In any case, I'm saving your message and notes (who knows the future!). François