on Tue Jan 24 2012, Carsten Dominik <carsten.dominik-AT-gmail.com> wrote:

> On 23.1.2012, at 16:27, Alexander Corvinus wrote:
>> Hi all,
>> I just reviewed code in org.el and noticed that function
>> org-show-subtree, which is called by org-cycle, unconditionally
>> shows whole subtree (exactly what I wanted to have in my
>> shortcuts!).
>> So the question is - why such useful functions like
>> org-show-subtree, hide-subtree, show-children aren't documented in
>> manual? Because of that, previously I thought that what I wanted was
>> impossible (without source change).
> Emacs outline-mode has a plethora of such specific commands, and
> exposes all of them as user interface.  Org prides itself
> to have compressed that entire functionality into the TAB and S-TAB
> commands.  You specific example, org-show-subtree is basically
> TAB TAB on a closed tree.  SO yes, there are lots such commands,
> but I am no sure it would be good to expose them in the manual.

That's the difference between a user manual (documents TAB TAB) and an
API reference manual.  But both are needed, especially since all Emacs
users eventually become programmers at some level.

Dave Abrahams
BoostPro Computing

Reply via email to