From c2e4ea10b39431f260e615c8fc1d23c72c835169 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Wed, 22 Feb 2017 14:04:30 +0100
Subject: [PATCH] MANUAL: Document that content above slide-level will be
 omitted...

in slide shows.  See #3460, #2265.
---
 MANUAL.txt | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/MANUAL.txt b/MANUAL.txt
index 105ef8b1e..0001c6cc1 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -715,9 +715,11 @@ Options affecting specific writers
     slides (for `beamer`, `s5`, `slidy`, `slideous`, `dzslides`).  Headers
     above this level in the hierarchy are used to divide the
     slide show into sections; headers below this level create
-    subheads within a slide.  The default is to set the slide level
-    based on the contents of the document; see
-    [Structuring the slide show].
+    subheads within a slide.  Note that content that is
+    not contained under slide-level headers will not appear in
+    the slide show.  The default is to set the slide level based
+    on the contents of the document; see [Structuring the slide
+    show].
 
 `--section-divs`
 
@@ -3671,6 +3673,9 @@ rules:
     "title slides," which just contain the section title
     and help to break the slide show into sections.
 
+  * Content *above* the slide level will not appear in the slide
+    show.
+
   * A title page is constructed automatically from the document's title
     block, if present.  (In the case of beamer, this can be disabled
     by commenting out some lines in the default template.)