Doc updates.

3 files changed, 84 insertions, 53 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 7613e26d..9e85baea 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2012-10-28         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawk.texi (Glossary): Document cookie, some cleanup of
+	notes at the end.
+
 2012-10-19         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.texi: More doc on SYMTAB.
diff --git a/doc/gawk.info b/doc/gawk.info
index b97acf46..5dd2f2dc 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -24062,6 +24062,10 @@ 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 Doug McIlroy.)
+
 Coprocess
      A subordinate program with which two-way communications is
      possible.
@@ -26343,7 +26347,7 @@ Index
 * Brian Kernighan's awk, extensions:     BTL.                 (line   6)
 * Broder, Alan J.:                       Contributors.        (line  88)
 * Brown, Martin:                         Contributors.        (line  82)
-* BSD-based operating systems:           Glossary.            (line 615)
+* BSD-based operating systems:           Glossary.            (line 619)
 * bt debugger command (alias for backtrace): Execution Stack. (line  13)
 * Buening, Andreas <1>:                  Bugs.                (line  71)
 * Buening, Andreas <2>:                  Contributors.        (line  92)
@@ -26468,7 +26472,7 @@ Index
 * compatibility mode (gawk), octal numbers: Nondecimal-numbers.
                                                               (line  60)
 * compatibility mode (gawk), specifying: Options.             (line  95)
-* compiled programs <1>:                 Glossary.            (line 161)
+* compiled programs <1>:                 Glossary.            (line 165)
 * compiled programs:                     Basic High Level.    (line  14)
 * compiling gawk for Cygwin:             Cygwin.              (line   6)
 * compiling gawk for MS-DOS and MS-Windows: PC Compiling.     (line  13)
@@ -26508,6 +26512,7 @@ Index
 * CONVFMT variable:                      Conversion.          (line  29)
 * CONVFMT variable, array subscripts and: Numeric Array Subscripts.
                                                               (line   6)
+* cookie:                                Glossary.            (line 157)
 * coprocesses <1>:                       Two-way I/O.         (line  44)
 * coprocesses:                           Redirection.         (line 102)
 * coprocesses, closing:                  Close Files And Pipes.
@@ -26526,7 +26531,7 @@ Index
 * cut.awk program:                       Cut Program.         (line  45)
 * d debugger command (alias for delete): Breakpoint Control.  (line  64)
 * d.c., See dark corner:                 Conventions.         (line  38)
-* dark corner <1>:                       Glossary.            (line 193)
+* dark corner <1>:                       Glossary.            (line 197)
 * dark corner <2>:                       Truth Values.        (line  24)
 * dark corner <3>:                       Assignment Ops.      (line 148)
 * dark corner:                           Conventions.         (line  38)
@@ -26835,7 +26840,7 @@ Index
 * endpwent() user-defined function:      Passwd Functions.    (line 213)
 * ENVIRON array:                         Auto-set.            (line  60)
 * environment variables:                 Auto-set.            (line  60)
-* epoch, definition of:                  Glossary.            (line 239)
+* epoch, definition of:                  Glossary.            (line 243)
 * equals sign (=), = operator:           Assignment Ops.      (line   6)
 * equals sign (=), == operator <1>:      Precedence.          (line  65)
 * equals sign (=), == operator:          Comparison Operators.
@@ -27054,10 +27059,10 @@ Index
 * frame debugger command:                Execution Stack.     (line  25)
 * Free Documentation License (FDL):      GNU Free Documentation License.
                                                               (line   6)
-* Free Software Foundation (FSF) <1>:    Glossary.            (line 301)
+* Free Software Foundation (FSF) <1>:    Glossary.            (line 305)
 * Free Software Foundation (FSF) <2>:    Getting.             (line  10)
 * Free Software Foundation (FSF):        Manual History.      (line   6)
-* FreeBSD:                               Glossary.            (line 615)
+* FreeBSD:                               Glossary.            (line 619)
 * FS variable <1>:                       User-modified.       (line  56)
 * FS variable:                           Field Separators.    (line  14)
 * FS variable, --field-separator option and: Options.         (line  21)
