Merge branch 'gawk-4.1-stable'

4 files changed, 142 insertions, 138 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index e6b14381..19278667 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,8 +1,12 @@
+2014-12-26         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+	* gawktexi.in (Glossary): Really sort the items.
+
 2014-12-24         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: Add one more paragraph to new foreword.
 	* gawktexi.in: Fix exponentiation in TeX mode. Thanks to
-	Marco Curreli by way of Antonio Giovanni.
+	Marco Curreli by way of Antonio Giovanni Columbo.
 
 	* texinfo.tex: Updated.
 
diff --git a/doc/gawk.info b/doc/gawk.info
index 37494e64..e501b297 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -29695,13 +29695,11 @@ CHEM
      Brian Kernighan and Jon Bentley, and is available from
      `http://netlib.sandia.gov/netlib/typesetting/chem.gz'.
 
-Cookie
-     A peculiar goodie, token, saying or remembrance produced by or
-     presented to a program. (With thanks to Professor Doug McIlroy.)
-
-Coprocess
-     A subordinate program with which two-way communications is
-     possible.
+Comparison Expression
+     A relation that is either true or false, such as `a < b'.
+     Comparison expressions are used in `if', `while', `do', and `for'
+     statements, and in patterns to select which input records to
+     process.  (*Note Typing and Comparison::.)
 
 Compiler
      A program that translates human-readable source code into
@@ -29725,11 +29723,13 @@ Conditional Expression
      otherwise the value is EXPR3.  In either case, only one of EXPR2
      and EXPR3 is evaluated. (*Note Conditional Exp::.)
 
-Comparison Expression
-     A relation that is either true or false, such as `a < b'.
-     Comparison expressions are used in `if', `while', `do', and `for'
-     statements, and in patterns to select which input records to
-     process.  (*Note Typing and Comparison::.)
+Cookie
+     A peculiar goodie, token, saying or remembrance produced by or
+     presented to a program. (With thanks to Professor Doug McIlroy.)
+
+Coprocess
+     A subordinate program with which two-way communications is
+     possible.
 
 Curly Braces
      See "Braces."
@@ -29771,15 +29771,15 @@ Dynamic Regular Expression
      `"foo"', but it may also be an expression whose value can vary.
      (*Note Computed Regexps::.)
 
+Empty String
+     See "Null String."
+
 Environment
      A collection of strings, of the form `NAME=VAL', that each program
      has available to it. Users generally place values into the
      environment in order to provide information to various programs.
      Typical examples are the environment variables `HOME' and `PATH'.
 
-Empty String
-     See "Null String."
-
 Epoch
      The date used as the "beginning of time" for timestamps.  Time
      values in most systems are represented as seconds since the epoch,
@@ -29834,20 +29834,20 @@ Free Documentation License
      published and may be copied. (*Note GNU Free Documentation
      License::.)
 
-Function
-     A specialized group of statements used to encapsulate general or
-     program-specific tasks.  `awk' has a number of built-in functions,
-     and also allows you to define your own.  (*Note Functions::.)
-
-FSF
-     See "Free Software Foundation."
-
 Free Software Foundation
      A nonprofit organization dedicated to the production and
      distribution of freely distributable software.  It was founded by
      Richard M. Stallman, the author of the original Emacs editor.  GNU
      Emacs is the most widely used version of Emacs today.
 
+FSF
+     See "Free Software Foundation."
+
+Function
+     A specialized group of statements used to encapsulate general or
+     program-specific tasks.  `awk' has a number of built-in functions,
+     and also allows you to define your own.  (*Note Functions::.)
+
 `gawk'
      The GNU implementation of `awk'.
 
@@ -29947,12 +29947,12 @@ Lesser General Public License
      archives or shared objects, and their source code may be
      distributed.
 
-Linux
-     See "GNU/Linux."
-
 LGPL
      See "Lesser General Public License."
 
+Linux
+     See "GNU/Linux."
+
 Localization
      The process of providing the data necessary for an
      internationalized program to work in a particular language.
