[6495] some rewording for sample file chapter

[Gavin D. Smith]

Revision: 6495
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6495
Author:   gavin
Date:     2015-08-03 10:34:51 +0000 (Mon, 03 Aug 2015)
Log Message:
-----------
some rewording for sample file chapter

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-08-03 10:10:44 UTC (rev 6494)
+++ trunk/ChangeLog     2015-08-03 10:34:51 UTC (rev 6495)
@@ -1,5 +1,13 @@
 2015-08-03  Gavin Smith  <address@hidden>
 
+       * doc/texinfo.texi (Short Sample Texinfo File): Remove some 
+       unnecessary words.
+       (Sample Texinfo Files): Reword slightly.
+       (Short Sample): Remove some unnecessary words and sentences, and 
+       rearrange some paragraphs.
+
+2015-08-03  Gavin Smith  <address@hidden>
+
        * doc/texinfo.texi: Remove commented-out appendices.
 
 2015-08-03  Gavin Smith  <address@hidden>

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2015-08-03 10:10:44 UTC (rev 6494)
+++ trunk/doc/texinfo.texi      2015-08-03 10:34:51 UTC (rev 6495)
@@ -1566,21 +1566,19 @@
 @section A Short Sample Texinfo File
 @cindex Sample Texinfo file, with comments
 
-Here is a very short but complete Texinfo file, in the six conventional
+Here is a short but complete Texinfo file consisting of the
 parts enumerated in the previous section, so you can see how Texinfo
-source appears in practice.  The first three parts of the file, from
address@hidden texinfo} through to @samp{@@end titlepage}, look more
-intimidating than they are: most of the material is standard
-boilerplate; when writing a manual, you simply change the names as
-appropriate.
+source appears in practice.  The first three parts of the file are
+mostly boilerplate: when writing a manual, you simply change
+the names as appropriate.
 
address@hidden and Ending a File}, for full documentation on the 
-commands listed here.  @xref{GNU Sample Texts}, for the full texts to be 
+The complete file, without interspersed comments, is shown in
address@hidden Sample Texinfo File}.
+
address@hidden and Ending a File}, for more documentation on the
+commands listed here.  @xref{GNU Sample Texts}, for the full texts to be
 used in GNU manuals.
 
-In the following, the sample text is @emph{indented}; comments on it are
-not.  The complete file, without interspersed comments, is shown in
address@hidden Sample Texinfo File}.
 
 @subheading Part 1: Header
 
@@ -22583,8 +22581,8 @@
 @appendix Sample Texinfo Files
 @cindex Sample Texinfo files
 
-The first example is from the first chapter (@pxref{Short Sample}),
-given here in its entirety, without commentary.  The second
+The first example from the first chapter (@pxref{Short Sample}) is
+given here in its entirety, without commentary.  The second example
 includes the full texts to be used in GNU manuals.
 
 @menu
@@ -22599,9 +22597,8 @@
 @section Short Sample
 @cindex Sample Texinfo file, no comments
 
-Here is a complete, short sample Texinfo file, without any commentary.
-You can see this file, with comments, in the first chapter.  @xref{Short
-Sample}.
+Here is a complete, short sample Texinfo file.  You can see this file, 
+with comments, in the first chapter.  @xref{Short Sample}.
 
 In a nutshell: The @command{makeinfo} program transforms a Texinfo
 source file such as this into an Info file or HTML; and @TeX{} typesets