Some doc edits.

1 files changed, 44 insertions, 47 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index 3b48e2bb..10486cea 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1457,8 +1457,8 @@ pressing the @kbd{d} key and finally releasing both keys.
 @cindex Kernighan, Brian
 @quotation
 @i{Dark corners are basically fractal --- no matter how much
-you illuminate, there's always a smaller but darker one.}@*
-Brian Kernighan
+you illuminate, there's always a smaller but darker one.}
+@author Brian Kernighan
 @end quotation
 
 @cindex d.c., See dark corner
@@ -4216,8 +4216,8 @@ in case some option becomes obsolete in a future version of @command{gawk}.
 @cindex Jedi knights
 @cindex Knights, jedi
 @quotation
-@i{Use the Source, Luke!}@*
-Obi-Wan
+@i{Use the Source, Luke!}
+@author Obi-Wan
 @end quotation
 
 This @value{SECTION} intentionally left
@@ -7583,8 +7583,8 @@ that does handle nested @samp{@@include} statements.
 @c From private email, dated October 2, 1988. Used by permission, March 2013.
 @quotation
 @i{Omniscience has much to recommend it.
-Failing that, attention to details would be useful.}@*
-Brian Kernighan
+Failing that, attention to details would be useful.}
+@author Brian Kernighan
 @end quotation
 
 @cindex @code{|} (vertical bar), @code{|} operator (I/O)
@@ -10286,8 +10286,8 @@ For maximum portability, do not use the @samp{**} operator.
 @subsection String Concatenation
 @cindex Kernighan, Brian
 @quotation
-@i{It seemed like a good idea at the time.}@*
-Brian Kernighan
+@i{It seemed like a good idea at the time.}
+@author Brian Kernighan
 @end quotation
 
 @cindex string operators
@@ -10817,8 +10817,8 @@ like @samp{@var{lvalue}++}, but instead of adding, it subtracts.)
 @cindex Marx, Groucho
 @quotation
 @i{Doctor, doctor!  It hurts when I do this!@*
-So don't do that!}@*
-Groucho Marx
+So don't do that!}
+@author Groucho Marx
 @end quotation
 
 @noindent
@@ -10869,8 +10869,8 @@ You should avoid such things in your own programs.
 @cindex Marx, Groucho
 @quotation
 @i{Doctor, doctor!  It hurts when I do this!@*
-So don't do that!}@*
-Groucho Marx
+So don't do that!}
+@author Groucho Marx
 @end quotation
 
 @noindent
@@ -10968,8 +10968,8 @@ the string constant @code{"0"} is actually true, because it is non-null.
 @node Typing and Comparison
 @subsection Variable Typing and Comparison Expressions
 @quotation
-@i{The Guide is definitive. Reality is frequently inaccurate.}@*
-The Hitchhiker's Guide to the Galaxy
+@i{The Guide is definitive. Reality is frequently inaccurate.}
+@author The Hitchhiker's Guide to the Galaxy
 @end quotation
 
 @c STARTOFRANGE comex
@@ -14263,8 +14263,8 @@ an array.
 @cindex Wall, Larry
 @quotation
 @i{Doing linear scans over an associative array is like trying to club someone
-to death with a loaded Uzi.}@*
-Larry Wall
+to death with a loaded Uzi.}
+@author Larry Wall
 @end quotation
 
 The @command{awk} language provides one-dimensional arrays
@@ -17447,8 +17447,8 @@ gawk 'BEGIN  @{
 @c STARTOFRANGE opbit
 @cindex operations, bitwise
 @quotation
-@i{I can explain it for you, but I can't understand it for you.}@*
-Anonymous
+@i{I can explain it for you, but I can't understand it for you.}
+@author Anonymous
 @end quotation
 
 Many languages provide the ability to perform @dfn{bitwise} operations
@@ -18887,9 +18887,9 @@ it allows you to encapsulate algorithms and program tasks in a single
 place.  It simplifies programming, making program development more
 manageable, and making programs more readable.
 
-In their seminal 1976 book, @cite{Software Tools}@footnote{Sadly, over 35
+In their seminal 1976 book, @cite{Software Tools},@footnote{Sadly, over 35
 years later, many of the lessons taught by this book have yet to be
-learned by a vast number of practicing programmers.}, Brian Kernighan
+learned by a vast number of practicing programmers.} Brian Kernighan
 and P.J.@: Plauger wrote:
 
 @quotation
@@ -23105,8 +23105,8 @@ word, comparing it to the previous one:
 @cindex insomnia, cure for
 @cindex Robbins, Arnold
 @quotation
-@i{Nothing cures insomnia like a ringing alarm clock.}@*
-Arnold Robbins
+@i{Nothing cures insomnia like a ringing alarm clock.}
+@author Arnold Robbins
 @end quotation
 
 @c STARTOFRANGE tialarm
@@ -23282,9 +23282,7 @@ often used to map uppercase letters into lowercase for further processing:
 
 @command{tr} requires two lists of characters.@footnote{On some older
 systems,
-@ifset ORA
 including Solaris,
-@end ifset
 @command{tr} may require that the lists be written as
 range expressions enclosed in square brackets (@samp{[a-z]}) and quoted,
 to prevent the shell from attempting a file name expansion.  This is
@@ -24925,8 +24923,8 @@ who knows where you live."
 @end ignore
 @quotation
 @i{Write documentation as if whoever reads it is
-a violent psychopath who knows where you live.}@*
-Steve English, as quoted by Peter Langston
+a violent psychopath who knows where you live.}
+@author Steve English, as quoted by Peter Langston
 @end quotation
 
 This @value{CHAPTER} discusses advanced features in @command{gawk}.
@@ -28073,11 +28071,11 @@ to believe. Novice computer users solve this problem by implicitly trusting
 in the computer as an infallible authority; they tend to believe that all
 digits of a printed answer are significant. Disillusioned computer users have
 just the opposite approach; they are constantly afraid that their answers
-are almost meaningless.}@*
-Donald Knuth@footnote{Donald E.@: Knuth.
+are almost meaningless.}@footnote{Donald E.@: Knuth.
 @cite{The Art of Computer Programming}. Volume 2,
 @cite{Seminumerical Algorithms}, third edition,
 1998, ISBN 0-201-89683-4, p.@: 229.}
+@author Donald Knuth
 @end quotation
 
 This @value{CHAPTER} discusses issues that you may encounter
@@ -29084,11 +29082,10 @@ floating-point format to a precision lower than working precision.
 Do we promote them to full membership of the high-precision club,
 or do we treat them and all their associates as second-class citizens?
 Sometimes the first course is proper, sometimes the second, and it takes
-careful analysis to tell which.}
-
-Dirk Laurie@footnote{Dirk Laurie.
+careful analysis to tell which.}@footnote{Dirk Laurie.
 @cite{Variable-precision Arithmetic Considered Perilous --- A Detective Story}.
 Electronic Transactions on Numerical Analysis. Volume 28, pp. 168-173, 2008.}
+@author Dirk Laurie
 @end quotation
 
 @command{gawk} does not implicitly modify the precision of any previously
@@ -29626,12 +29623,12 @@ the macros as if they were functions.
 @subsection General Purpose Data Types
 
 @quotation
-@i{I have a true love/hate relationship with unions.}@*
-Arnold Robbins
+@i{I have a true love/hate relationship with unions.}
+@author Arnold Robbins
 
 @i{That's the thing about unions: the compiler will arrange things so they
-can accommodate both love and hate.}@*
-Chet Ramey
+can accommodate both love and hate.}
+@author Chet Ramey
 @end quotation
 
 The extension API defines a number of simple types and structures for general