@@ -30091,13 +30091,13 @@ Search Path
      source files.  In the shell, a list of directories to search for
      executable programs.
 
+`sed'
+     See "Stream Editor."
+
 Seed
      The initial value, or starting point, for a sequence of random
      numbers.
 
-`sed'
-     See "Stream Editor."
-
 Shell
      The command interpreter for Unix and POSIX-compliant systems.  The
      shell works both interactively, and as a programming language for
@@ -32156,7 +32156,7 @@ Index
 * compatibility mode (gawk), octal numbers: Nondecimal-numbers.
                                                               (line  60)
 * compatibility mode (gawk), specifying: Options.             (line  81)
-* compiled programs <1>:                 Glossary.            (line 157)
+* compiled programs <1>:                 Glossary.            (line 155)
 * compiled programs:                     Basic High Level.    (line  15)
 * compiling gawk for Cygwin:             Cygwin.              (line   6)
 * compiling gawk for MS-DOS and MS-Windows: PC Compiling.     (line  13)
@@ -32202,7 +32202,7 @@ Index
 * CONVFMT variable:                      Strings And Numbers. (line  29)
 * CONVFMT variable, and array subscripts: Numeric Array Subscripts.
                                                               (line   6)
-* cookie:                                Glossary.            (line 149)
+* cookie:                                Glossary.            (line 177)
 * coprocesses <1>:                       Two-way I/O.         (line  25)
 * coprocesses:                           Redirection.         (line  96)
 * coprocesses, closing:                  Close Files And Pipes.
@@ -32819,7 +32819,7 @@ Index
 * frame debugger command:                Execution Stack.     (line  27)
 * Free Documentation License (FDL):      GNU Free Documentation License.
                                                               (line   7)
-* Free Software Foundation (FSF) <1>:    Glossary.            (line 296)
+* Free Software Foundation (FSF) <1>:    Glossary.            (line 288)
 * Free Software Foundation (FSF) <2>:    Getting.             (line  10)
 * Free Software Foundation (FSF):        Manual History.      (line   6)
 * FreeBSD:                               Glossary.            (line 611)
@@ -32836,7 +32836,7 @@ Index
 * FS, containing ^:                      Regexp Field Splitting.
                                                               (line  59)
 * FS, in multiline records:              Multiple Line.       (line  41)
-* FSF (Free Software Foundation) <1>:    Glossary.            (line 296)
+* FSF (Free Software Foundation) <1>:    Glossary.            (line 288)
 * FSF (Free Software Foundation) <2>:    Getting.             (line  10)
 * FSF (Free Software Foundation):        Manual History.      (line   6)
 * fts() extension function:              Extension Sample File Functions.
@@ -33361,7 +33361,7 @@ Index
 * mawk utility <4>:                      Getline/Pipe.        (line  62)
 * mawk utility:                          Escape Sequences.    (line 120)
 * maximum precision supported by MPFR library: Auto-set.      (line 235)
-* McIlroy, Doug:                         Glossary.            (line 149)
+* McIlroy, Doug:                         Glossary.            (line 177)
 * McPhee, Patrick:                       Contributors.        (line 100)
 * message object files:                  Explaining gettext.  (line  42)
 * message object files, converting from portable object files: I18N Example.
@@ -34112,7 +34112,7 @@ Index
 * square root:                           Numeric Functions.   (line  92)
 * srand:                                 Numeric Functions.   (line  96)
 * stack frame:                           Debugging Terms.     (line  10)
