[6033] more on closing punctuation and sentence ending

[karl]

Revision: 6033
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6033
Author:   karl
Date:     2015-01-11 00:43:49 +0000 (Sun, 11 Jan 2015)
Log Message:
-----------
more on closing punctuation and sentence ending

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-01-10 23:21:04 UTC (rev 6032)
+++ trunk/ChangeLog     2015-01-11 00:43:49 UTC (rev 6033)
@@ -1,3 +1,8 @@
+2015-01-10  Karl Berry  <address@hidden>
+
+       * doc/texinfo.texi (Ending a Sentence): attempt to clarify
+       the interaction of closing punctuation and sentence endings.
+
 2015-01-10  Gavin Smith  <address@hidden>
 
        * doc/texinfo.texi (Invoking texi2any) <--split>: Change a "." 

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2015-01-10 23:21:04 UTC (rev 6032)
+++ trunk/doc/texinfo.texi      2015-01-11 00:43:49 UTC (rev 6033)
@@ -11168,14 +11168,15 @@
 @findex ? @r{(end of sentence)}
 @cindex Spacing, at ends of sentences
 As mentioned above, Texinfo normally inserts additional space after
-the end of a sentence.  It uses a simple heuristic for this: a
-sentence ends with a period, exclamation point, or question mark
-followed by optional closing punctuation and then whitespace, and
address@hidden preceded by a capital letter.
+the end of a sentence.  It uses the same heuristic for this as @TeX{}:
+a sentence ends with a period, exclamation point, or question mark,
+either preceded or followed by optional closing punctuation, and then
+whitespace, and @emph{not} preceded by a capital letter.
 
 Use @code{@@.}@: instead of a period, @code{@@!}@: instead of an
 exclamation point, and @code{@@?}@: instead of a question mark at the
-end of a sentence that does end with a capital letter.  For example:
+end of a sentence that does end with a capital letter.  Do not put
+braces after any of these commands.  For example:
 
 @example
 Give it to M.I.B. and to M.E.W@@.  Also, give it to R.J.C@@.
@@ -11194,20 +11195,29 @@
 In the HTML output, @code{@@.}@: is equivalent to a simple @samp{.};
 likewise for @code{@@!}@: and @code{@@?}@:.
 
address@hidden Closing punctuation, and sentence ending
+The ``closing punctuation'' mentioned above is defined as a right
+parenthesis (@samp{)}, right bracket (@samp{]}), or right quote,
+either single or double (@samp{'} and @samp{''}; the many possible
+additional Unicode right quotes are not included).  These characters
+can be thought of as invisible with respect to whether a given period
+ends a sentence.  (This is the same rule as @TeX{}.)  For instance,
+the periods in @samp{foo.) Bar} and @samp{foo.'' Bar} do end
+sentences.
+
 The meanings of @code{@@:} and @code{@@.}, etc.@: in Texinfo are
 designed to work well with the Emacs sentence motion commands
 (@pxref{Sentences,,, emacs, The GNU Emacs Manual}).
 
-Do not put braces after any of these commands.
-
 A few Texinfo commands are not considered as being an abbreviation,
 even though they may end with a capital letter when expanded, so that
-you don't have to insert @code{@@.} and companions.  This is the case
-for code-like highlighting commands, @code{@@var} arguments ending
-with a capital letter, and @code{@@TeX}.  For example, that sentence
-ended with @samp{@@address@hidden@@@@address@hidden; @code{@@.} was not 
needed.  Also
-in @code{... @@address@hidden@}. Text} the period after @var{VARNAME}
-ends the sentence; there is no need to use @code{@@.}.
+you don't have to insert @code{@@.} and companions.  Notably, this is
+the case for code-like highlighting commands, @code{@@var} arguments
+ending with a capital letter, @code{@@LaTeX}, and @code{@@TeX}.  For
+example, that sentence ended with @samp{... @@address@hidden@@@@address@hidden;
address@hidden@@.} was not needed.  Similarly, in
address@hidden @@address@hidden@}. Text} the period after @var{VARNAME} ends
+the sentence; there is no need to use @code{@@.}.
 
 
 @node @t{@@frenchspacing}
@@ -19774,14 +19784,13 @@
 
 @cindex HTML output, browser compatibility of
 First, the HTML generated by @command{makeinfo} is standard
address@hidden  It also tries to be as compatible as possible with
-earlier standards (e.g., address@hidden, RFC-1866).  Thus, please
-report output from an error-free run of @code{makeinfo} which has
-practical browser portability problems as a bug (@pxref{Reporting
-Bugs}).
address@hidden  It also tries to be compatible with earlier standards
+(e.g., address@hidden, RFC-1866).  Thus, please report output from an
+error-free run of @code{makeinfo} which has practical browser
+portability problems as a bug (@pxref{Reporting Bugs}).
 
 @pindex html32.pm
-Some known exceptions to address@hidden (using
+Some known exceptions to address@hidden (using
 @samp{--init-file=html32.pm} produces strict address@hidden output;
 @pxref{Invoking @t{texi2any}}):