Browse Source

doc/org.texi: (Initial visibility, Catching invisible edits): New subsections

* doc/org.texi (Global and local cycling): Wrap in a new subsection.
(Initial visibility, Catching invisible edits): New subsections.
Bastien Guerry 12 years ago
parent
commit
36a09801a3
1 changed files with 40 additions and 0 deletions
  1. 40 0
      doc/org.texi

+ 40 - 0
doc/org.texi

@@ -360,6 +360,17 @@ Document structure
 * Orgstruct mode::              Structure editing outside Org
 * Orgstruct mode::              Structure editing outside Org
 * Org syntax::                  Formal description of Org's syntax
 * Org syntax::                  Formal description of Org's syntax
 
 
+Visibility cycling
+
+* Global and local cycling::    Cycling through various visibility states
+* Initial visibility::          Setting the initial visibility state
+* Catching invisible edits::    Preventing mistakes when editing invisible parts
+
+Global and local cycling
+
+* Initial visibility::          Setting the initial visibility state
+* Catching invisible edits::    Preventing mistakes when editing invisible parts
+
 Tables
 Tables
 
 
 * Built-in table editor::       Simple tables
 * Built-in table editor::       Simple tables
@@ -1205,6 +1216,15 @@ variable @code{org-cycle-separator-lines} to modify this behavior.
 @cindex show hidden text
 @cindex show hidden text
 @cindex hide text
 @cindex hide text
 
 
+@menu
+* Global and local cycling::    Cycling through various visibility states
+* Initial visibility::          Setting the initial visibility state
+* Catching invisible edits::    Preventing mistakes when editing invisible parts
+@end menu
+
+@node Global and local cycling, Initial visibility, Visibility cycling, Visibility cycling
+@subsection Global and local cycling
+
 Outlines make it possible to hide parts of the text in the buffer.
 Outlines make it possible to hide parts of the text in the buffer.
 Org uses just two commands, bound to @key{TAB} and
 Org uses just two commands, bound to @key{TAB} and
 @kbd{S-@key{TAB}} to change the visibility in the buffer.
 @kbd{S-@key{TAB}} to change the visibility in the buffer.
@@ -1287,6 +1307,15 @@ the previously used indirect buffer.
 Copy the @i{visible} text in the region into the kill ring.
 Copy the @i{visible} text in the region into the kill ring.
 @end table
 @end table
 
 
+@menu
+* Initial visibility::          Setting the initial visibility state
+* Catching invisible edits::    Preventing mistakes when editing invisible parts
+@end menu
+
+@node Initial visibility, Catching invisible edits, Global and local cycling, Visibility cycling
+@subsection Initial visibility
+
+@cindex visibility, initialize
 @vindex org-startup-folded
 @vindex org-startup-folded
 @vindex org-agenda-inhibit-startup
 @vindex org-agenda-inhibit-startup
 @cindex @code{overview}, STARTUP keyword
 @cindex @code{overview}, STARTUP keyword
@@ -1327,6 +1356,17 @@ requested by startup options and @samp{VISIBILITY} properties in individual
 entries.
 entries.
 @end table
 @end table
 
 
+@node Catching invisible edits,  , Initial visibility, Visibility cycling
+@subsection Catching invisible edits
+
+@vindex org-catch-invisible-edits
+@cindex edits, catching invisible
+Sometimes you may inadvertantly edit an invisible part of the buffer and be
+confused on what as been edited and how to undo the mistake.  Setting
+@code{org-catch-invisible-edits} to non-nil will help prevent this.  See the
+docstring of this option on how Org should catch invisible edits and process
+them.
+
 @node Motion, Structure editing, Visibility cycling, Document Structure
 @node Motion, Structure editing, Visibility cycling, Document Structure
 @section Motion
 @section Motion
 @cindex motion, between headlines
 @cindex motion, between headlines