From mboxrd@z Thu Jan  1 00:00:00 1970
From: Carsten Dominik <carsten.dominik@gmail.com>
Subject: Re: Why functions like org-show-subtree are undocumented?
Date: Tue, 24 Jan 2012 11:22:38 +0000
Message-ID: <C029C73A-9776-4DDC-9022-3870BB3170F4@gmail.com>
References: <CAMbC+T83GNHqZGAvTHd-4U2K8bymPJp2rmdNt2hoiozSZ9i=aw@mail.gmail.com>
Mime-Version: 1.0 (Apple Message framework v1084)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([140.186.70.92]:56392)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.dominik@gmail.com>) id 1RpfOe-0004u6-Bp
	for emacs-orgmode@gnu.org; Tue, 24 Jan 2012 07:22:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <carsten.dominik@gmail.com>) id 1RpfOZ-0003HT-GB
	for emacs-orgmode@gnu.org; Tue, 24 Jan 2012 07:22:44 -0500
Received: from mail-ww0-f49.google.com ([74.125.82.49]:43437)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <carsten.dominik@gmail.com>) id 1RpfOZ-0003HA-BB
	for emacs-orgmode@gnu.org; Tue, 24 Jan 2012 07:22:39 -0500
Received: by wgbds1 with SMTP id ds1so2051900wgb.30
	for <emacs-orgmode@gnu.org>; Tue, 24 Jan 2012 04:22:38 -0800 (PST)
In-Reply-To: <CAMbC+T83GNHqZGAvTHd-4U2K8bymPJp2rmdNt2hoiozSZ9i=aw@mail.gmail.com>
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Alexander Corvinus <acrvns@gmail.com>
Cc: emacs-orgmode@gnu.org


On 23.1.2012, at 16:27, Alexander Corvinus wrote:

> Hi all,
>=20
> 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!).
>=20
> 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.

- Carsten


>=20
> Thanks