-* Stallman, Richard <1>:                 Glossary.            (line 296)
+* Stallman, Richard <1>:                 Glossary.            (line 288)
 * Stallman, Richard <2>:                 Contributors.        (line  23)
 * Stallman, Richard <3>:                 Acknowledgments.     (line  18)
 * Stallman, Richard:                     Manual History.      (line   6)
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 1c3c0f78..57c37746 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -40308,6 +40308,39 @@ It was written in @command{awk}
 by Brian Kernighan and Jon Bentley, and is available from
 @uref{http://netlib.sandia.gov/netlib/typesetting/chem.gz}.
 
+@item Comparison Expression
+A relation that is either true or false, such as @samp{a < b}.
+Comparison expressions are used in @code{if}, @code{while}, @code{do},
+and @code{for}
+statements, and in patterns to select which input records to process.
+(@xref{Typing and Comparison}.)
+
+@cindex compiled programs
+@item Compiler
+A program that translates human-readable source code into
+machine-executable object code.  The object code is then executed
+directly by the computer.
+See also ``Interpreter.''
+
+@item Compound Statement
+A series of @command{awk} statements, enclosed in curly braces.  Compound
+statements may be nested.
+(@xref{Statements}.)
+
+@item Concatenation
+Concatenating two strings means sticking them together, one after another,
+producing a new string.  For example, the string @samp{foo} concatenated with
+the string @samp{bar} gives the string @samp{foobar}.
+(@xref{Concatenation}.)
+
+@item Conditional Expression
+An expression using the @samp{?:} ternary operator, such as
+@samp{@var{expr1} ? @var{expr2} : @var{expr3}}.  The expression
+@var{expr1} is evaluated; if the result is true, the value of the whole
+expression is the value of @var{expr2}; otherwise the value is
+@var{expr3}.  In either case, only one of @var{expr2} and @var{expr3}
+is evaluated. (@xref{Conditional Exp}.)
+
 @cindex McIlroy, Doug
 @cindex cookie
 @item Cookie
@@ -40356,39 +40389,6 @@ Doug
 @item Coprocess
 A subordinate program with which two-way communications is possible.
 
-@cindex compiled programs
-@item Compiler
-A program that translates human-readable source code into
-machine-executable object code.  The object code is then executed
-directly by the computer.
-See also ``Interpreter.''
-
-@item Compound Statement
-A series of @command{awk} statements, enclosed in curly braces.  Compound
-statements may be nested.
-(@xref{Statements}.)
-
-@item Concatenation
-Concatenating two strings means sticking them together, one after another,
-producing a new string.  For example, the string @samp{foo} concatenated with
-the string @samp{bar} gives the string @samp{foobar}.
-(@xref{Concatenation}.)
-
-@item Conditional Expression
-An expression using the @samp{?:} ternary operator, such as
-@samp{@var{expr1} ? @var{expr2} : @var{expr3}}.  The expression
-@var{expr1} is evaluated; if the result is true, the value of the whole
-expression is the value of @var{expr2}; otherwise the value is
-@var{expr3}.  In either case, only one of @var{expr2} and @var{expr3}
-is evaluated. (@xref{Conditional Exp}.)
-
-@item Comparison Expression
-A relation that is either true or false, such as @samp{a < b}.
-Comparison expressions are used in @code{if}, @code{while}, @code{do},
-and @code{for}
-statements, and in patterns to select which input records to process.
-(@xref{Typing and Comparison}.)
-
 @item Curly Braces
 See ``Braces.''
 
@@ -40434,15 +40434,15 @@ ordinary expression.  It could be a string constant, such as
 @code{"foo"}, but it may also be an expression whose value can vary.
 (@xref{Computed Regexps}.)
 
+@item Empty String
+See ``Null String.''
+
 @item Environment
 A collection of strings, of the form @samp{@var{name}=@var{val}}, that each
 program has available to it. Users generally place values into the
 environment in order to provide information to various programs. Typical
 examples are the environment variables @env{HOME} and @env{PATH}.
 
-@item Empty String
-See ``Null String.''
-
 @cindex epoch, definition of
 @item Epoch
 The date used as the ``beginning of time'' for timestamps.
@@ -40499,15 +40499,6 @@ are controlled by the format strings contained in the predefined variables
 This document describes the terms under which this @value{DOCUMENT}
 is published and may be copied. (@xref{GNU Free Documentation License}.)
 
-@item Function
-A specialized group of statements used to encapsulate general
-or program-specific tasks.  @command{awk} has a number of built-in
-functions, and also allows you to define your own.
-(@xref{Functions}.)
-
-@item FSF
-See ``Free Software Foundation.''
-
 @cindex FSF (Free Software Foundation)
 @cindex Free Software Foundation (FSF)
 @cindex Stallman, Richard
@@ -40517,6 +40508,15 @@ to the production and distribution of freely distributable software.
 It was founded by Richard M.@: Stallman, the author of the original
 Emacs editor.  GNU Emacs is the most widely used version of Emacs today.
 
+@item FSF
+See ``Free Software Foundation.''
+
+@item Function
+A specialized group of statements used to encapsulate general
+or program-specific tasks.  @command{awk} has a number of built-in
+functions, and also allows you to define your own.
+(@xref{Functions}.)
+
 @item @command{gawk}
 The GNU implementation of @command{awk}.
 
@@ -40647,12 +40647,12 @@ This document describes the terms under which binary library archives
 or shared objects,
 and their source code may be distributed.
 
-@item Linux
-See ``GNU/Linux.''
-
 @item LGPL
 See ``Lesser General Public License.''
 
+@item Linux
+See ``GNU/Linux.''
+
 @item Localization
 The process of providing the data necessary for an
 internationalized program to work in a particular language.
@@ -40790,12 +40790,12 @@ Regular variables are scalars; arrays and functions are not.
 In @command{gawk}, a list of directories to search for @command{awk} program source files.
 In the shell, a list of directories to search for executable programs.
 
-@item Seed
-The initial value, or starting point, for a sequence of random numbers.
-
 @item @command{sed}
 See ``Stream Editor.''
 
+@item Seed
+The initial value, or starting point, for a sequence of random numbers.
+
 @item Shell
 The command interpreter for Unix and POSIX-compliant systems.
 The shell works both interactively, and as a programming language
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 8bdf1a70..b850dd15 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -39401,6 +39401,39 @@ It was written in @command{awk}
 by Brian Kernighan and Jon Bentley, and is available from
 @uref{http://netlib.sandia.gov/netlib/typesetting/chem.gz}.
 
+@item Comparison Expression
+A relation that is either true or false, such as @samp{a < b}.
+Comparison expressions are used in @code{if}, @code{while}, @code{do},
+and @code{for}
+statements, and in patterns to select which input records to process.
+(@xref{Typing and Comparison}.)
+
+@cindex compiled programs
+@item Compiler
+A program that translates human-readable source code into
+machine-executable object code.  The object code is then executed
+directly by the computer.
+See also ``Interpreter.''
+
+@item Compound Statement
+A series of @command{awk} statements, enclosed in curly braces.  Compound
+statements may be nested.
+(@xref{Statements}.)
+
+@item Concatenation
+Concatenating two strings means sticking them together, one after another,
+producing a new string.  For example, the string @samp{foo} concatenated with
+the string @samp{bar} gives the string @samp{foobar}.
+(@xref{Concatenation}.)
+
+@item Conditional Expression
+An expression using the @samp{?:} ternary operator, such as
+@samp{@var{expr1} ? @var{expr2} : @var{expr3}}.  The expression
+@var{expr1} is evaluated; if the result is true, the value of the whole
+expression is the value of @var{expr2}; otherwise the value is
+@var{expr3}.  In either case, only one of @var{expr2} and @var{expr3}
+is evaluated. (@xref{Conditional Exp}.)
+
 @cindex McIlroy, Doug
 @cindex cookie
 @item Cookie
@@ -39449,39 +39482,6 @@ Doug
 @item Coprocess
 A subordinate program with which two-way communications is possible.
 
-@cindex compiled programs
-@item Compiler
-A program that translates human-readable source code into
-machine-executable object code.  The object code is then executed
-directly by the computer.
-See also ``Interpreter.''
-
-@item Compound Statement
-A series of @command{awk} statements, enclosed in curly braces.  Compound
-statements may be nested.
-(@xref{Statements}.)
-
-@item Concatenation
-Concatenating two strings means sticking them together, one after another,
-producing a new string.  For example, the string @samp{foo} concatenated with
-the string @samp{bar} gives the string @samp{foobar}.
-(@xref{Concatenation}.)
-
-@item Conditional Expression
-An expression using the @samp{?:} ternary operator, such as
-@samp{@var{expr1} ? @var{expr2} : @var{expr3}}.  The expression
-@var{expr1} is evaluated; if the result is true, the value of the whole
-expression is the value of @var{expr2}; otherwise the value is
-@var{expr3}.  In either case, only one of @var{expr2} and @var{expr3}
-is evaluated. (@xref{Conditional Exp}.)
-
-@item Comparison Expression
-A relation that is either true or false, such as @samp{a < b}.
-Comparison expressions are used in @code{if}, @code{while}, @code{do},
-and @code{for}
-statements, and in patterns to select which input records to process.
-(@xref{Typing and Comparison}.)
-
 @item Curly Braces
 See ``Braces.''
 
@@ -39527,15 +39527,15 @@ ordinary expression.  It could be a string constant, such as
 @code{"foo"}, but it may also be an expression whose value can vary.
 (@xref{Computed Regexps}.)
 
+@item Empty String
+See ``Null String.''
+
 @item Environment
 A collection of strings, of the form @samp{@var{name}=@var{val}}, that each
 program has available to it. Users generally place values into the
 environment in order to provide information to various programs. Typical
 examples are the environment variables @env{HOME} and @env{PATH}.
 
-@item Empty String
-See ``Null String.''
-
 @cindex epoch, definition of
 @item Epoch
 The date used as the ``beginning of time'' for timestamps.
@@ -39592,15 +39592,6 @@ are controlled by the format strings contained in the predefined variables
 This document describes the terms under which this @value{DOCUMENT}
 is published and may be copied. (@xref{GNU Free Documentation License}.)
 
-@item Function
-A specialized group of statements used to encapsulate general
-or program-specific tasks.  @command{awk} has a number of built-in
-functions, and also allows you to define your own.
-(@xref{Functions}.)
-
-@item FSF
-See ``Free Software Foundation.''
-
 @cindex FSF (Free Software Foundation)
 @cindex Free Software Foundation (FSF)
 @cindex Stallman, Richard
@@ -39610,6 +39601,15 @@ to the production and distribution of freely distributable software.
 It was founded by Richard M.@: Stallman, the author of the original
 Emacs editor.  GNU Emacs is the most widely used version of Emacs today.
 
+@item FSF
+See ``Free Software Foundation.''
+
+@item Function
+A specialized group of statements used to encapsulate general
+or program-specific tasks.  @command{awk} has a number of built-in
+functions, and also allows you to define your own.
+(@xref{Functions}.)
+
 @item @command{gawk}
 The GNU implementation of @command{awk}.
 
@@ -39740,12 +39740,12 @@ This document describes the terms under which binary library archives
 or shared objects,
 and their source code may be distributed.
 
-@item Linux
-See ``GNU/Linux.''
-
 @item LGPL
 See ``Lesser General Public License.''
 
+@item Linux
+See ``GNU/Linux.''
+
 @item Localization
 The process of providing the data necessary for an
 internationalized program to work in a particular language.
@@ -39883,12 +39883,12 @@ Regular variables are scalars; arrays and functions are not.
 In @command{gawk}, a list of directories to search for @command{awk} program source files.
 In the shell, a list of directories to search for executable programs.
 
-@item Seed
-The initial value, or starting point, for a sequence of random numbers.
-
 @item @command{sed}
 See ``Stream Editor.''
 
+@item Seed
+The initial value, or starting point, for a sequence of random numbers.
+
 @item Shell
 The command interpreter for Unix and POSIX-compliant systems.
 The shell works both interactively, and as a programming language