diff options
authorBastien Guerry <>2013-01-08 15:19:31 (GMT)
committer Bastien Guerry <>2013-01-08 15:19:31 (GMT)
commitc8c217aa5533e9532cf6d4cd059a8752d971d7c8 (patch)
parenta4b41431327c89392066f76910fd3af8e8b5d13a (diff)
org.texi: Document `org-mark-element' and `org-mark-subtree'
* org.texi (Structure editing): Document `org-mark-element' and `org-mark-subtree'. (Tag inheritance): Document `org-agenda-use-tag-inheritance'. Thanks to Nathaniel Cunningham for requesting this.
1 files changed, 18 insertions, 3 deletions
diff --git a/doc/org.texi b/doc/org.texi
index f5b4a3f..39577a3 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -1471,6 +1471,13 @@ Move subtree up (swap with previous subtree of same
Move subtree down (swap with next subtree of same level).
+Mark the element at point. Hitting repeatedly will mark subsequent elements
+of the one just marked. E.g. hitting @key{M-h} on a paragraph will mark it,
+hitting @key{M-h} immediately again will mark the next one.
+@orgcmd{C-c @@,org-mark-subtree}
+Mark the subtree at point. Hitting repeatedly will mark subsequent subtrees
+of the same level than the marked subtree.
@orgcmd{C-c C-x C-w,org-cut-subtree}
Kill subtree, i.e., remove it from buffer but save in kill ring.
With a numeric prefix argument N, kill N sequential subtrees.
@@ -4625,9 +4632,8 @@ changes in the line.}:
@vindex org-use-tag-inheritance
@vindex org-tags-exclude-from-inheritance
-To limit tag inheritance to specific tags, or to turn it off entirely, use
-the variables @code{org-use-tag-inheritance} and
+To limit tag inheritance to specific tags, use @code{org-tags-exclude-from-inheritance}.
+To turn it off entirely, use @code{org-use-tag-inheritance}.
@vindex org-tags-match-list-sublevels
When a headline matches during a tags search while tag inheritance is turned
@@ -4638,6 +4644,15 @@ of matches may then become very long. If you only want to see the first tags
match in a subtree, configure the variable
@code{org-tags-match-list-sublevels} (not recommended).
+@vindex org-agenda-use-tag-inheritance
+Tag inheritance is relevant when the agenda search tries to match a tag,
+either in the @code{tags} or @code{tags-todo} agenda types. In other agenda
+types, @code{org-use-tag-inheritance} has no effect. Still, you may want to
+have your tags correctly set in the agenda, so that tag filtering works fine,
+with inherited tags. Set @code{org-agenda-use-tag-inheritance} to control
+this: the default value includes all agenda types, but setting this to nil
+can really speed up agenda generation.
@node Setting tags, Tag searches, Tag inheritance, Tags
@section Setting tags
@cindex setting tags