Doc fixes.

5 files changed, 543 insertions, 534 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index d97f31ca..c651be7c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2014-10-28         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawk.1: Clarification that debugger reads stdin.
+	* gawktexi.in: Ditto, and correctly place the "Braces" entry in
+	the Glossary. Thanks to Antonio Colombo for that.
+
 2014-10-25         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: Minor typo fixes.
diff --git a/doc/gawk.1 b/doc/gawk.1
index df31a5f2..0a37d5a8 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -231,7 +231,8 @@ and so on.)
 .PD
 \fB\-\^\-debug\fR[\fB=\fIfile\fR]
 Enable debugging of \*(AK programs.
-By default, the debugger reads commands interactively from the terminal.
+By default, the debugger reads commands interactively from the keyboard
+(standard input).
 The optional
 .IR file
 argument specifies a file with a list
diff --git a/doc/gawk.info b/doc/gawk.info
index 0583554f..6b851441 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -2501,10 +2501,10 @@ The following list describes options mandated by the POSIX standard:
 `--debug'[`='FILE]
      Enable debugging of `awk' programs (*note Debugging::).  By
      default, the debugger reads commands interactively from the
-     keyboard.  The optional FILE argument allows you to specify a file
-     with a list of commands for the debugger to execute
-     non-interactively.  No space is allowed between the `-D' and FILE,
-     if FILE is supplied.
+     keyboard (standard input).  The optional FILE argument allows you
+     to specify a file with a list of commands for the debugger to
+     execute non-interactively.  No space is allowed between the `-D'
+     and FILE, if FILE is supplied.
 
 `-e' PROGRAM-TEXT
 `--source' PROGRAM-TEXT
@@ -29479,6 +29479,10 @@ Bourne Shell
      shells (Bash, `ksh', `pdksh', `zsh') are generally upwardly
      compatible with the Bourne shell.
 
+Braces
+     The characters `{' and `}'.  Braces are used in `awk' for
+     delimiting actions, compound statements, and function bodies.
+
 Built-in Function
      The `awk' language provides built-in functions that perform various
      numerical, I/O-related, and string computations.  Examples are
@@ -29497,10 +29501,6 @@ Built-in Variable
      them affects `awk''s running environment.  (*Note Built-in
      Variables::.)
 
-Braces
-     The characters `{' and `}'.  Braces are used in `awk' for
-     delimiting actions, compound statements, and function bodies.
-
 C
      The system programming language that most GNU software is written
      in.  The `awk' programming language has C-like syntax, and this
@@ -34325,518 +34325,518 @@ Node: Intro Summary111987
 Node: Invoking Gawk112870
 Node: Command Line114385
 Node: Options115176
-Ref: Options-Footnote-1131071
-Node: Other Arguments131096
-Node: Naming Standard Input134057
-Node: Environment Variables135150
-Node: AWKPATH Variable135708
-Ref: AWKPATH Variable-Footnote-1139008
-Ref: AWKPATH Variable-Footnote-2139053
-Node: AWKLIBPATH Variable139313
-Node: Other Environment Variables140456
-Node: Exit Status144176
-Node: Include Files144851
-Node: Loading Shared Libraries148439
-Node: Obsolete149866
-Node: Undocumented150563
-Node: Invoking Summary150830
-Node: Regexp152496
-Node: Regexp Usage153955
-Node: Escape Sequences155988
-Node: Regexp Operators162005
-Ref: Regexp Operators-Footnote-1169439
-Ref: Regexp Operators-Footnote-2169586
-Node: Bracket Expressions169684
-Ref: table-char-classes171701
-Node: Leftmost Longest174641
-Node: Computed Regexps175943
-Node: GNU Regexp Operators179340
-Node: Case-sensitivity183042
-Ref: Case-sensitivity-Footnote-1185932
-Ref: Case-sensitivity-Footnote-2186167
-Node: Regexp Summary186275
-Node: Reading Files187744
-Node: Records189838
-Node: awk split records190570
-Node: gawk split records195484
-Ref: gawk split records-Footnote-1200023
-Node: Fields200060
-Ref: Fields-Footnote-1202858
-Node: Nonconstant Fields202944
-Ref: Nonconstant Fields-Footnote-1205180
-Node: Changing Fields205382
-Node: Field Separators211314
-Node: Default Field Splitting214018
-Node: Regexp Field Splitting215135
-Node: Single Character Fields218485
-Node: Command Line Field Separator219544
-Node: Full Line Fields222756
-Ref: Full Line Fields-Footnote-1223264
-Node: Field Splitting Summary223310
-Ref: Field Splitting Summary-Footnote-1226441
-Node: Constant Size226542
-Node: Splitting By Content231148
-Ref: Splitting By Content-Footnote-1235221
-Node: Multiple Line235261
-Ref: Multiple Line-Footnote-1241150
-Node: Getline241329
-Node: Plain Getline243540
-Node: Getline/Variable246180
-Node: Getline/File247327
-Node: Getline/Variable/File248711
-Ref: Getline/Variable/File-Footnote-1250312
-Node: Getline/Pipe250399
-Node: Getline/Variable/Pipe253082
-Node: Getline/Coprocess254213
-Node: Getline/Variable/Coprocess255465
-Node: Getline Notes256204
-Node: Getline Summary258996
-Ref: table-getline-variants259408
-Node: Read Timeout260237
-Ref: Read Timeout-Footnote-1264051
-Node: Command-line directories264109
-Node: Input Summary265013
-Node: Input Exercises268265
-Node: Printing268993
-Node: Print270770
-Node: Print Examples272227
-Node: Output Separators275006
-Node: OFMT277024
-Node: Printf278378
-Node: Basic Printf279163
-Node: Control Letters280734
-Node: Format Modifiers284718
-Node: Printf Examples290725
-Node: Redirection293207
-Node: Special FD300046
-Ref: Special FD-Footnote-1303203
-Node: Special Files303277
-Node: Other Inherited Files303893
-Node: Special Network304893
-Node: Special Caveats305754
-Node: Close Files And Pipes306705
-Ref: Close Files And Pipes-Footnote-1313884
-Ref: Close Files And Pipes-Footnote-2314032
-Node: Output Summary314182
-Node: Output Exercises315178
-Node: Expressions315858
-Node: Values317043
-Node: Constants317719
-Node: Scalar Constants318399
-Ref: Scalar Constants-Footnote-1319258
-Node: Nondecimal-numbers319508
-Node: Regexp Constants322508
-Node: Using Constant Regexps323033
-Node: Variables326171
-Node: Using Variables326826
-Node: Assignment Options328736
-Node: Conversion330611
-Node: Strings And Numbers331135
-Ref: Strings And Numbers-Footnote-1334199
-Node: Locale influences conversions334308
-Ref: table-locale-affects337053
-Node: All Operators337641
-Node: Arithmetic Ops338271
-Node: Concatenation340776
-Ref: Concatenation-Footnote-1343595
-Node: Assignment Ops343701
-Ref: table-assign-ops348684
-Node: Increment Ops349962
-Node: Truth Values and Conditions353400
-Node: Truth Values354483
-Node: Typing and Comparison355532
-Node: Variable Typing356325
-Node: Comparison Operators359977
-Ref: table-relational-ops360387
-Node: POSIX String Comparison363902
-Ref: POSIX String Comparison-Footnote-1364974
-Node: Boolean Ops365112
-Ref: Boolean Ops-Footnote-1369591
-Node: Conditional Exp369682
-Node: Function Calls371409
-Node: Precedence375289
-Node: Locales378957
-Node: Expressions Summary380588
-Node: Patterns and Actions383162
-Node: Pattern Overview384282
-Node: Regexp Patterns385961
-Node: Expression Patterns386504
-Node: Ranges390284
-Node: BEGIN/END393390
-Node: Using BEGIN/END394152
-Ref: Using BEGIN/END-Footnote-1396889
-Node: I/O And BEGIN/END396995
-Node: BEGINFILE/ENDFILE399309
-Node: Empty402210
-Node: Using Shell Variables402527
-Node: Action Overview404803
-Node: Statements407130
-Node: If Statement408978
-Node: While Statement410476
-Node: Do Statement412504
-Node: For Statement413646
-Node: Switch Statement416801
-Node: Break Statement419189
-Node: Continue Statement421230
-Node: Next Statement423055
-Node: Nextfile Statement425435
-Node: Exit Statement428065
-Node: Built-in Variables430468
-Node: User-modified431601
-Ref: User-modified-Footnote-1439281
-Node: Auto-set439343
-Ref: Auto-set-Footnote-1452373
-Ref: Auto-set-Footnote-2452578
-Node: ARGC and ARGV452634
-Node: Pattern Action Summary456838
-Node: Arrays459265
-Node: Array Basics460594
-Node: Array Intro461438
-Ref: figure-array-elements463402
-Ref: Array Intro-Footnote-1465926
-Node: Reference to Elements466054
-Node: Assigning Elements468504
-Node: Array Example468995
-Node: Scanning an Array470753
-Node: Controlling Scanning473769
-Ref: Controlling Scanning-Footnote-1478958
-Node: Numeric Array Subscripts479274
-Node: Uninitialized Subscripts481459
-Node: Delete483076
-Ref: Delete-Footnote-1485820
-Node: Multidimensional485877
-Node: Multiscanning488972
-Node: Arrays of Arrays490561
-Node: Arrays Summary495322
-Node: Functions497427
-Node: Built-in498300
-Node: Calling Built-in499378
-Node: Numeric Functions501366
-Ref: Numeric Functions-Footnote-1505388
-Ref: Numeric Functions-Footnote-2505745
-Ref: Numeric Functions-Footnote-3505793
-Node: String Functions506062
-Ref: String Functions-Footnote-1529534
-Ref: String Functions-Footnote-2529663
-Ref: String Functions-Footnote-3529911
-Node: Gory Details529998
-Ref: table-sub-escapes531779
-Ref: table-sub-proposed533299
-Ref: table-posix-sub534663
-Ref: table-gensub-escapes536203
-Ref: Gory Details-Footnote-1537035
-Node: I/O Functions537186
-Ref: I/O Functions-Footnote-1544287
-Node: Time Functions544434
-Ref: Time Functions-Footnote-1554903
-Ref: Time Functions-Footnote-2554971
-Ref: Time Functions-Footnote-3555129
-Ref: Time Functions-Footnote-4555240
-Ref: Time Functions-Footnote-5555352
-Ref: Time Functions-Footnote-6555579
-Node: Bitwise Functions555845
-Ref: table-bitwise-ops556407
-Ref: Bitwise Functions-Footnote-1560715
-Node: Type Functions560884
-Node: I18N Functions562033
-Node: User-defined563678
-Node: Definition Syntax564482
-Ref: Definition Syntax-Footnote-1569888
-Node: Function Example569957
-Ref: Function Example-Footnote-1572874
-Node: Function Caveats572896
-Node: Calling A Function573414
-Node: Variable Scope574369
-Node: Pass By Value/Reference577357
-Node: Return Statement580867
-Node: Dynamic Typing583851
-Node: Indirect Calls584780
-Ref: Indirect Calls-Footnote-1596084
-Node: Functions Summary596212
-Node: Library Functions598911
-Ref: Library Functions-Footnote-1602529
-Ref: Library Functions-Footnote-2602672
-Node: Library Names602843
-Ref: Library Names-Footnote-1606303
-Ref: Library Names-Footnote-2606523
-Node: General Functions606609
-Node: Strtonum Function607712
-Node: Assert Function610732
-Node: Round Function614056
-Node: Cliff Random Function615597
-Node: Ordinal Functions616613
-Ref: Ordinal Functions-Footnote-1619678
-Ref: Ordinal Functions-Footnote-2619930
-Node: Join Function620141
-Ref: Join Function-Footnote-1621912
-Node: Getlocaltime Function622112
-Node: Readfile Function625853
-Node: Shell Quoting627823
-Node: Data File Management629224
-Node: Filetrans Function629856
-Node: Rewind Function633915
-Node: File Checking635300
-Ref: File Checking-Footnote-1636628
-Node: Empty Files636829
-Node: Ignoring Assigns638808
-Node: Getopt Function640359
-Ref: Getopt Function-Footnote-1651819
-Node: Passwd Functions652022
-Ref: Passwd Functions-Footnote-1660873
-Node: Group Functions660961
-Ref: Group Functions-Footnote-1668864
-Node: Walking Arrays669077
-Node: Library Functions Summary670680
-Node: Library Exercises672081
-Node: Sample Programs673361
-Node: Running Examples674131
-Node: Clones674859
-Node: Cut Program676083
-Node: Egrep Program685813
-Ref: Egrep Program-Footnote-1693317
-Node: Id Program693427
-Node: Split Program697071
-Ref: Split Program-Footnote-1700517
-Node: Tee Program700645
-Node: Uniq Program703432
-Node: Wc Program710853
-Ref: Wc Program-Footnote-1715101
-Node: Miscellaneous Programs715193
-Node: Dupword Program716406
-Node: Alarm Program718437
-Node: Translate Program723241
-Ref: Translate Program-Footnote-1727805
-Node: Labels Program728075
-Ref: Labels Program-Footnote-1731424
-Node: Word Sorting731508
-Node: History Sorting735578
-Node: Extract Program737414
-Node: Simple Sed744946
-Node: Igawk Program748008
-Ref: Igawk Program-Footnote-1762334
-Ref: Igawk Program-Footnote-2762535
-Ref: Igawk Program-Footnote-3762657
-Node: Anagram Program762772
-Node: Signature Program765834
-Node: Programs Summary767081
-Node: Programs Exercises768274
-Ref: Programs Exercises-Footnote-1772405
-Node: Advanced Features772496
-Node: Nondecimal Data774444
-Node: Array Sorting776034
-Node: Controlling Array Traversal776731
-Ref: Controlling Array Traversal-Footnote-1785062
-Node: Array Sorting Functions785180
-Ref: Array Sorting Functions-Footnote-1789072
-Node: Two-way I/O789266
-Ref: Two-way I/O-Footnote-1794210
-Ref: Two-way I/O-Footnote-2794396
-Node: TCP/IP Networking794478
-Node: Profiling797350
-Node: Advanced Features Summary804894
-Node: Internationalization806827
-Node: I18N and L10N808307
-Node: Explaining gettext808993
-Ref: Explaining gettext-Footnote-1814022
-Ref: Explaining gettext-Footnote-2814206
-Node: Programmer i18n814371
-Ref: Programmer i18n-Footnote-1819237
-Node: Translator i18n819286
-Node: String Extraction820080
-Ref: String Extraction-Footnote-1821211
-Node: Printf Ordering821297
-Ref: Printf Ordering-Footnote-1824083
-Node: I18N Portability824147
-Ref: I18N Portability-Footnote-1826596
-Node: I18N Example826659
-Ref: I18N Example-Footnote-1829459
-Node: Gawk I18N829531
-Node: I18N Summary830169
-Node: Debugger831508
-Node: Debugging832530
-Node: Debugging Concepts832971
-Node: Debugging Terms834828
-Node: Awk Debugging837403
-Node: Sample Debugging Session838295
-Node: Debugger Invocation838815
-Node: Finding The Bug840199
-Node: List of Debugger Commands846674
-Node: Breakpoint Control848006
-Node: Debugger Execution Control851698
-Node: Viewing And Changing Data855062
-Node: Execution Stack858427
-Node: Debugger Info860065
-Node: Miscellaneous Debugger Commands864082
-Node: Readline Support869274
-Node: Limitations870166
-Node: Debugging Summary872263
-Node: Arbitrary Precision Arithmetic873431
-Node: Computer Arithmetic874847
-Ref: table-numeric-ranges878448
-Ref: Computer Arithmetic-Footnote-1879307
-Node: Math Definitions879364
-Ref: table-ieee-formats882651
-Ref: Math Definitions-Footnote-1883255
-Node: MPFR features883360
-Node: FP Math Caution885031
-Ref: FP Math Caution-Footnote-1886081
-Node: Inexactness of computations886450
-Node: Inexact representation887398
-Node: Comparing FP Values888753
-Node: Errors accumulate889826
-Node: Getting Accuracy891259
-Node: Try To Round893918
-Node: Setting precision894817
-Ref: table-predefined-precision-strings895501
-Node: Setting the rounding mode897295
-Ref: table-gawk-rounding-modes897659
-Ref: Setting the rounding mode-Footnote-1901113
-Node: Arbitrary Precision Integers901292
-Ref: Arbitrary Precision Integers-Footnote-1904283
-Node: POSIX Floating Point Problems904432
-Ref: POSIX Floating Point Problems-Footnote-1908308
-Node: Floating point summary908346
-Node: Dynamic Extensions910538
-Node: Extension Intro912090
-Node: Plugin License913356
-Node: Extension Mechanism Outline914153
-Ref: figure-load-extension914581
-Ref: figure-register-new-function916061
-Ref: figure-call-new-function917065
-Node: Extension API Description919051
-Node: Extension API Functions Introduction920501
-Node: General Data Types925337
-Ref: General Data Types-Footnote-1931024
-Node: Memory Allocation Functions931323
-Ref: Memory Allocation Functions-Footnote-1934153
-Node: Constructor Functions934249
-Node: Registration Functions935983
-Node: Extension Functions936668
-Node: Exit Callback Functions938964
-Node: Extension Version String940212
-Node: Input Parsers940862
-Node: Output Wrappers950677
-Node: Two-way processors955193
-Node: Printing Messages957397
-Ref: Printing Messages-Footnote-1958474
-Node: Updating `ERRNO'958626
-Node: Requesting Values959366
-Ref: table-value-types-returned960094
-Node: Accessing Parameters961052
-Node: Symbol Table Access962283
-Node: Symbol table by name962797
-Node: Symbol table by cookie964777
-Ref: Symbol table by cookie-Footnote-1968916
-Node: Cached values968979
-Ref: Cached values-Footnote-1972483
-Node: Array Manipulation972574
-Ref: Array Manipulation-Footnote-1973672
-Node: Array Data Types973711
-Ref: Array Data Types-Footnote-1976368
-Node: Array Functions976460
-Node: Flattening Arrays980314
-Node: Creating Arrays987201
-Node: Extension API Variables991968
-Node: Extension Versioning992604
-Node: Extension API Informational Variables994505
-Node: Extension API Boilerplate995593
-Node: Finding Extensions999409
-Node: Extension Example999969
-Node: Internal File Description1000741
-Node: Internal File Ops1004808
-Ref: Internal File Ops-Footnote-11016466
-Node: Using Internal File Ops1016606
-Ref: Using Internal File Ops-Footnote-11018989
-Node: Extension Samples1019262
-Node: Extension Sample File Functions1020786
-Node: Extension Sample Fnmatch1028388
-Node: Extension Sample Fork1029870
-Node: Extension Sample Inplace1031083
-Node: Extension Sample Ord1032758
-Node: Extension Sample Readdir1033594
-Ref: table-readdir-file-types1034470
-Node: Extension Sample Revout1035281
-Node: Extension Sample Rev2way1035872
-Node: Extension Sample Read write array1036613
-Node: Extension Sample Readfile1038552
-Node: Extension Sample Time1039647
-Node: Extension Sample API Tests1040996
-Node: gawkextlib1041487
-Node: Extension summary1044137
-Node: Extension Exercises1047819
-Node: Language History1048541
-Node: V7/SVR3.11050198
-Node: SVR41052379
-Node: POSIX1053824
-Node: BTL1055213
-Node: POSIX/GNU1055947
-Node: Feature History1061516
-Node: Common Extensions1074614
-Node: Ranges and Locales1075938
-Ref: Ranges and Locales-Footnote-11080577
-Ref: Ranges and Locales-Footnote-21080604
-Ref: Ranges and Locales-Footnote-31080838
-Node: Contributors1081059
-Node: History summary1086599
-Node: Installation1087968
-Node: Gawk Distribution1088924
-Node: Getting1089408
-Node: Extracting1090232
-Node: Distribution contents1091874
-Node: Unix Installation1097591
-Node: Quick Installation1098208
-Node: Additional Configuration Options1100639
-Node: Configuration Philosophy1102379
-Node: Non-Unix Installation1104730
-Node: PC Installation1105188
-Node: PC Binary Installation1106514
-Node: PC Compiling1108362
-Ref: PC Compiling-Footnote-11111383
-Node: PC Testing1111488
-Node: PC Using1112664
-Node: Cygwin1116779
-Node: MSYS1117602
-Node: VMS Installation1118100
-Node: VMS Compilation1118892
-Ref: VMS Compilation-Footnote-11120114
-Node: VMS Dynamic Extensions1120172
-Node: VMS Installation Details1121856
-Node: VMS Running1124108
-Node: VMS GNV1126949
-Node: VMS Old Gawk1127683
-Node: Bugs1128153
-Node: Other Versions1132057
-Node: Installation summary1138270
-Node: Notes1139326
-Node: Compatibility Mode1140191
-Node: Additions1140973
-Node: Accessing The Source1141898
-Node: Adding Code1143334
-Node: New Ports1149506
-Node: Derived Files1153988
-Ref: Derived Files-Footnote-11159463
-Ref: Derived Files-Footnote-21159497
-Ref: Derived Files-Footnote-31160093
-Node: Future Extensions1160207
-Node: Implementation Limitations1160813
-Node: Extension Design1162061
-Node: Old Extension Problems1163215
-Ref: Old Extension Problems-Footnote-11164732
-Node: Extension New Mechanism Goals1164789
-Ref: Extension New Mechanism Goals-Footnote-11168149
-Node: Extension Other Design Decisions1168338
-Node: Extension Future Growth1170446
-Node: Old Extension Mechanism1171282
-Node: Notes summary1173044
-Node: Basic Concepts1174230
-Node: Basic High Level1174911
-Ref: figure-general-flow1175183
-Ref: figure-process-flow1175782
-Ref: Basic High Level-Footnote-11179011
-Node: Basic Data Typing1179196
-Node: Glossary1182524
-Node: Copying1207682
-Node: GNU Free Documentation License1245238
-Node: Index1270374
+Ref: Options-Footnote-1131088
+Node: Other Arguments131113
+Node: Naming Standard Input134074
+Node: Environment Variables135167
+Node: AWKPATH Variable135725
+Ref: AWKPATH Variable-Footnote-1139025
+Ref: AWKPATH Variable-Footnote-2139070
+Node: AWKLIBPATH Variable139330
+Node: Other Environment Variables140473
+Node: Exit Status144193
+Node: Include Files144868
+Node: Loading Shared Libraries148456
+Node: Obsolete149883
+Node: Undocumented150580
+Node: Invoking Summary150847
+Node: Regexp152513
+Node: Regexp Usage153972
+Node: Escape Sequences156005
+Node: Regexp Operators162022
+Ref: Regexp Operators-Footnote-1169456
+Ref: Regexp Operators-Footnote-2169603
+Node: Bracket Expressions169701
+Ref: table-char-classes171718
+Node: Leftmost Longest174658
+Node: Computed Regexps175960
+Node: GNU Regexp Operators179357
+Node: Case-sensitivity183059
+Ref: Case-sensitivity-Footnote-1185949
+Ref: Case-sensitivity-Footnote-2186184
+Node: Regexp Summary186292
+Node: Reading Files187761
+Node: Records189855
+Node: awk split records190587
+Node: gawk split records195501
+Ref: gawk split records-Footnote-1200040
+Node: Fields200077
+Ref: Fields-Footnote-1202875
+Node: Nonconstant Fields202961
+Ref: Nonconstant Fields-Footnote-1205197
+Node: Changing Fields205399
+Node: Field Separators211331
+Node: Default Field Splitting214035
+Node: Regexp Field Splitting215152
+Node: Single Character Fields218502
+Node: Command Line Field Separator219561
+Node: Full Line Fields222773
+Ref: Full Line Fields-Footnote-1223281
+Node: Field Splitting Summary223327
+Ref: Field Splitting Summary-Footnote-1226458
+Node: Constant Size226559
+Node: Splitting By Content231165
+Ref: Splitting By Content-Footnote-1235238
+Node: Multiple Line235278
+Ref: Multiple Line-Footnote-1241167
+Node: Getline241346
+Node: Plain Getline243557
+Node: Getline/Variable246197
+Node: Getline/File247344
+Node: Getline/Variable/File248728
+Ref: Getline/Variable/File-Footnote-1250329
+Node: Getline/Pipe250416
+Node: Getline/Variable/Pipe253099
+Node: Getline/Coprocess254230
+Node: Getline/Variable/Coprocess255482
+Node: Getline Notes256221
+Node: Getline Summary259013
+Ref: table-getline-variants259425
+Node: Read Timeout260254
+Ref: Read Timeout-Footnote-1264068
+Node: Command-line directories264126
+Node: Input Summary265030
+Node: Input Exercises268282
+Node: Printing269010
+Node: Print270787
+Node: Print Examples272244
+Node: Output Separators275023
+Node: OFMT277041
+Node: Printf278395
+Node: Basic Printf279180
+Node: Control Letters280751
+Node: Format Modifiers284735
+Node: Printf Examples290742
+Node: Redirection293224
+Node: Special FD300063
+Ref: Special FD-Footnote-1303220
+Node: Special Files303294
+Node: Other Inherited Files303910
+Node: Special Network304910
+Node: Special Caveats305771
+Node: Close Files And Pipes306722
+Ref: Close Files And Pipes-Footnote-1313901
+Ref: Close Files And Pipes-Footnote-2314049
+Node: Output Summary314199
+Node: Output Exercises315195
+Node: Expressions315875
+Node: Values317060
+Node: Constants317736
+Node: Scalar Constants318416
+Ref: Scalar Constants-Footnote-1319275
+Node: Nondecimal-numbers319525
+Node: Regexp Constants322525
+Node: Using Constant Regexps323050
+Node: Variables326188
+Node: Using Variables326843
+Node: Assignment Options328753
+Node: Conversion330628
+Node: Strings And Numbers331152
+Ref: Strings And Numbers-Footnote-1334216
+Node: Locale influences conversions334325
+Ref: table-locale-affects337070
+Node: All Operators337658
+Node: Arithmetic Ops338288
+Node: Concatenation340793
+Ref: Concatenation-Footnote-1343612
+Node: Assignment Ops343718
+Ref: table-assign-ops348701
+Node: Increment Ops349979
+Node: Truth Values and Conditions353417
+Node: Truth Values354500
+Node: Typing and Comparison355549
+Node: Variable Typing356342
+Node: Comparison Operators359994
+Ref: table-relational-ops360404
+Node: POSIX String Comparison363919
+Ref: POSIX String Comparison-Footnote-1364991
+Node: Boolean Ops365129
+Ref: Boolean Ops-Footnote-1369608
+Node: Conditional Exp369699
+Node: Function Calls371426
+Node: Precedence375306
+Node: Locales378974
+Node: Expressions Summary380605
+Node: Patterns and Actions383179
+Node: Pattern Overview384299
+Node: Regexp Patterns385978
+Node: Expression Patterns386521
+Node: Ranges390301
+Node: BEGIN/END393407
+Node: Using BEGIN/END394169
+Ref: Using BEGIN/END-Footnote-1396906
+Node: I/O And BEGIN/END397012
+Node: BEGINFILE/ENDFILE399326
+Node: Empty402227
+Node: Using Shell Variables402544
+Node: Action Overview404820
+Node: Statements407147
+Node: If Statement408995
+Node: While Statement410493
+Node: Do Statement412521
+Node: For Statement413663
+Node: Switch Statement416818
+Node: Break Statement419206
+Node: Continue Statement421247
+Node: Next Statement423072
+Node: Nextfile Statement425452
+Node: Exit Statement428082
+Node: Built-in Variables430485
+Node: User-modified431618
+Ref: User-modified-Footnote-1439298
+Node: Auto-set439360
+Ref: Auto-set-Footnote-1452390
+Ref: Auto-set-Footnote-2452595
+Node: ARGC and ARGV452651
+Node: Pattern Action Summary456855
+Node: Arrays459282
+Node: Array Basics460611
+Node: Array Intro461455
+Ref: figure-array-elements463419
+Ref: Array Intro-Footnote-1465943
+Node: Reference to Elements466071
+Node: Assigning Elements468521
+Node: Array Example469012
+Node: Scanning an Array470770
+Node: Controlling Scanning473786
+Ref: Controlling Scanning-Footnote-1478975
+Node: Numeric Array Subscripts479291
+Node: Uninitialized Subscripts481476
+Node: Delete483093
+Ref: Delete-Footnote-1485837
+Node: Multidimensional485894
+Node: Multiscanning488989
+Node: Arrays of Arrays490578
+Node: Arrays Summary495339
+Node: Functions497444
+Node: Built-in498317
+Node: Calling Built-in499395
+Node: Numeric Functions501383
+Ref: Numeric Functions-Footnote-1505405
+Ref: Numeric Functions-Footnote-2505762
+Ref: Numeric Functions-Footnote-3505810
+Node: String Functions506079
+Ref: String Functions-Footnote-1529551
+Ref: String Functions-Footnote-2529680
+Ref: String Functions-Footnote-3529928
+Node: Gory Details530015
+Ref: table-sub-escapes531796
+Ref: table-sub-proposed533316
+Ref: table-posix-sub534680
+Ref: table-gensub-escapes536220
+Ref: Gory Details-Footnote-1537052
+Node: I/O Functions537203
+Ref: I/O Functions-Footnote-1544304
+Node: Time Functions544451
+Ref: Time Functions-Footnote-1554920
+Ref: Time Functions-Footnote-2554988
+Ref: Time Functions-Footnote-3555146
+Ref: Time Functions-Footnote-4555257
+Ref: Time Functions-Footnote-5555369
+Ref: Time Functions-Footnote-6555596
+Node: Bitwise Functions555862
+Ref: table-bitwise-ops556424
+Ref: Bitwise Functions-Footnote-1560732
+Node: Type Functions560901
+Node: I18N Functions562050
+Node: User-defined563695
+Node: Definition Syntax564499
+Ref: Definition Syntax-Footnote-1569905
+Node: Function Example569974
+Ref: Function Example-Footnote-1572891
+Node: Function Caveats572913
+Node: Calling A Function573431
+Node: Variable Scope574386
+Node: Pass By Value/Reference577374
+Node: Return Statement580884
+Node: Dynamic Typing583868
+Node: Indirect Calls584797
+Ref: Indirect Calls-Footnote-1596101
+Node: Functions Summary596229
+Node: Library Functions598928
+Ref: Library Functions-Footnote-1602546
+Ref: Library Functions-Footnote-2602689
+Node: Library Names602860
+Ref: Library Names-Footnote-1606320
+Ref: Library Names-Footnote-2606540
+Node: General Functions606626
+Node: Strtonum Function607729
+Node: Assert Function610749
+Node: Round Function614073
+Node: Cliff Random Function615614
+Node: Ordinal Functions616630
+Ref: Ordinal Functions-Footnote-1619695
+Ref: Ordinal Functions-Footnote-2619947
+Node: Join Function620158
+Ref: Join Function-Footnote-1621929
+Node: Getlocaltime Function622129
+Node: Readfile Function625870
+Node: Shell Quoting627840
+Node: Data File Management629241
+Node: Filetrans Function629873
+Node: Rewind Function633932
+Node: File Checking635317
+Ref: File Checking-Footnote-1636645
+Node: Empty Files636846
+Node: Ignoring Assigns638825
+Node: Getopt Function640376
+Ref: Getopt Function-Footnote-1651836
+Node: Passwd Functions652039
+Ref: Passwd Functions-Footnote-1660890
+Node: Group Functions660978
+Ref: Group Functions-Footnote-1668881
+Node: Walking Arrays669094
+Node: Library Functions Summary670697
+Node: Library Exercises672098
+Node: Sample Programs673378
+Node: Running Examples674148
+Node: Clones674876
+Node: Cut Program676100
+Node: Egrep Program685830
+Ref: Egrep Program-Footnote-1693334
+Node: Id Program693444
+Node: Split Program697088
+Ref: Split Program-Footnote-1700534
+Node: Tee Program700662
+Node: Uniq Program703449
+Node: Wc Program710870
+Ref: Wc Program-Footnote-1715118
+Node: Miscellaneous Programs715210
+Node: Dupword Program716423
+Node: Alarm Program718454
+Node: Translate Program723258
+Ref: Translate Program-Footnote-1727822
+Node: Labels Program728092
+Ref: Labels Program-Footnote-1731441
+Node: Word Sorting731525
+Node: History Sorting735595
+Node: Extract Program737431
+Node: Simple Sed744963
+Node: Igawk Program748025
+Ref: Igawk Program-Footnote-1762351
+Ref: Igawk Program-Footnote-2762552
+Ref: Igawk Program-Footnote-3762674
+Node: Anagram Program762789
+Node: Signature Program765851
+Node: Programs Summary767098
+Node: Programs Exercises768291
+Ref: Programs Exercises-Footnote-1772422
+Node: Advanced Features772513
+Node: Nondecimal Data774461
+Node: Array Sorting776051
+Node: Controlling Array Traversal776748
+Ref: Controlling Array Traversal-Footnote-1785079
+Node: Array Sorting Functions785197
+Ref: Array Sorting Functions-Footnote-1789089
+Node: Two-way I/O789283
+Ref: Two-way I/O-Footnote-1794227
+Ref: Two-way I/O-Footnote-2794413
+Node: TCP/IP Networking794495
+Node: Profiling797367
+Node: Advanced Features Summary804911
+Node: Internationalization806844
+Node: I18N and L10N808324
+Node: Explaining gettext809010
+Ref: Explaining gettext-Footnote-1814039
+Ref: Explaining gettext-Footnote-2814223
+Node: Programmer i18n814388
+Ref: Programmer i18n-Footnote-1819254
+Node: Translator i18n819303
+Node: String Extraction820097
+Ref: String Extraction-Footnote-1821228
+Node: Printf Ordering821314
+Ref: Printf Ordering-Footnote-1824100
+Node: I18N Portability824164
+Ref: I18N Portability-Footnote-1826613
+Node: I18N Example826676
+Ref: I18N Example-Footnote-1829476
+Node: Gawk I18N829548
+Node: I18N Summary830186
+Node: Debugger831525
+Node: Debugging832547
+Node: Debugging Concepts832988
+Node: Debugging Terms834845
+Node: Awk Debugging837420
+Node: Sample Debugging Session838312
+Node: Debugger Invocation838832
+Node: Finding The Bug840216
+Node: List of Debugger Commands846691
+Node: Breakpoint Control848023
+Node: Debugger Execution Control851715
+Node: Viewing And Changing Data855079
+Node: Execution Stack858444
+Node: Debugger Info860082
+Node: Miscellaneous Debugger Commands864099
+Node: Readline Support869291
+Node: Limitations870183
+Node: Debugging Summary872280
+Node: Arbitrary Precision Arithmetic873448
+Node: Computer Arithmetic874864
+Ref: table-numeric-ranges878465
+Ref: Computer Arithmetic-Footnote-1879324
+Node: Math Definitions879381
+Ref: table-ieee-formats882668
+Ref: Math Definitions-Footnote-1883272
+Node: MPFR features883377
+Node: FP Math Caution885048
+Ref: FP Math Caution-Footnote-1886098
+Node: Inexactness of computations886467
+Node: Inexact representation887415
+Node: Comparing FP Values888770
+Node: Errors accumulate889843
+Node: Getting Accuracy891276
+Node: Try To Round893935
+Node: Setting precision894834
+Ref: table-predefined-precision-strings895518
+Node: Setting the rounding mode897312
+Ref: table-gawk-rounding-modes897676
+Ref: Setting the rounding mode-Footnote-1901130
+Node: Arbitrary Precision Integers901309
+Ref: Arbitrary Precision Integers-Footnote-1904300
+Node: POSIX Floating Point Problems904449
+Ref: POSIX Floating Point Problems-Footnote-1908325
+Node: Floating point summary908363
+Node: Dynamic Extensions910555
+Node: Extension Intro912107
+Node: Plugin License913373
+Node: Extension Mechanism Outline914170
+Ref: figure-load-extension914598
+Ref: figure-register-new-function916078
+Ref: figure-call-new-function917082
+Node: Extension API Description919068
+Node: Extension API Functions Introduction920518
+Node: General Data Types925354
+Ref: General Data Types-Footnote-1931041
+Node: Memory Allocation Functions931340
+Ref: Memory Allocation Functions-Footnote-1934170
+Node: Constructor Functions934266
+Node: Registration Functions936000
+Node: Extension Functions936685
+Node: Exit Callback Functions938981
+Node: Extension Version String940229
+Node: Input Parsers940879
+Node: Output Wrappers950694
+Node: Two-way processors955210
+Node: Printing Messages957414
+Ref: Printing Messages-Footnote-1958491
+Node: Updating `ERRNO'958643
+Node: Requesting Values959383
+Ref: table-value-types-returned960111
+Node: Accessing Parameters961069
+Node: Symbol Table Access962300
+Node: Symbol table by name962814
+Node: Symbol table by cookie964794
+Ref: Symbol table by cookie-Footnote-1968933
+Node: Cached values968996
+Ref: Cached values-Footnote-1972500
+Node: Array Manipulation972591
+Ref: Array Manipulation-Footnote-1973689
+Node: Array Data Types973728
+Ref: Array Data Types-Footnote-1976385
+Node: Array Functions976477
+Node: Flattening Arrays980331
+Node: Creating Arrays987218
+Node: Extension API Variables991985
+Node: Extension Versioning992621
+Node: Extension API Informational Variables994522
+Node: Extension API Boilerplate995610
+Node: Finding Extensions999426
+Node: Extension Example999986
+Node: Internal File Description1000758
+Node: Internal File Ops1004825
+Ref: Internal File Ops-Footnote-11016483
+Node: Using Internal File Ops1016623
+Ref: Using Internal File Ops-Footnote-11019006
+Node: Extension Samples1019279
+Node: Extension Sample File Functions1020803
+Node: Extension Sample Fnmatch1028405
+Node: Extension Sample Fork1029887
+Node: Extension Sample Inplace1031100
+Node: Extension Sample Ord1032775
+Node: Extension Sample Readdir1033611
+Ref: table-readdir-file-types1034487
+Node: Extension Sample Revout1035298
+Node: Extension Sample Rev2way1035889
+Node: Extension Sample Read write array1036630
+Node: Extension Sample Readfile1038569
+Node: Extension Sample Time1039664
+Node: Extension Sample API Tests1041013
+Node: gawkextlib1041504
+Node: Extension summary1044154
+Node: Extension Exercises1047836
+Node: Language History1048558
+Node: V7/SVR3.11050215
+Node: SVR41052396
+Node: POSIX1053841
+Node: BTL1055230
+Node: POSIX/GNU1055964
+Node: Feature History1061533
+Node: Common Extensions1074631
+Node: Ranges and Locales1075955
+Ref: Ranges and Locales-Footnote-11080594
+Ref: Ranges and Locales-Footnote-21080621
+Ref: Ranges and Locales-Footnote-31080855
+Node: Contributors1081076
+Node: History summary1086616
+Node: Installation1087985
+Node: Gawk Distribution1088941
+Node: Getting1089425
+Node: Extracting1090249
+Node: Distribution contents1091891
+Node: Unix Installation1097608
+Node: Quick Installation1098225
+Node: Additional Configuration Options1100656
+Node: Configuration Philosophy1102396
+Node: Non-Unix Installation1104747
+Node: PC Installation1105205
+Node: PC Binary Installation1106531
+Node: PC Compiling1108379
+Ref: PC Compiling-Footnote-11111400
+Node: PC Testing1111505
+Node: PC Using1112681
+Node: Cygwin1116796
+Node: MSYS1117619
+Node: VMS Installation1118117
+Node: VMS Compilation1118909
+Ref: VMS Compilation-Footnote-11120131
+Node: VMS Dynamic Extensions1120189
+Node: VMS Installation Details1121873
+Node: VMS Running1124125
+Node: VMS GNV1126966
+Node: VMS Old Gawk1127700
+Node: Bugs1128170
+Node: Other Versions1132074
+Node: Installation summary1138287
+Node: Notes1139343
+Node: Compatibility Mode1140208
+Node: Additions1140990
+Node: Accessing The Source1141915
+Node: Adding Code1143351
+Node: New Ports1149523
+Node: Derived Files1154005
+Ref: Derived Files-Footnote-11159480
+Ref: Derived Files-Footnote-21159514
+Ref: Derived Files-Footnote-31160110
+Node: Future Extensions1160224
+Node: Implementation Limitations1160830
+Node: Extension Design1162078
+Node: Old Extension Problems1163232
+Ref: Old Extension Problems-Footnote-11164749
+Node: Extension New Mechanism Goals1164806
+Ref: Extension New Mechanism Goals-Footnote-11168166
+Node: Extension Other Design Decisions1168355
+Node: Extension Future Growth1170463
+Node: Old Extension Mechanism1171299
+Node: Notes summary1173061
+Node: Basic Concepts1174247
+Node: Basic High Level1174928
+Ref: figure-general-flow1175200
+Ref: figure-process-flow1175799
+Ref: Basic High Level-Footnote-11179028
+Node: Basic Data Typing1179213
+Node: Glossary1182541
+Node: Copying1207699
+Node: GNU Free Documentation License1245255
+Node: Index1270391
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 1389079d..ba56ddef 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3824,7 +3824,8 @@ names like @code{i}, @code{j}, etc.)
 @cindex @command{awk} debugging, enabling
 Enable debugging of @command{awk} programs
 (@pxref{Debugging}).
-By default, the debugger reads commands interactively from the keyboard.
+By default, the debugger reads commands interactively from the keyboard
+(standard input).
 The optional @var{file} argument allows you to specify a file with a list
 of commands for the debugger to execute non-interactively.
 No space is allowed between the @option{-D} and @var{file}, if
@@ -39871,6 +39872,11 @@ originally written by Steven R.@: Bourne at Bell Laboratories.
 Many shells (Bash, @command{ksh}, @command{pdksh}, @command{zsh}) are
 generally upwardly compatible with the Bourne shell.
 
+@item Braces
+The characters @samp{@{} and @samp{@}}.  Braces are used in
+@command{awk} for delimiting actions, compound statements, and function
+bodies.
+
 @item Built-in Function
 The @command{awk} language provides built-in functions that perform various
 numerical, I/O-related, and string computations.  Examples are
@@ -39916,11 +39922,6 @@ are the variables that have special meaning to @command{gawk}.
 Changing some of them affects @command{awk}'s running environment.
 (@xref{Built-in Variables}.)
 
-@item Braces
-The characters @samp{@{} and @samp{@}}.  Braces are used in
-@command{awk} for delimiting actions, compound statements, and function
-bodies.
-
 @item C
 The system programming language that most GNU software is written in.  The
 @command{awk} programming language has C-like syntax, and this @value{DOCUMENT}
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 6d212f80..d8995415 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -3735,7 +3735,8 @@ names like @code{i}, @code{j}, etc.)
 @cindex @command{awk} debugging, enabling
 Enable debugging of @command{awk} programs
 (@pxref{Debugging}).
-By default, the debugger reads commands interactively from the keyboard.
+By default, the debugger reads commands interactively from the keyboard
+(standard input).
 The optional @var{file} argument allows you to specify a file with a list
 of commands for the debugger to execute non-interactively.
 No space is allowed between the @option{-D} and @var{file}, if
@@ -38965,6 +38966,11 @@ originally written by Steven R.@: Bourne at Bell Laboratories.
 Many shells (Bash, @command{ksh}, @command{pdksh}, @command{zsh}) are
 generally upwardly compatible with the Bourne shell.
 
+@item Braces
+The characters @samp{@{} and @samp{@}}.  Braces are used in
+@command{awk} for delimiting actions, compound statements, and function
+bodies.
+
 @item Built-in Function
 The @command{awk} language provides built-in functions that perform various
 numerical, I/O-related, and string computations.  Examples are
@@ -39010,11 +39016,6 @@ are the variables that have special meaning to @command{gawk}.
 Changing some of them affects @command{awk}'s running environment.
 (@xref{Built-in Variables}.)
 
-@item Braces
-The characters @samp{@{} and @samp{@}}.  Braces are used in
-@command{awk} for delimiting actions, compound statements, and function
-bodies.
-
 @item C
 The system programming language that most GNU software is written in.  The
 @command{awk} programming language has C-like syntax, and this @value{DOCUMENT}