[Guile-commits] 09/10: [doc] Clean up .texi for modern GNU Texinfo

[Thien-Thi Nguyen]

ttn pushed a commit to branch branch_release-1-8
in repository guile.

commit 4c6f43a6359e8bcc180d48d260cc9dde6b2a239d
Author: Thien-Thi Nguyen <address@hidden>
Date:   Fri Mar 3 10:17:03 2017 +0100

    [doc] Clean up .texi for modern GNU Texinfo
    
    These changes are the minimal needed to get "make" to
    complete w/o error or warnings using GNU Texinfo 6.3.
    
    * doc/goops/goops.texi <title page>: Condense @author lines.
      (Running GOOPS, Methods, User-defined types)
      (Asking for the type of an object):
      Promote these nodes from subsection to section.
    * doc/r5rs/r5rs.texi <title page>: Remove spurious @author;
      change @unnumbered to @heading.
      (Entry format): Comment out spurious @center;
      remove spurious @item.
      (Characters): Likewise.
      (Lexical structure): Rework @format blocks w/ embedded
      @t and @cindex, as a series of abutting @example blocks
      that close and reopen around the @cindex; and sans @t.
      (Additional material): Comment out spurious @center lines.
    * doc/tutorial/guile-tut.texi (Hello World):
      Promote from @subsection to @section.
      (A bunch of operations in Scheme): Likewise;
      change @print to take no args.
      (Using recursion to process lists, Processing matrices):
      Promote from @subsection to @section.
      (Using Guile to program in Scheme): Change @print to take no args.
---
 doc/goops/goops.texi        | 19 ++++++----------
 doc/r5rs/r5rs.texi          | 53 ++++++++++++++++++++++++++++-----------------
 doc/tutorial/guile-tut.texi | 18 +++++++--------
 3 files changed, 49 insertions(+), 41 deletions(-)

diff --git a/doc/goops/goops.texi b/doc/goops/goops.texi
index d6d8e59..dcd699c 100644
--- a/doc/goops/goops.texi
+++ b/doc/goops/goops.texi
@@ -48,14 +48,9 @@ are preserved on all copies.
 @c and MOP documentation were written by Neil Jerram and reviewed by
 @c Mikael Djurfeldt.
 
address@hidden Christian Lynbech
address@hidden @email{chl@@tbit.dk}
address@hidden
address@hidden Mikael Djurfeldt
address@hidden @email{djurfeldt@@nada.kth.se}
address@hidden
address@hidden Neil Jerram
address@hidden @email{neil@@ossau.uklinux.net}
address@hidden Christian Lynbech @email{chl@@tbit.dk}
address@hidden Mikael Djurfeldt @email{djurfeldt@@nada.kth.se}
address@hidden Neil Jerram @email{neil@@ossau.uklinux.net}
 
 @c  The following two commands
 @c  start the copyright page.
@@ -131,7 +126,7 @@ info (goops.info) and texinfo format.
 @end menu
 
 @node Running GOOPS, Methods, Getting Started, Getting Started
address@hidden Running GOOPS
address@hidden Running GOOPS
 
 @enumerate
 @item
@@ -158,7 +153,7 @@ arbitrary Guile interpreter.)
 We're now ready to try some basic GOOPS functionality.
 
 @node Methods, User-defined types, Running GOOPS, Getting Started
address@hidden Methods
address@hidden Methods
 
 @smalllisp
 @group
@@ -171,7 +166,7 @@ We're now ready to try some basic GOOPS functionality.
 @end smalllisp
 
 @node User-defined types, Asking for the type of an object, Methods, Getting 