@@ -31564,8 +31561,8 @@ path with a list of directories to search for compiled extensions.
 @section Example: Some File Functions
 
 @quotation
-@i{No matter where you go, there you are.} @*
-Buckaroo Bonzai
+@i{No matter where you go, there you are.}
+@author Buckaroo Bonzai
 @end quotation
 
 @c It's enough to show chdir and stat, no need for fts
@@ -33721,8 +33718,8 @@ cases: the default regexp matching; with @option{--traditional}, and with
 @appendixsec Major Contributors to @command{gawk}
 @cindex @command{gawk}, list of contributors to
 @quotation
-@i{Always give credit where credit is due.}@*
-Anonymous
+@i{Always give credit where credit is due.}
+@author Anonymous
 @end quotation
 
 This @value{SECTION} names the major contributors to @command{gawk}
@@ -35026,8 +35023,8 @@ recommend compiling and using the current version.
 @appendixsec Reporting Problems and Bugs
 @cindex archeologists
 @quotation
-@i{There is nothing more dangerous than a bored archeologist.}@*
-The Hitchhiker's Guide to the Galaxy
+@i{There is nothing more dangerous than a bored archeologist.}
+@author The Hitchhiker's Guide to the Galaxy
 @end quotation
 @c the radio show, not the book. :-)
 
@@ -35143,8 +35140,8 @@ Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT)
 @cindex Brennan, Michael
 @quotation
 @i{It's kind of fun to put comments like this in your awk code.}@*
-@ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course}@*
-Michael Brennan
+@ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course}
+@author Michael Brennan
 @end quotation
 
 There are a number of other freely available @command{awk} implementations.
@@ -35938,11 +35935,11 @@ Larry
 @cindex Wall, Larry
 @cindex Robbins, Arnold
 @quotation
-@i{AWK is a language similar to PERL, only considerably more elegant.}@*
-Arnold Robbins
+@i{AWK is a language similar to PERL, only considerably more elegant.}
+@author Arnold Robbins
 
-@i{Hey!}@*
-Larry Wall
+@i{Hey!}
+@author Larry Wall
 @end quotation
 
 The @file{TODO} file in the @command{gawk} Git repository lists possible