[5306] describe form feed processing

[karl]

Revision: 5306
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5306
Author:   karl
Date:     2013-08-11 17:46:00 +0000 (Sun, 11 Aug 2013)
Log Message:
-----------
describe form feed processing

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.txi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2013-08-11 14:17:39 UTC (rev 5305)
+++ trunk/ChangeLog     2013-08-11 17:46:00 UTC (rev 5306)
@@ -1,3 +1,7 @@
+2013-08-11  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Conventions): add item about form feed processing.
+
 2013-08-11  Patrice Dumas  <address@hidden>
 
        * tp/Texinfo/Convert/HTML.pm(output): sort when processing renamed

Modified: trunk/doc/texinfo.txi
===================================================================
--- trunk/doc/texinfo.txi       2013-08-11 14:17:39 UTC (rev 5305)
+++ trunk/doc/texinfo.txi       2013-08-11 17:46:00 UTC (rev 5306)
@@ -1335,6 +1335,36 @@
 contexts, such as @code{@@code} and @code{@@example}.
 
 @item
address@hidden Form feed characters
address@hidden @kbd{CTRL-l}
+Form feed (@kbd{CTRL-l}) characters in the input are handled as
+follows:
+
address@hidden @asis
address@hidden PDF/DVI
+In normal text, treated as ending any open paragraph; essentially
+ignored between paragraphs.
+
address@hidden Info
+Output as-is, as part of the normal text stream.
+
address@hidden HTML
+Written as a numeric entity except contexts where spaces are ignored;
+for example, in @samp{@@address@hidden ^L address@hidden, the form feed is
+ignored.
+
address@hidden XML
+Keep them everywhere; in attributes, escaped as @samp{\f}; also,
address@hidden is escaped as @samp{\\} and newline as @samp{\n}.
+
address@hidden Docbook
+Completely removed, as they are not allowed.
address@hidden table
+
+As you can see, because of these differing requirements of the output
+formats, it's not possible to use form feeds completely portably.
+
address@hidden
 @cindex Tabs; don't use!
 @strong{Caution:} Last, do not use tab characters in a Texinfo file!
 (Except perhaps in verbatim modes.)  @TeX{} uses variable-width fonts,
@@ -7318,6 +7348,8 @@
 @cindex Keys, recommended names
 @cindex Names recommended for keys
 @cindex Abbreviations for keys
address@hidden Control keys, specifying
address@hidden Meta keys, specifying
 
 @quotation
 @table @t
@@ -19086,8 +19118,8 @@
 When you create your own @file{dir} file for use with
 @code{Info-directory-list} or @env{INFOPATH}, it's easiest to start by
 copying an existing @file{dir} file and replace all the text after the
address@hidden Menu:} with your desired entries.  That way, the punctuation and
-special CTRL-_ characters that Info needs will be present.
address@hidden Menu:} with your desired entries.  That way, the punctuation
+and special @kbd{CTRL-_} characters that Info needs will be present.
 
 As one final alternative, which works only with Emacs Info, you can
 change the @code{Info-directory-list} variable.  For example: