Samuel Wales <samolog...@gmail.com> writes: > why not include the docstrings of all commands in some nice format in > the .org manual via some mechanism? > > would that be a good practice? seems useful abstractly.
There are two problems: 1. We need to convert from Elisp docstring format to Org markup 2. More importantly, User manual is something to be written as a coherent text; not an agglomeration of docstring. (Yes, I am aware of the fact that it is not always the case in practice; But we should not encourage the current situation) -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>