@@ -27070,7 +27075,7 @@ Index
                                                               (line   6)
 * FS, containing ^:                      Regexp Field Splitting.
                                                               (line  59)
-* FSF (Free Software Foundation) <1>:    Glossary.            (line 301)
+* FSF (Free Software Foundation) <1>:    Glossary.            (line 305)
 * FSF (Free Software Foundation) <2>:    Getting.             (line  10)
 * FSF (Free Software Foundation):        Manual History.      (line   6)
 * FUNCTAB array:                         Auto-set.            (line 119)
@@ -27218,7 +27223,7 @@ Index
 * gawk, VMS version of:                  VMS Installation.    (line   6)
 * gawk, word-boundary operator:          GNU Regexp Operators.
                                                               (line  63)
-* General Public License (GPL):          Glossary.            (line 310)
+* General Public License (GPL):          Glossary.            (line 314)
 * General Public License, See GPL:       Manual History.      (line  11)
 * gensub() function (gawk) <1>:          String Functions.    (line  86)
 * gensub() function (gawk):              Using Constant Regexps.
@@ -27267,17 +27272,17 @@ Index
 * GNU awk, See gawk:                     Preface.             (line  49)
 * GNU Free Documentation License:        GNU Free Documentation License.
                                                               (line   6)
-* GNU General Public License:            Glossary.            (line 310)
-* GNU Lesser General Public License:     Glossary.            (line 401)
+* GNU General Public License:            Glossary.            (line 314)
+* GNU Lesser General Public License:     Glossary.            (line 405)
 * GNU long options <1>:                  Options.             (line   6)
 * GNU long options:                      Command Line.        (line  13)
 * GNU long options, printing list of:    Options.             (line 168)
-* GNU Project <1>:                       Glossary.            (line 319)
+* GNU Project <1>:                       Glossary.            (line 323)
 * GNU Project:                           Manual History.      (line  11)
-* GNU/Linux <1>:                         Glossary.            (line 615)
+* GNU/Linux <1>:                         Glossary.            (line 619)
 * GNU/Linux <2>:                         I18N Example.        (line  55)
 * GNU/Linux:                             Manual History.      (line  28)
-* GPL (General Public License) <1>:      Glossary.            (line 310)
+* GPL (General Public License) <1>:      Glossary.            (line 314)
 * GPL (General Public License):          Manual History.      (line  11)
 * GPL (General Public License), printing: Options.            (line 102)
 * grcat program:                         Group Functions.     (line  16)
@@ -27400,19 +27405,19 @@ Index
 * internationalization, localization, portability and: I18N Portability.
                                                               (line   6)
 * internationalizing a program:          Explaining gettext.  (line   6)
-* interpreted programs <1>:              Glossary.            (line 361)
+* interpreted programs <1>:              Glossary.            (line 365)
 * interpreted programs:                  Basic High Level.    (line  14)
 * interval expressions:                  Regexp Operators.    (line 116)
 * inventory-shipped file:                Sample Data Files.   (line  32)
 * isarray() function (gawk):             Type Functions.      (line  11)
-* ISO:                                   Glossary.            (line 372)
+* ISO:                                   Glossary.            (line 376)
 * ISO 8859-1:                            Glossary.            (line 141)
 * ISO Latin-1:                           Glossary.            (line 141)
 * Jacobs, Andrew:                        Passwd Functions.    (line  90)
 * Jaegermann, Michal <1>:                Contributors.        (line  46)
 * Jaegermann, Michal:                    Acknowledgments.     (line  60)
 * Java implementation of awk:            Other Versions.      (line  97)
-* Java programming language:             Glossary.            (line 384)
+* Java programming language:             Glossary.            (line 388)
 * jawk:                                  Other Versions.      (line  97)
 * Jedi knights:                          Undocumented.        (line   6)
 * join() user-defined function:          Join Function.       (line  18)
@@ -27458,8 +27463,8 @@ Index
 * left shift, bitwise:                   Bitwise Functions.   (line  32)
 * leftmost longest match:                Multiple Line.       (line  26)
 * length() function:                     String Functions.    (line 166)
