David Masterson <dsmaster...@icloud.com> writes:
> Okay, I'll try to put together a patch for what we've talked about in a
> few days.
Ah, should've used the MIME commmand -- resending PATCH.
diff --git a/doc/org-guide.org b/doc/org-guide.org
index 205623525..ef5ad1b43 100644
--- a/doc/org-guide.org
+++ b/doc/org-guide.org
@@ -117,13 +117,13 @@ Org start on the left margin[fn:1] with one or more stars
followed by
a space. For example:
#+begin_example
-,* Top level headline
+,* Top (or first) level headline
,** Second level
,*** Third level
some text
,*** Third level
more text
-,* Another top level headline
+,* Another top (or first) level headline
#+end_example
Note that a headline named after ~org-footnote-section~, which
diff --git a/doc/org-manual.org b/doc/org-manual.org
index f32d1271e..daee294bf 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -508,13 +508,13 @@ start on the left margin[fn:1] with one or more stars
followed by
a space. For example:
#+begin_example
-,* Top level headline
+,* Top (or first) level headline
,** Second level
,*** Third level
some text
,*** Third level
more text
-,* Another top level headline
+,* Another top (or first) level headline
#+end_example
#+vindex: org-footnote-section
@@ -12521,9 +12521,10 @@ following arguments.
- ~H~ ::
#+vindex: org-export-headline-levels
- Set the number of headline levels for export
- (~org-export-headline-levels~). Below that level, headlines are
- treated differently. In most backends, they become list items.
+ Set the last headline level for export as a headline
+ (~org-export-headline-levels~). For children of that level,
+ headlines are treated differently. In most backends, they become
+ list items.
- ~inline~ ::
diff --git a/lisp/ox.el b/lisp/ox.el
index c5e3bab98..0d360a313 100644
--- a/lisp/ox.el
+++ b/lisp/ox.el
@@ -534,10 +534,10 @@ t Allow export of math snippets."
:safe (lambda (x) (memq x '(t nil verbatim))))
(defcustom org-export-headline-levels 3
- "The last level which is still exported as a headline.
+ "This level and its parents will be exported as a headline.
-Inferior levels will usually produce itemize or enumerate lists
-when exported, but backend behavior may differ.
+Children of this level will usually produce itemized or
+enumerated lists when exported, but backend behavior may differ.
This option can also be set with the OPTIONS keyword,
e.g. \"H:2\"."
--
David Masterson