Started
address@hidden User-defined types
address@hidden User-defined types
 
 @smalllisp
 (define-class <2D-vector> ()
@@ -201,7 +196,7 @@ v --> <3, 4>
 @end smalllisp
 
 @node Asking for the type of an object, , User-defined types, Getting Started
address@hidden Types
address@hidden Types
 
 @example
 (class-of v) --> #<<class> <2D-vector> 40241ac0>
diff --git a/doc/r5rs/r5rs.texi b/doc/r5rs/r5rs.texi
index 605a976..5c0e2b7 100644
--- a/doc/r5rs/r5rs.texi
+++ b/doc/r5rs/r5rs.texi
@@ -106,7 +106,6 @@
 @author C. address@hidden 
 @author K. M. address@hidden 
 @author M. address@hidden 
address@hidden 
 
 
 @c  {\it Dedicated to the Memory of ALGOL 60}
@@ -116,7 +115,7 @@
 
 
 
address@hidden Summary
address@hidden Summary
 
 
 The report gives a defining description of the programming language
@@ -760,7 +759,7 @@ conventions also imply type restrictions:
 @c \newcommand{\foo}[1]{\vr{#1}, \vri{#1}, $\ldots$ \vrj{#1}, $\ldots$}
 
 
address@hidden @c begin-tabular
address@hidden @center @c begin-tabular
 @quotation
 @table @asis
 @item @var{obj}
@@ -779,7 +778,6 @@ rational number
 integer
 @item @var{k}, @var{k1}, @dots{} @var{kj}, @dots{}
 exact non-negative integer
address@hidden 
 @end table
 @end quotation
 
@@ -5566,7 +5564,7 @@ For example:
 
 
 
address@hidden @c begin-tabular
address@hidden @center @c begin-tabular
 @quotation
 @table @asis
 @item @t{#\a}
@@ -5581,7 +5579,6 @@ For example:
 ; the preferred way to write a space
 @item @t{#\newline}
 ; the newline character
address@hidden 
 @end table
 @end quotation
 
@@ -7272,20 +7269,24 @@ The following five characters are reserved for future 
extensions to the
 language: @t{[ ] @{ @} |}
 
 
address@hidden
address@hidden<token> --> <identifier> | <boolean> | <number>
address@hidden
+<token> --> <identifier> | <boolean> | <number>
address@hidden example
 @cindex @w{identifier}
address@hidden
      | <character> | <string>
      | ( | ) | #( | @t{'} | @t{`} | , | ,@@ | @b{.}
 <delimiter> --> <whitespace> | ( | ) | " | ;
 <whitespace> --> <space or newline>
 <comment> --> ;  <@r{all subsequent characters up to a}
                  @r{line break>}
address@hidden example
 @cindex @w{comment}
address@hidden
 <atmosphere> --> <whitespace> | <comment>
-<intertoken space> --> <atmosphere>*}
+<intertoken space> --> <atmosphere>*
 
address@hidden format
address@hidden example
 
 
 
@@ -7296,8 +7297,8 @@ language: @t{[ ] @{ @} |}
 
 
 
address@hidden
address@hidden<identifier> --> <initial> <subsequent>*
address@hidden
+<identifier> --> <initial> <subsequent>*
      | <peculiar identifier>
 <initial> --> <letter> | <special initial>
 <letter> --> a | b | c | ... | z
@@ -7310,8 +7311,10 @@ language: @t{[ ] @{ @} |}
 <special subsequent> --> + | - | .@: | @@
 <peculiar identifier> --> + | - | ...
 <syntactic keyword> --> <expression keyword>
address@hidden example
 @cindex @w{syntactic keyword}
 @cindex @w{keyword}
address@hidden
      | else | => | define 
      | unquote | unquote-splicing
 <expression keyword> --> quote | lambda | if
@@ -7320,7 +7323,9 @@ language: @t{[ ] @{ @} |}
      | quasiquote
 
 @address@hidden<variable> @result{} <address@hidden <identifier> that isn't}
address@hidden example
 @cindex @w{variable}
address@hidden
        @w{         @r{also a <syntactic keyword>>}}
 
 <boolean> --> #t | #f
@@ -7330,9 +7335,9 @@ language: @t{[ ] @{ @} |}
 
 <string> --> " <string element>* "
 <string element> --> <any character other than " or \>
-     | \" | \\ }
+     | \" | \\
 
address@hidden format
address@hidden example
 
 
 
@@ -7385,27 +7390,35 @@ Mark Meyer and David Bartley want to fix this.  (What? 
-- Will)
 
 
 
address@hidden
address@hidden<suffix> --> <empty> 
address@hidden
+<suffix> --> <empty> 
     | <exponent marker> <sign> <digit 10>+
 <exponent marker> --> e | s | f | d | l
 <sign> --> <empty>  | + |  -
 <exactness> --> <empty> | #i | #e
address@hidden example
 @vindex #e
 @vindex #i
address@hidden
 <radix 2> --> #b
address@hidden example
 @vindex #b
address@hidden
 <radix 8> --> #o
address@hidden example
 @vindex #o
address@hidden
 <radix 10> --> <empty> | #d
 <radix 16> --> #x
address@hidden example
 @vindex #x
address@hidden
 <digit 2> --> 0 | 1
 <digit 8> --> 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7
 <digit 10> --> <digit>
-<digit 16> --> <digit 10> | a | b | c | d | e | f }
+<digit 16> --> <digit 10> | a | b | c | d | e | f
 
address@hidden format
address@hidden example
 
 
 
@@ -8057,9 +8070,9 @@ Cromarty:
 
 The Internet Scheme Repository at
 
address@hidden 
address@hidden @center 
 @center @url{http://www.cs.indiana.edu/scheme-repository/}
address@hidden 
address@hidden @center 
 
 contains an extensive Scheme bibliography, as well as papers,
 programs, implementations, and other material related to Scheme.
diff --git a/doc/tutorial/guile-tut.texi b/doc/tutorial/guile-tut.texi
index ed0b202..91ad899 100644
--- a/doc/tutorial/guile-tut.texi
+++ b/doc/tutorial/guile-tut.texi
@@ -446,7 +446,7 @@ get started, look at the books @cite{Simply Scheme} and 
@cite{The Little
 Schemer} from that list.}
 
 
address@hidden Hello World
address@hidden Hello World
 @cindex hello world
 
 Our first program is the typical Scheme "hello world" program.  Put the
@@ -483,7 +483,7 @@ is then terminated with @code{!#} on the second line so as 
to not
 interfere with the execution mechanism.
 
 
address@hidden A bunch of operations in Scheme
address@hidden A bunch of operations in Scheme
 
 Here is some code you can type at the @code{guile>} prompt to see some
 of the Scheme data types at work (mostly lists and vectors).  I have
@@ -535,12 +535,12 @@ guile> @kbd{(memq 4 ls)}
 guile> @kbd{(if (memq 4 ls)
            (display "hey, it's true!\n")
            (display "dude, it's false\n"))}
-       @print{hey, it's true!}
+       @print{} hey, it's true!
        @result{}
 guile> @kbd{(if (memq 12 ls)
            (display "hey, it's true!\n")
            (display "dude, it's false\n"))}
-       @print{dude, it's false}
+       @print{} dude, it's false
        @result{}
 guile> @kbd{(memq 4 (reverse ls))}
        @result{} (4 3 2 1)
@@ -583,7 +583,7 @@ guile> @kbd{v}
 @end smalllisp
 
 
address@hidden Using recursion to process lists
address@hidden Using recursion to process lists
 @cindex recursion
 @cindex list processing
 
@@ -600,7 +600,7 @@ Here are some typical examples of using recursion to 
process a list.
 @end smalllisp
 
 
address@hidden Processing matrices
address@hidden Processing matrices
 
 Suppose you have a matrix represented as a list of lists:
 
@@ -656,9 +656,9 @@ And then invoke it with
 (represent-matrix m
                   (lambda (x) (begin (display x) (display " ")))
                   (lambda (l) (begin (display "\n"))))
address@hidden 2 1 3 2 8 5 3 6}
address@hidden 1 1 1 3 8 9 8 1}
address@hidden 5 4 8 1 8 2 2 4}
address@hidden 7 2 1 3 2 8 5 3 6
address@hidden 4 1 1 1 3 8 9 8 1
address@hidden 5 5 4 8 1 8 2 2 4
 @end smalllisp
 
 @cindex objects