diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 63 | ||||
| -rw-r--r-- | doc/gawk.texi | 69 |
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 |