-* Lesser General Public License (LGPL):  Glossary.            (line 401)
-* LGPL (Lesser General Public License):  Glossary.            (line 401)
+* Lesser General Public License (LGPL):  Glossary.            (line 405)
+* LGPL (Lesser General Public License):  Glossary.            (line 405)
 * libmawk:                               Other Versions.      (line 105)
 * libraries of awk functions:            Library Functions.   (line   6)
 * libraries of awk functions, assertions: Assert Function.    (line   6)
@@ -27504,7 +27509,7 @@ Index
 * lint checking, undefined functions:    Pass By Value/Reference.
                                                               (line  88)
 * LINT variable:                         User-modified.       (line  98)
-* Linux <1>:                             Glossary.            (line 615)
+* Linux <1>:                             Glossary.            (line 619)
 * Linux <2>:                             I18N Example.        (line  55)
 * Linux:                                 Manual History.      (line  28)
 * list debugger command:                 Miscellaneous Debugger Commands.
@@ -27574,7 +27579,7 @@ Index
 * namespace issues, functions:           Definition Syntax.   (line  20)
 * nawk utility:                          Names.               (line  17)
 * negative zero:                         Unexpected Results.  (line  34)
-* NetBSD:                                Glossary.            (line 615)
+* NetBSD:                                Glossary.            (line 619)
 * networks, programming:                 TCP/IP Networking.   (line   6)
 * networks, support for:                 Special Network.     (line   6)
 * newlines <1>:                          Boolean Ops.         (line  67)
@@ -27660,7 +27665,7 @@ Index
 * OFS variable <1>:                      User-modified.       (line 124)
 * OFS variable <2>:                      Output Separators.   (line   6)
 * OFS variable:                          Changing Fields.     (line  64)
-* OpenBSD:                               Glossary.            (line 615)
+* OpenBSD:                               Glossary.            (line 619)
 * OpenSolaris:                           Other Versions.      (line  87)
 * operating systems, BSD-based:          Manual History.      (line  28)
 * operating systems, PC, gawk on:        PC Using.            (line   6)
@@ -27729,8 +27734,8 @@ Index
 * output, standard:                      Special FD.          (line   6)
 * p debugger command (alias for print):  Viewing And Changing Data.
                                                               (line  36)
-* P1003.1 POSIX standard:                Glossary.            (line 458)
-* P1003.2 POSIX standard:                Glossary.            (line 458)
+* P1003.1 POSIX standard:                Glossary.            (line 462)
+* P1003.2 POSIX standard:                Glossary.            (line 462)
 * parentheses () <1>:                    Profiling.           (line 138)
 * parentheses ():                        Regexp Operators.    (line  79)
 * password file:                         Passwd Functions.    (line  16)
@@ -27922,7 +27927,7 @@ Index
 * Programming languages, Ada:            Glossary.            (line  20)
 * programming languages, data-driven vs. procedural: Getting Started.
                                                               (line  12)
-* Programming languages, Java:           Glossary.            (line 384)
+* Programming languages, Java:           Glossary.            (line 388)
 * programming, basic steps:              Basic High Level.    (line  19)
 * programming, concepts:                 Basic Concepts.      (line   6)
 * pwcat program:                         Passwd Functions.    (line  23)
@@ -28201,7 +28206,7 @@ Index
 * sqrt() function:                       Numeric Functions.   (line  78)
 * square brackets ([]):                  Regexp Operators.    (line  55)
 * srand() function:                      Numeric Functions.   (line  82)
-* Stallman, Richard <1>:                 Glossary.            (line 301)
+* Stallman, Richard <1>:                 Glossary.            (line 305)
 * Stallman, Richard <2>:                 Contributors.        (line  24)
 * Stallman, Richard <3>:                 Acknowledgments.     (line  18)
 * Stallman, Richard:                     Manual History.      (line   6)
@@ -28373,7 +28378,7 @@ Index
                                                               (line   6)
 * uniq utility:                          Uniq Program.        (line   6)
 * uniq.awk program:                      Uniq Program.        (line  65)
