emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] Why functions like org-show-subtree are undocumented?


From: Dave Abrahams
Subject: Re: [O] Why functions like org-show-subtree are undocumented?
Date: Sun, 26 Feb 2012 10:25:28 -0500
User-agent: Gnus/5.130004 (Ma Gnus v0.4) Emacs/24.0.92 (darwin)

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
http://www.boostpro.com




reply via email to

[Prev in Thread] Current Thread [Next in Thread]