Browse Source

doc/org.texi (Orgstruct mode): Document `orgstruct-heading-prefix-regexp'

* doc/org.texi (Orgstruct mode): Document
`orgstruct-heading-prefix-regexp'.
Bastien Guerry 12 years ago
parent
commit
975329f904
1 changed files with 14 additions and 4 deletions
  1. 14 4
      doc/org.texi

+ 14 - 4
doc/org.texi

@@ -1973,10 +1973,20 @@ When this mode is active and the cursor is on a line that looks to Org like a
 headline or the first line of a list item, most structure editing commands
 will work, even if the same keys normally have different functionality in the
 major mode you are using.  If the cursor is not in one of those special
-lines, Orgstruct mode lurks silently in the shadows.  When you use
-@code{orgstruct++-mode}, Org will also export indentation and autofill
-settings into that mode, and detect item context after the first line of an
-item.
+lines, Orgstruct mode lurks silently in the shadows.
+
+When you use @code{orgstruct++-mode}, Org will also export indentation and
+autofill settings into that mode, and detect item context after the first
+line of an item.
+
+@vindex orgstruct-heading-prefix-regexp
+You can also use Org structure editing to fold and unfold headlines in
+@emph{any} file, provided you defined @var{orgstruct-heading-prefix-regexp}:
+the regular expression must match the local prefix to use before Org's
+headlines.  For example, if you set this variable to @code{"^;; "} in Emacs
+Lisp files, you will be able to fold and unfold headlines in Emacs Lisp
+commented lines.  Some commands like @code{org-demote} are disabled when the
+prefix is set, but folding/unfolding will work correctly.
 
 @node Tables, Hyperlinks, Document Structure, Top
 @chapter Tables