-* Unix:                                  Glossary.            (line 615)
+* Unix:                                  Glossary.            (line 619)
 * Unix awk, backslashes in escape sequences: Escape Sequences.
                                                               (line 125)
 * Unix awk, close() function and:        Close Files And Pipes.
@@ -28952,8 +28957,8 @@ Node: Basic High Level953475
 Ref: Basic High Level-Footnote-1957510
 Node: Basic Data Typing957695
 Node: Glossary961050
-Node: Copying986225
-Node: GNU Free Documentation License1023782
-Node: Index1048919
+Node: Copying986361
+Node: GNU Free Documentation License1023918
+Node: Index1049055
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 2da2a246..09700111 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -20,7 +20,7 @@
 @c applies to and all the info about who's publishing this edition
 
 @c These apply across the board.
-@set UPDATE-MONTH February, 2012
+@set UPDATE-MONTH October, 2012
 @set VERSION 4.0
 @set PATCHLEVEL 1
 
@@ -31880,6 +31880,50 @@ 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}.
 
+@cindex cookie
+@item Cookie
+A peculiar goodie, token, saying or remembrance
+produced by or presented to a program. (With thanks to Doug McIlroy.)
+@ignore
+From: Doug McIlroy <doug@cs.dartmouth.edu>
+Date: Sat, 13 Oct 2012 19:55:25 -0400
+To: arnold@skeeve.com
+Subject: Re: origin of the term "cookie"?
+
+I believe the term "cookie", for a more or less inscrutable
+saying or crumb of information, was injected into Unix
+jargon by Bob Morris, who used the word quite frequently.
+It had no fixed meaning as it now does in browsers.
+
+The word had been around long before it was recognized in
+the 8th edition glossary (earlier editions had no glossary):
+
+cookie   a peculiar goodie, token, saying or remembrance
+returned by or presented to a program. [I would say that
+"returned by" would better read "produced by", and assume
+responsibility for the inexactitude.]
+
+Doug McIlroy
+
+From: Doug McIlroy <doug@cs.dartmouth.edu>
+Date: Sun, 14 Oct 2012 10:08:43 -0400
+To: arnold@skeeve.com
+Subject: Re: origin of the term "cookie"?
+
+> Can I forward your email to Eric Raymond, for possible addition to the
+> Jargon File?
+
+Sure. I might add that I don't know how "cookie" entered Morris's
+vocabulary. Certainly "values of beta give rise to dom!" (see google)
+was an early, if not the earliest Unix cookie.  The fact that it was
+found lying around on a model 37 teletype (which had Greek beta in
+its type box) suggests that maybe it was seen to be like milk and
+cookies laid out for Santa Claus. Morris was wont to make such
+connections.
+
+Doug
+@end ignore
+
 @item Coprocess
 A subordinate program with which two-way communications is possible.
 
@@ -33664,9 +33708,6 @@ Unresolved Issues:
    of how to use them.  It would be useful to perhaps have a "programming
    style" section of the manual that would include this and other tips.
 
-2. The default AWKPATH search path should be configurable via `configure'
-   The default and how this changes needs to be documented.
-
 Consistency issues:
 	/.../ regexps are in @code, not @samp
 	".." strings are in @code, not @samp
@@ -33765,23 +33806,3 @@ Suggestions:
 %	1. Standardize the error messages from the functions and programs
 %	   in Chapters 12 and 13.
 %	2. Nuke the BBS stuff and use something that won't be obsolete
-
-From: Doug McIlroy <doug@cs.dartmouth.edu>
-Date: Sat, 13 Oct 2012 19:55:25 -0400
-To: arnold@skeeve.com
-Subject: Re: origin of the term "cookie"?
-
-I believe the term "cookie", for a more or less inscrutable
-saying or crumb of information, was injected into Unix
-jargon by Bob Morris, who used the word quite frequently.
-It had no fixed meaning as it now does in browsers.
-
-The word had been around long before it was recognized in
-the 8th edition glossary (earlier editions had no glossary):
-
-cookie   a peculiar goodie, token, saying or remembrance
-returned by or presented to a program. [I would say that
-"returned by" would better read "produced by", and assume
-responsibility for the inexactitude.]
-
-Doug McIlroy