From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nick Dokos <nicholas.dokos@hp.com>
Subject: Re: `org-refile' doc string
Date: Wed, 28 Apr 2010 17:04:26 -0400
Message-ID: <31379.1272488666@alphaville.usa.hp.com>
References: <87sk6fh1ny.fsf@gmail.com> <10381.1272481004@alphaville.usa.hp.com>
	<87och3gvxc.fsf@gmail.com>
Reply-To: nicholas.dokos@hp.com
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1O7EY1-0001z3-CW
	for emacs-orgmode@gnu.org; Wed, 28 Apr 2010 17:11:57 -0400
Received: from [140.186.70.92] (port=35126 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1O7EY0-00019G-0i
	for emacs-orgmode@gnu.org; Wed, 28 Apr 2010 17:11:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69)
	(envelope-from <nicholas.dokos@hp.com>) id 1O7EQm-0006X9-JK
	for emacs-orgmode@gnu.org; Wed, 28 Apr 2010 17:04:38 -0400
Received: from g4t0016.houston.hp.com ([15.201.24.19]:8757)
	by eggs.gnu.org with esmtp (Exim 4.69)
	(envelope-from <nicholas.dokos@hp.com>) id 1O7EQm-0006Wu-ER
	for emacs-orgmode@gnu.org; Wed, 28 Apr 2010 17:04:28 -0400
In-Reply-To: Message from =?us-ascii?Q?=3D=3Futf-8=3FB=3FxaB0xJtww6FuIE7Em?=
	=?us-ascii?Q?21lYw=3D=3D=3F=3D?= <stepnem@gmail.com>
	of "Wed\, 28 Apr 2010 22\:32\:31 +0200." <87och3gvxc.fsf@gmail.com>
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: carsten.dominik@gmail.com, =?us-ascii?Q?=3D=3Futf-8=3FB=3FxaB0xJtww6Fu?= =?us-ascii?Q?IE7Em21lYw=3D=3D=3F=3D?= <stepnem@gmail.com>
Cc: nicholas.dokos@hp.com, emacs-orgmode@gnu.org

=C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec <stepnem@gmail.com> wrote:

> Nick Dokos <nicholas.dokos@hp.com> writes:
>=20
> > ...
> > Maybe the doc string should say:
> >
> >   ... However, the region must satisfy some constraints: it has to be
> >   a subtree (or a sequence of subtrees).
> >
> > Would that be clear enough?
>=20
> Clear enough for me to understand at least, thanks!
> An alternative and more verbose wording could be something like:
>=20
>   However, the region must fulfil the requirement that all the included
>   headings are on the same level as the first one or below (i.e.
>   a subtree or sequence of subtrees).
>=20
> Best,
>=20
>   =C5=A0t=C4=9Bp=C3=A1n
>=20

OK - here's a patch - mostly =C5=A0t=C4=9Bp=C3=A1n's wording.

Thanks,
Nick

diff --git a/lisp/org.el b/lisp/org.el
index 9920504..748c140 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -9556,9 +9556,9 @@ Depending on `org-reverse-note-order', the new subite=
m will either be the
 first or the last subitem.
=20
 If there is an active region, all entries in that region will be moved.
-However, the region must fulfil the requirement that the first heading
-is the first one sets the top-level of the moved text - at most siblings
-below it are allowed.
+However, the region must fulfill the requirement that all the included
+headings are on the same level as the first one or below (i.e. it must
+be a subtree or a sequence of subtrees.)
=20
 With prefix arg GOTO, the command will only visit the target location,
 not actually move anything.