[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5581-gfd42f9b9

[Arnold Robbins]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, gawk-5.3-stable has been updated
       via  fd42f9b92a03e2de414504ff5a49448cb831252b (commit)
      from  b3fae6d7fde8173fb8d58de6eb38fe1d79f5d979 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=fd42f9b92a03e2de414504ff5a49448cb831252b

commit fd42f9b92a03e2de414504ff5a49448cb831252b
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Mon Nov 4 07:37:58 2024 +0200

    Doc updates: \ inside [...].

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 37b37e38..b3f06fbc 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2024-11-04         Arnold D. Robbins     <arnold@skeeve.com>
+
+       * gawk.texi (Bracket Expressions): Add some clarifications
+       about backslash inside [...]. Thanks to Ed Morton
+       for the motivation.
+
 2024-10-20         Arnold D. Robbins     <arnold@skeeve.com>
 
        * gawk.texi [PVERSION]: Nuked. All uses changed to straight
diff --git a/doc/gawk.info b/doc/gawk.info
index 6c84f2c3..d2e3e194 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -4133,7 +4133,7 @@ Octal and hexadecimal escape sequences inside bracket 
expressions are
 taken to represent only single-byte characters (characters whose values
 fit within the range 0-256).  To match a range of characters where the
 endpoints of the range are larger than 256, enter the multibyte
-encodings of the characters directly.
+encodings of the characters directly, or use the ‘\u’ escape sequence.
 
    To include one of the characters ‘\’, ‘]’, ‘-’, or ‘^’ in a 
bracket
 expression, put a ‘\’ in front of it.  For example:
@@ -4145,7 +4145,7 @@ the opening ‘[’, the closing bracket is treated as 
one of the characters
 to be matched.
 
    The treatment of ‘\’ in bracket expressions is compatible with other
-‘awk’ implementations and is also mandated by POSIX. The regular
+‘awk’ implementations and is also mandated by POSIX.(1) The regular
 expressions in ‘awk’ are a superset of the POSIX specification for
 Extended Regular Expressions (EREs).  POSIX EREs are based on the
 regular expressions accepted by the traditional ‘egrep’ utility.
@@ -4231,6 +4231,13 @@ Equivalence classes
 start a character class, collating element or equivalence class is taken
 literally.  This is also true of ‘.’ and ‘*’.
 
+   ---------- Footnotes ----------
+
+   (1) See the POSIX standard for ‘awk’
+(https://pubs.opengroup.org/onlinepubs/9799919799/utilities/awk.html#tag_20_06_13_04).
+The standard doesn't relate to the case of ‘\]’, but it does explicitly
+relate to ‘\’ before a regular expression metacharacter.
+
 
 File: gawk.info,  Node: Leftmost Longest,  Next: Computed Regexps,  Prev: 
Bracket Expressions,  Up: Regexp
 
@@ -40063,561 +40070,562 @@ Ref: Regexp Operator Details-Footnote-1192572
 Node: Interval Expressions192731
 Ref: Interval Expressions-Footnote-1194998
 Node: Bracket Expressions195096
-Ref: table-char-classes197652
-Node: Leftmost Longest201150
-Node: Computed Regexps202506
-Node: GNU Regexp Operators206021
-Node: Case-sensitivity211118
-Ref: Case-sensitivity-Footnote-1214068
-Ref: Case-sensitivity-Footnote-2214311
-Node: Regexp Summary214423
-Node: Reading Files215945
-Node: Records218264
-Node: awk split records219539
-Node: gawk split records224421
-Ref: gawk split records-Footnote-1229709
-Node: Fields229746
-Ref: Fields-Footnote-1232662
-Node: Nonconstant Fields232782
-Ref: Nonconstant Fields-Footnote-1235090
-Node: Changing Fields235306
-Node: Field Separators241604
-Node: Default Field Splitting244473
-Node: Regexp Field Splitting245615
-Node: Single Character Fields249444
-Node: Comma Separated Fields250533
-Ref: table-csv-examples251937
-Node: Command Line Field Separator254236
-Node: Full Line Fields257612
-Ref: Full Line Fields-Footnote-1259190
-Ref: Full Line Fields-Footnote-2259236
-Node: Field Splitting Summary259341
-Node: Constant Size261658
-Node: Fixed width data262402
-Node: Skipping intervening265917
-Node: Allowing trailing data266719
-Node: Fields with fixed data267780
-Node: Splitting By Content269402
-Ref: Splitting By Content-Footnote-1274902
-Node: FS versus FPAT275065
-Node: Testing field creation276248
-Node: Multiple Line278022
-Node: Getline284491
-Node: Plain Getline287079
-Node: Getline/Variable289727
-Node: Getline/File290923
-Node: Getline/Variable/File292371
-Ref: Getline/Variable/File-Footnote-1294016
-Node: Getline/Pipe294112
-Node: Getline/Variable/Pipe296920
-Node: Getline/Coprocess298103
-Node: Getline/Variable/Coprocess299426
-Node: Getline Notes300192
-Node: Getline Summary304169
-Ref: table-getline-variants304613
-Node: Read Timeout305517
-Ref: Read Timeout-Footnote-1309479
-Node: Retrying Input309537
-Node: Command-line directories310804
-Node: Input Summary311742
-Node: Input Exercises315122
-Node: Printing315560
-Node: Print317503
-Node: Print Examples319004
-Node: Output Separators321849
-Node: OFMT323956
-Node: Printf325669
-Node: Basic Printf326474
-Node: Control Letters328109
-Node: Format Modifiers333555
-Node: Printf Examples339827
-Node: Redirection342368
-Node: Special FD350140
-Ref: Special FD-Footnote-1353438
-Node: Special Files353516
-Node: Other Inherited Files354145
-Node: Special Network355210
-Node: Special Caveats356098
-Node: Close Files And Pipes357081
-Ref: Close Files And Pipes-Footnote-1363205
-Node: Close Return Value363353
-Ref: table-close-pipe-return-values364624
-Ref: Close Return Value-Footnote-1365455
-Node: Noflush365611
-Node: Nonfatal367119
-Node: Output Summary369534
-Node: Output Exercises370820
-Node: Expressions371511
-Node: Values372711
-Node: Constants373389
-Node: Scalar Constants374084
-Ref: Scalar Constants-Footnote-1376660
-Ref: Scalar Constants-Footnote-2376910
-Node: Nondecimal-numbers376990
-Node: Regexp Constants380103
-Node: Using Constant Regexps380649
-Node: Standard Regexp Constants381295
-Node: Strong Regexp Constants384591
-Node: Variables388434
-Node: Using Variables389099
-Node: Assignment Options391073
-Node: Conversion393624
-Node: Strings And Numbers394156
-Ref: Strings And Numbers-Footnote-1397366
-Node: Locale influences conversions397475
-Ref: table-locale-affects400313
-Node: All Operators400955
-Node: Arithmetic Ops401596
-Node: Concatenation404419
-Ref: Concatenation-Footnote-1407355
-Node: Assignment Ops407474
-Ref: table-assign-ops412601
-Node: Increment Ops413982
-Node: Truth Values and Conditions417573
-Node: Truth Values418667
-Node: Typing and Comparison419747
-Node: Variable Typing420579
-Ref: Variable Typing-Footnote-1427223
-Ref: Variable Typing-Footnote-2427303
-Node: Comparison Operators427384
-Ref: table-relational-ops427811
-Node: POSIX String Comparison431487
-Ref: POSIX String Comparison-Footnote-1433244
-Ref: POSIX String Comparison-Footnote-2433387
-Node: Boolean Ops433471
-Ref: Boolean Ops-Footnote-1438145
-Node: Conditional Exp438241
-Node: Function Calls440021
-Node: Precedence443968
-Node: Locales447831
-Node: Expressions Summary449507
-Node: Patterns and Actions452162
-Node: Pattern Overview453298
-Node: Regexp Patterns455023
-Node: Expression Patterns455569
-Node: Ranges459474
-Node: BEGIN/END462648
-Node: Using BEGIN/END463457
-Ref: Using BEGIN/END-Footnote-1466365
-Node: I/O And BEGIN/END466475
-Node: BEGINFILE/ENDFILE468957
-Node: Empty472387
-Node: Using Shell Variables472704
-Node: Action Overview475040
-Node: Statements477476
-Node: If Statement479372
-Node: While Statement480935
-Node: Do Statement483023
-Node: For Statement484207
-Node: Switch Statement487562
-Node: Break Statement490111
-Node: Continue Statement492303
-Node: Next Statement494234
-Node: Nextfile Statement496713
-Node: Exit Statement499566
-Node: Built-in Variables502093
-Node: User-modified503270
-Node: Auto-set511477
-Ref: Auto-set-Footnote-1529561
-Ref: Auto-set-Footnote-2529779
-Node: ARGC and ARGV529835
-Node: Pattern Action Summary534264
-Node: Arrays536870
-Node: Array Basics538243
-Node: Array Intro539091
-Ref: figure-array-elements541102
-Ref: Array Intro-Footnote-1543955
-Node: Reference to Elements544087
-Node: Assigning Elements546607
-Node: Array Example547102
-Node: Scanning an Array549064
-Node: Controlling Scanning552159
-Ref: Controlling Scanning-Footnote-1558794
-Node: Numeric Array Subscripts559118
-Node: Uninitialized Subscripts561386
-Node: Delete563059
-Ref: Delete-Footnote-1565871
-Node: Multidimensional565928
-Node: Multiscanning569131
-Node: Arrays of Arrays570798
-Node: Arrays Summary575102
-Node: Functions577289
-Node: Built-in578491
-Node: Calling Built-in579680
-Node: Boolean Functions581720
-Node: Numeric Functions582282
-Ref: Numeric Functions-Footnote-1586467
-Ref: Numeric Functions-Footnote-2587150
-Ref: Numeric Functions-Footnote-3587202
-Node: String Functions587478
-Ref: String Functions-Footnote-1613929
-Ref: String Functions-Footnote-2614061
-Ref: String Functions-Footnote-3614317
-Node: Gory Details614404
-Ref: table-sub-escapes616413
-Ref: table-sub-proposed617965
-Ref: table-posix-sub619439
-Ref: table-gensub-escapes621091
-Ref: Gory Details-Footnote-1621919
-Node: I/O Functions622073
-Ref: table-system-return-values628749
-Ref: I/O Functions-Footnote-1630911
-Ref: I/O Functions-Footnote-2631059
-Node: Time Functions631179
-Ref: Time Functions-Footnote-1642891
-Ref: Time Functions-Footnote-2642959
-Ref: Time Functions-Footnote-3643121
-Ref: Time Functions-Footnote-4643232
-Ref: Time Functions-Footnote-5643348
-Ref: Time Functions-Footnote-6643575
-Node: Bitwise Functions643853
-Ref: table-bitwise-ops644451
-Ref: Bitwise Functions-Footnote-1650693
-Ref: Bitwise Functions-Footnote-2650870
-Node: Type Functions651065
-Node: I18N Functions653236
-Node: User-defined654971
-Node: Definition Syntax655717
-Ref: Definition Syntax-Footnote-1661572
-Node: Function Example661647
-Ref: Function Example-Footnote-1664626
-Node: Function Calling664648
-Node: Calling A Function665240
-Node: Variable Scope666210
-Node: Pass By Value/Reference669264
-Node: Function Caveats671992
-Ref: Function Caveats-Footnote-1674083
-Node: Return Statement674203
-Node: Dynamic Typing677235
-Node: Dynamic Typing Awk677817
-Node: Dynamic Typing Gawk679955
-Node: Shadowed Variables683325
-Node: Indirect Calls685673
-Node: Functions Summary696814
-Node: Library Functions699780
-Ref: Library Functions-Footnote-1703328
-Ref: Library Functions-Footnote-2703473
-Node: Library Names703648
-Ref: Library Names-Footnote-1707419
-Ref: Library Names-Footnote-2707646
-Node: General Functions707740
-Node: Strtonum Function709010
-Node: Assert Function712092
-Node: Round Function715542
-Node: Cliff Random Function717114
-Node: Ordinal Functions718138
-Ref: Ordinal Functions-Footnote-1721241
-Ref: Ordinal Functions-Footnote-2721493
-Node: Join Function721707
-Ref: Join Function-Footnote-1723505
-Node: Getlocaltime Function723709
-Node: Readfile Function727483
-Node: Shell Quoting729512
-Node: Isnumeric Function730968
-Node: To CSV Function732404
-Node: Data File Management734496
-Node: Filetrans Function735128
-Node: Rewind Function739404
-Node: File Checking741375
-Ref: File Checking-Footnote-1742741
-Node: Empty Files742946
-Node: Ignoring Assigns745009
-Node: Getopt Function746583
-Ref: Getopt Function-Footnote-1762401
-Node: Passwd Functions762613
-Ref: Passwd Functions-Footnote-1771748
-Node: Group Functions771836
-Ref: Group Functions-Footnote-1779960
-Node: Walking Arrays780171
-Node: Library Functions Summary783217
-Node: Library Exercises784637
-Node: Sample Programs785122
-Node: Running Examples785904
-Node: Clones786656
-Node: Cut Program787924
-Node: Egrep Program798348
-Node: Id Program807647
-Node: Split Program817739
-Ref: Split Program-Footnote-1827952
-Node: Tee Program828137
-Node: Uniq Program831043
-Node: Wc Program838903
-Node: Bytes vs. Characters839298
-Node: Using extensions840898
-Node: wc program841676
-Node: Miscellaneous Programs846669
-Node: Dupword Program847894
-Node: Alarm Program849943
-Node: Translate Program854846
-Ref: Translate Program-Footnote-1859555
-Node: Labels Program859833
-Ref: Labels Program-Footnote-1863268
-Node: Word Sorting863352
-Node: History Sorting867526
-Node: Extract Program869799
-Node: Simple Sed878052
-Node: Igawk Program881262
-Ref: Igawk Program-Footnote-1896472
-Ref: Igawk Program-Footnote-2896678
-Ref: Igawk Program-Footnote-3896808
-Node: Anagram Program896935
-Node: Signature Program900021
-Node: Programs Summary901271
-Node: Programs Exercises902525
-Ref: Programs Exercises-Footnote-1907354
-Node: Advanced Features907440
-Node: Nondecimal Data909921
-Node: Boolean Typed Values911551
-Node: Array Sorting913508
-Node: Controlling Array Traversal914237
-Ref: Controlling Array Traversal-Footnote-1922740
-Node: Array Sorting Functions922862
-Ref: Array Sorting Functions-Footnote-1928959
-Node: Two-way I/O929167
-Ref: Two-way I/O-Footnote-1937138
-Ref: Two-way I/O-Footnote-2937329
-Node: TCP/IP Networking937411
-Node: Profiling940579
-Node: Persistent Memory950249
-Ref: Persistent Memory-Footnote-1959821
-Node: Extension Philosophy959952
-Node: Advanced Features Summary961479
-Node: Internationalization963745
-Node: I18N and L10N965447
-Node: Explaining gettext966142
-Ref: Explaining gettext-Footnote-1972278
-Ref: Explaining gettext-Footnote-2972471
-Node: Programmer i18n972636
-Ref: Programmer i18n-Footnote-1977748
-Node: Translator i18n977797
-Node: String Extraction978627
-Ref: String Extraction-Footnote-1979803
-Node: Printf Ordering979901
-Ref: Printf Ordering-Footnote-1982759
-Node: I18N Portability982827
-Ref: I18N Portability-Footnote-1985387
-Node: I18N Example985454
-Ref: I18N Example-Footnote-1988848
-Ref: I18N Example-Footnote-2988921
-Node: Gawk I18N989038
-Node: I18N Summary989692
-Node: Debugger991089
-Node: Debugging992109
-Node: Debugging Concepts992558
-Node: Debugging Terms994375
-Node: Awk Debugging996978
-Ref: Awk Debugging-Footnote-1997951
-Node: Sample Debugging Session998087
-Node: Debugger Invocation998637
-Node: Finding The Bug1000262
-Node: List of Debugger Commands1006894
-Node: Breakpoint Control1008271
-Node: Debugger Execution Control1012093
-Node: Viewing And Changing Data1015567
-Node: Execution Stack1019301
-Node: Debugger Info1020982
-Node: Miscellaneous Debugger Commands1025277
-Node: Readline Support1030518
-Node: Limitations1031462
-Node: Debugging Summary1034086
-Node: Namespaces1035385
-Node: Global Namespace1036512
-Node: Qualified Names1037946
-Node: Default Namespace1038981
-Node: Changing The Namespace1039754
-Node: Naming Rules1041436
-Node: Internal Name Management1043391
-Node: Namespace Example1044461
-Node: Namespace And Features1047038
-Node: Namespace Summary1048493
-Node: Arbitrary Precision Arithmetic1050004
-Node: Computer Arithmetic1051523
-Ref: table-numeric-ranges1055448
-Ref: table-floating-point-ranges1055945
-Ref: Computer Arithmetic-Footnote-11056603
-Node: Math Definitions1056660
-Ref: table-ieee-formats1059692
-Node: MPFR features1060265
-Node: MPFR On Parole1060718
-Ref: MPFR On Parole-Footnote-11061559
-Node: MPFR Intro1061718
-Node: FP Math Caution1063402
-Ref: FP Math Caution-Footnote-11064474
-Node: Inexactness of computations1064847
-Node: Inexact representation1065878
-Node: Comparing FP Values1067259
-Node: Errors accumulate1068517
-Node: Strange values1069982
-Ref: Strange values-Footnote-11072636
-Node: Getting Accuracy1072741
-Node: Try To Round1075478
-Node: Setting precision1076385
-Ref: table-predefined-precision-strings1077090
-Node: Setting the rounding mode1078974
-Ref: table-gawk-rounding-modes1079356
-Ref: Setting the rounding mode-Footnote-11083408
-Node: Arbitrary Precision Integers1083593
-Ref: Arbitrary Precision Integers-Footnote-11086803
-Node: Checking for MPFR1086956
-Node: POSIX Floating Point Problems1088446
-Ref: POSIX Floating Point Problems-Footnote-11093266
-Node: Floating point summary1093304
-Node: Dynamic Extensions1095560
-Node: Extension Intro1097157
-Node: Plugin License1098459
-Node: Extension Mechanism Outline1099272
-Ref: figure-load-extension1099723
-Ref: figure-register-new-function1101301
-Ref: figure-call-new-function1102410
-Node: Extension API Description1104525
-Node: Extension API Functions Introduction1106254
-Ref: table-api-std-headers1108148
-Node: General Data Types1112589
-Ref: General Data Types-Footnote-11121735
-Node: Memory Allocation Functions1122038
-Ref: Memory Allocation Functions-Footnote-11126753
-Node: Constructor Functions1126852
-Node: API Ownership of MPFR and GMP Values1130753
-Node: Registration Functions1132306
-Node: Extension Functions1133010
-Node: Exit Callback Functions1138584
-Node: Extension Version String1139898
-Node: Input Parsers1140593
-Node: Output Wrappers1155212
-Node: Two-way processors1160054
-Node: Printing Messages1162407
-Ref: Printing Messages-Footnote-11163618
-Node: Updating ERRNO1163771
-Node: Requesting Values1164570
-Ref: table-value-types-returned1165323
-Node: Accessing Parameters1167382
-Node: Symbol Table Access1168663
-Node: Symbol table by name1169175
-Ref: Symbol table by name-Footnote-11172376
-Node: Symbol table by cookie1172508
-Ref: Symbol table by cookie-Footnote-11176777
-Node: Cached values1176841
-Ref: Cached values-Footnote-11180473
-Node: Array Manipulation1180630
-Ref: Array Manipulation-Footnote-11181729
-Node: Array Data Types1181766
-Ref: Array Data Types-Footnote-11184584
-Node: Array Functions1184680
-Node: Flattening Arrays1189709
-Node: Creating Arrays1196757
-Node: Redirection API1201599
-Node: Extension API Variables1204616
-Node: Extension Versioning1205339
-Ref: gawk-api-version1205768
-Node: Extension GMP/MPFR Versioning1207555
-Node: Extension API Informational Variables1209259
-Node: Extension API Boilerplate1210512
-Node: Changes from API V11214642
-Node: Finding Extensions1216274
-Node: Extension Example1216849
-Node: Internal File Description1217671
-Node: Internal File Ops1221963
-Ref: Internal File Ops-Footnote-11233513
-Node: Using Internal File Ops1233661
-Ref: Using Internal File Ops-Footnote-11236094
-Node: Extension Samples1236372
-Node: Extension Sample File Functions1237941
-Node: Extension Sample Fnmatch1246066
-Node: Extension Sample Fork1247661
-Node: Extension Sample Inplace1248937
-Node: Extension Sample Ord1253039
-Node: Extension Sample Readdir1253915
-Ref: table-readdir-file-types1254704
-Node: Extension Sample Revout1256060
-Node: Extension Sample Rev2way1256657
-Node: Extension Sample Read write array1257409
-Node: Extension Sample Readfile1260683
-Node: Extension Sample Time1261814
-Node: Extension Sample API Tests1263814
-Node: gawkextlib1264322
-Node: Extension summary1267354
-Node: Extension Exercises1271202
-Node: Language History1272472
-Node: V7/SVR3.11274184
-Node: SVR41276534
-Node: POSIX1278066
-Node: BTL1279491
-Node: POSIX/GNU1280258
-Ref: Gawk Extension Functions1283648
-Node: Feature History1287072
-Node: Common Extensions1306913
-Node: Ranges and Locales1308388
-Ref: Ranges and Locales-Footnote-11313173
-Ref: Ranges and Locales-Footnote-21313200
-Ref: Ranges and Locales-Footnote-31313435
-Node: Contributors1313658
-Node: History summary1320010
-Node: Installation1321452
-Node: Gawk Distribution1322416
-Node: Getting1322908
-Node: Extracting1323907
-Node: Distribution contents1325613
-Node: Unix Installation1333503
-Node: Quick Installation1334323
-Node: Compiling with MPFR1336863
-Node: Shell Startup Files1337569
-Node: Additional Configuration Options1338726
-Node: Configuration Philosophy1341109
-Node: Compiling from Git1343609
-Node: Building the Documentation1344168
-Node: Non-Unix Installation1345580
-Node: PC Installation1346056
-Node: PC Binary Installation1346925
-Node: PC Compiling1347818
-Node: PC Using1348996
-Node: Cygwin1352712
-Node: MSYS1353964
-Node: OpenVMS Installation1354590
-Node: OpenVMS Compilation1355271
-Ref: OpenVMS Compilation-Footnote-11356754
-Node: OpenVMS Dynamic Extensions1356812
-Node: OpenVMS Installation Details1358448
-Node: OpenVMS Running1360879
-Node: OpenVMS GNV1365016
-Node: Bugs1365771
-Node: Bug definition1366691
-Node: Bug address1370292
-Node: Usenet1373861
-Node: Performance bugs1375074
-Node: Asking for help1378078
-Node: Maintainers1380065
-Node: Other Versions1381092
-Node: Installation summary1391081
-Node: Notes1392463
-Node: Compatibility Mode1393273
-Node: Additions1394095
-Node: Accessing The Source1395040
-Node: Adding Code1396571
-Node: New Ports1403682
-Node: Derived Files1408185
-Ref: Derived Files-Footnote-11413996
-Ref: Derived Files-Footnote-21414031
-Ref: Derived Files-Footnote-31414642
-Node: Future Extensions1414756
-Node: Implementation Limitations1415426
-Node: Extension Design1416668
-Node: Old Extension Problems1417828
-Ref: Old Extension Problems-Footnote-11419400
-Node: Extension New Mechanism Goals1419461
-Ref: Extension New Mechanism Goals-Footnote-11422931
-Node: Extension Other Design Decisions1423132
-Node: Extension Future Growth1425329
-Node: Notes summary1425949
-Node: Basic Concepts1427159
-Node: Basic High Level1427844
-Ref: figure-general-flow1428126
-Ref: figure-process-flow1428828
-Ref: Basic High Level-Footnote-11432198
-Node: Basic Data Typing1432387
-Node: Glossary1435795
-Node: Copying1468673
-Node: GNU Free Documentation License1506231
-Node: Index1531354
+Ref: table-char-classes197692
+Ref: Bracket Expressions-Footnote-1201226
+Node: Leftmost Longest201495
+Node: Computed Regexps202851
+Node: GNU Regexp Operators206366
+Node: Case-sensitivity211463
+Ref: Case-sensitivity-Footnote-1214413
+Ref: Case-sensitivity-Footnote-2214656
+Node: Regexp Summary214768
+Node: Reading Files216290
+Node: Records218609
+Node: awk split records219884
+Node: gawk split records224766
+Ref: gawk split records-Footnote-1230054
+Node: Fields230091
+Ref: Fields-Footnote-1233007
+Node: Nonconstant Fields233127
+Ref: Nonconstant Fields-Footnote-1235435
+Node: Changing Fields235651
+Node: Field Separators241949
+Node: Default Field Splitting244818
+Node: Regexp Field Splitting245960
+Node: Single Character Fields249789
+Node: Comma Separated Fields250878
+Ref: table-csv-examples252282
+Node: Command Line Field Separator254581
+Node: Full Line Fields257957
+Ref: Full Line Fields-Footnote-1259535
+Ref: Full Line Fields-Footnote-2259581
+Node: Field Splitting Summary259686
+Node: Constant Size262003
+Node: Fixed width data262747
+Node: Skipping intervening266262
+Node: Allowing trailing data267064
+Node: Fields with fixed data268125
+Node: Splitting By Content269747
+Ref: Splitting By Content-Footnote-1275247
+Node: FS versus FPAT275410
+Node: Testing field creation276593
+Node: Multiple Line278367
+Node: Getline284836
+Node: Plain Getline287424
+Node: Getline/Variable290072
+Node: Getline/File291268
+Node: Getline/Variable/File292716
+Ref: Getline/Variable/File-Footnote-1294361
+Node: Getline/Pipe294457
+Node: Getline/Variable/Pipe297265
+Node: Getline/Coprocess298448
+Node: Getline/Variable/Coprocess299771
+Node: Getline Notes300537
+Node: Getline Summary304514
+Ref: table-getline-variants304958
+Node: Read Timeout305862
+Ref: Read Timeout-Footnote-1309824
+Node: Retrying Input309882
+Node: Command-line directories311149
+Node: Input Summary312087
+Node: Input Exercises315467
+Node: Printing315905
+Node: Print317848
+Node: Print Examples319349
+Node: Output Separators322194
+Node: OFMT324301
+Node: Printf326014
+Node: Basic Printf326819
+Node: Control Letters328454
+Node: Format Modifiers333900
+Node: Printf Examples340172
+Node: Redirection342713
+Node: Special FD350485
+Ref: Special FD-Footnote-1353783
+Node: Special Files353861
+Node: Other Inherited Files354490
+Node: Special Network355555
+Node: Special Caveats356443
+Node: Close Files And Pipes357426
+Ref: Close Files And Pipes-Footnote-1363550
+Node: Close Return Value363698
+Ref: table-close-pipe-return-values364969
+Ref: Close Return Value-Footnote-1365800
+Node: Noflush365956
+Node: Nonfatal367464
+Node: Output Summary369879
+Node: Output Exercises371165
+Node: Expressions371856
+Node: Values373056
+Node: Constants373734
+Node: Scalar Constants374429
+Ref: Scalar Constants-Footnote-1377005
+Ref: Scalar Constants-Footnote-2377255
+Node: Nondecimal-numbers377335
+Node: Regexp Constants380448
+Node: Using Constant Regexps380994
+Node: Standard Regexp Constants381640
+Node: Strong Regexp Constants384936
+Node: Variables388779
+Node: Using Variables389444
+Node: Assignment Options391418
+Node: Conversion393969
+Node: Strings And Numbers394501
+Ref: Strings And Numbers-Footnote-1397711
+Node: Locale influences conversions397820
+Ref: table-locale-affects400658
+Node: All Operators401300
+Node: Arithmetic Ops401941
+Node: Concatenation404764
+Ref: Concatenation-Footnote-1407700
+Node: Assignment Ops407819
+Ref: table-assign-ops412946
+Node: Increment Ops414327
+Node: Truth Values and Conditions417918
+Node: Truth Values419012
+Node: Typing and Comparison420092
+Node: Variable Typing420924
+Ref: Variable Typing-Footnote-1427568
+Ref: Variable Typing-Footnote-2427648
+Node: Comparison Operators427729
+Ref: table-relational-ops428156
+Node: POSIX String Comparison431832
+Ref: POSIX String Comparison-Footnote-1433589
+Ref: POSIX String Comparison-Footnote-2433732
+Node: Boolean Ops433816
+Ref: Boolean Ops-Footnote-1438490
+Node: Conditional Exp438586
+Node: Function Calls440366
+Node: Precedence444313
+Node: Locales448176
+Node: Expressions Summary449852
+Node: Patterns and Actions452507
+Node: Pattern Overview453643
+Node: Regexp Patterns455368
+Node: Expression Patterns455914
+Node: Ranges459819
+Node: BEGIN/END462993
+Node: Using BEGIN/END463802
+Ref: Using BEGIN/END-Footnote-1466710
+Node: I/O And BEGIN/END466820
+Node: BEGINFILE/ENDFILE469302
+Node: Empty472732
+Node: Using Shell Variables473049
+Node: Action Overview475385
+Node: Statements477821
+Node: If Statement479717
+Node: While Statement481280
+Node: Do Statement483368
+Node: For Statement484552
+Node: Switch Statement487907
+Node: Break Statement490456
+Node: Continue Statement492648
+Node: Next Statement494579
+Node: Nextfile Statement497058
+Node: Exit Statement499911
+Node: Built-in Variables502438
+Node: User-modified503615
+Node: Auto-set511822
+Ref: Auto-set-Footnote-1529906
+Ref: Auto-set-Footnote-2530124
+Node: ARGC and ARGV530180
+Node: Pattern Action Summary534609
+Node: Arrays537215
+Node: Array Basics538588
+Node: Array Intro539436
+Ref: figure-array-elements541447
+Ref: Array Intro-Footnote-1544300
+Node: Reference to Elements544432
+Node: Assigning Elements546952
+Node: Array Example547447
+Node: Scanning an Array549409
+Node: Controlling Scanning552504
+Ref: Controlling Scanning-Footnote-1559139
+Node: Numeric Array Subscripts559463
+Node: Uninitialized Subscripts561731
+Node: Delete563404
+Ref: Delete-Footnote-1566216
+Node: Multidimensional566273
+Node: Multiscanning569476
+Node: Arrays of Arrays571143
+Node: Arrays Summary575447
+Node: Functions577634
+Node: Built-in578836
+Node: Calling Built-in580025
+Node: Boolean Functions582065
+Node: Numeric Functions582627
+Ref: Numeric Functions-Footnote-1586812
+Ref: Numeric Functions-Footnote-2587495
+Ref: Numeric Functions-Footnote-3587547
+Node: String Functions587823
+Ref: String Functions-Footnote-1614274
+Ref: String Functions-Footnote-2614406
+Ref: String Functions-Footnote-3614662
+Node: Gory Details614749
+Ref: table-sub-escapes616758
+Ref: table-sub-proposed618310
+Ref: table-posix-sub619784
+Ref: table-gensub-escapes621436
+Ref: Gory Details-Footnote-1622264
+Node: I/O Functions622418
+Ref: table-system-return-values629094
+Ref: I/O Functions-Footnote-1631256
+Ref: I/O Functions-Footnote-2631404
+Node: Time Functions631524
+Ref: Time Functions-Footnote-1643236
+Ref: Time Functions-Footnote-2643304
+Ref: Time Functions-Footnote-3643466
+Ref: Time Functions-Footnote-4643577
+Ref: Time Functions-Footnote-5643693
+Ref: Time Functions-Footnote-6643920
+Node: Bitwise Functions644198
+Ref: table-bitwise-ops644796
+Ref: Bitwise Functions-Footnote-1651038
+Ref: Bitwise Functions-Footnote-2651215
+Node: Type Functions651410
+Node: I18N Functions653581
+Node: User-defined655316
+Node: Definition Syntax656062
+Ref: Definition Syntax-Footnote-1661917
+Node: Function Example661992
+Ref: Function Example-Footnote-1664971
+Node: Function Calling664993
+Node: Calling A Function665585
+Node: Variable Scope666555
+Node: Pass By Value/Reference669609
+Node: Function Caveats672337
+Ref: Function Caveats-Footnote-1674428
+Node: Return Statement674548
+Node: Dynamic Typing677580
+Node: Dynamic Typing Awk678162
+Node: Dynamic Typing Gawk680300
+Node: Shadowed Variables683670
+Node: Indirect Calls686018
+Node: Functions Summary697159
+Node: Library Functions700125
+Ref: Library Functions-Footnote-1703673
+Ref: Library Functions-Footnote-2703818
+Node: Library Names703993
+Ref: Library Names-Footnote-1707764
+Ref: Library Names-Footnote-2707991
+Node: General Functions708085
+Node: Strtonum Function709355
+Node: Assert Function712437
+Node: Round Function715887
+Node: Cliff Random Function717459
+Node: Ordinal Functions718483
+Ref: Ordinal Functions-Footnote-1721586
+Ref: Ordinal Functions-Footnote-2721838
+Node: Join Function722052
+Ref: Join Function-Footnote-1723850
+Node: Getlocaltime Function724054
+Node: Readfile Function727828
+Node: Shell Quoting729857
+Node: Isnumeric Function731313
+Node: To CSV Function732749
+Node: Data File Management734841
+Node: Filetrans Function735473
+Node: Rewind Function739749
+Node: File Checking741720
+Ref: File Checking-Footnote-1743086
+Node: Empty Files743291
+Node: Ignoring Assigns745354
+Node: Getopt Function746928
+Ref: Getopt Function-Footnote-1762746
+Node: Passwd Functions762958
+Ref: Passwd Functions-Footnote-1772093
+Node: Group Functions772181
+Ref: Group Functions-Footnote-1780305
+Node: Walking Arrays780516
+Node: Library Functions Summary783562
+Node: Library Exercises784982
+Node: Sample Programs785467
+Node: Running Examples786249
+Node: Clones787001
+Node: Cut Program788269
+Node: Egrep Program798693
+Node: Id Program807992
+Node: Split Program818084
+Ref: Split Program-Footnote-1828297
+Node: Tee Program828482
+Node: Uniq Program831388
+Node: Wc Program839248
+Node: Bytes vs. Characters839643
+Node: Using extensions841243
+Node: wc program842021
+Node: Miscellaneous Programs847014
+Node: Dupword Program848239
+Node: Alarm Program850288
+Node: Translate Program855191
+Ref: Translate Program-Footnote-1859900
+Node: Labels Program860178
+Ref: Labels Program-Footnote-1863613
+Node: Word Sorting863697
+Node: History Sorting867871
+Node: Extract Program870144
+Node: Simple Sed878397
+Node: Igawk Program881607
+Ref: Igawk Program-Footnote-1896817
+Ref: Igawk Program-Footnote-2897023
+Ref: Igawk Program-Footnote-3897153
+Node: Anagram Program897280
+Node: Signature Program900366
+Node: Programs Summary901616
+Node: Programs Exercises902870
+Ref: Programs Exercises-Footnote-1907699
+Node: Advanced Features907785
+Node: Nondecimal Data910266
+Node: Boolean Typed Values911896
+Node: Array Sorting913853
+Node: Controlling Array Traversal914582
+Ref: Controlling Array Traversal-Footnote-1923085
+Node: Array Sorting Functions923207
+Ref: Array Sorting Functions-Footnote-1929304
+Node: Two-way I/O929512
+Ref: Two-way I/O-Footnote-1937483
+Ref: Two-way I/O-Footnote-2937674
+Node: TCP/IP Networking937756
+Node: Profiling940924
+Node: Persistent Memory950594
+Ref: Persistent Memory-Footnote-1960166
+Node: Extension Philosophy960297
+Node: Advanced Features Summary961824
+Node: Internationalization964090
+Node: I18N and L10N965792
+Node: Explaining gettext966487
+Ref: Explaining gettext-Footnote-1972623
+Ref: Explaining gettext-Footnote-2972816
+Node: Programmer i18n972981
+Ref: Programmer i18n-Footnote-1978093
+Node: Translator i18n978142
+Node: String Extraction978972
+Ref: String Extraction-Footnote-1980148
+Node: Printf Ordering980246
+Ref: Printf Ordering-Footnote-1983104
+Node: I18N Portability983172
+Ref: I18N Portability-Footnote-1985732
+Node: I18N Example985799
+Ref: I18N Example-Footnote-1989193
+Ref: I18N Example-Footnote-2989266
+Node: Gawk I18N989383
+Node: I18N Summary990037
+Node: Debugger991434
+Node: Debugging992454
+Node: Debugging Concepts992903
+Node: Debugging Terms994720
+Node: Awk Debugging997323
+Ref: Awk Debugging-Footnote-1998296
+Node: Sample Debugging Session998432
+Node: Debugger Invocation998982
+Node: Finding The Bug1000607
+Node: List of Debugger Commands1007239
+Node: Breakpoint Control1008616
+Node: Debugger Execution Control1012438
+Node: Viewing And Changing Data1015912
+Node: Execution Stack1019646
+Node: Debugger Info1021327
+Node: Miscellaneous Debugger Commands1025622
+Node: Readline Support1030863
+Node: Limitations1031807
+Node: Debugging Summary1034431
+Node: Namespaces1035730
+Node: Global Namespace1036857
+Node: Qualified Names1038291
+Node: Default Namespace1039326
+Node: Changing The Namespace1040099
+Node: Naming Rules1041781
+Node: Internal Name Management1043736
+Node: Namespace Example1044806
+Node: Namespace And Features1047383
+Node: Namespace Summary1048838
+Node: Arbitrary Precision Arithmetic1050349
+Node: Computer Arithmetic1051868
+Ref: table-numeric-ranges1055793
+Ref: table-floating-point-ranges1056290
+Ref: Computer Arithmetic-Footnote-11056948
+Node: Math Definitions1057005
+Ref: table-ieee-formats1060037
+Node: MPFR features1060610
+Node: MPFR On Parole1061063
+Ref: MPFR On Parole-Footnote-11061904
+Node: MPFR Intro1062063
+Node: FP Math Caution1063747
+Ref: FP Math Caution-Footnote-11064819
+Node: Inexactness of computations1065192
+Node: Inexact representation1066223
+Node: Comparing FP Values1067604
+Node: Errors accumulate1068862
+Node: Strange values1070327
+Ref: Strange values-Footnote-11072981
+Node: Getting Accuracy1073086
+Node: Try To Round1075823
+Node: Setting precision1076730
+Ref: table-predefined-precision-strings1077435
+Node: Setting the rounding mode1079319
+Ref: table-gawk-rounding-modes1079701
+Ref: Setting the rounding mode-Footnote-11083753
+Node: Arbitrary Precision Integers1083938
+Ref: Arbitrary Precision Integers-Footnote-11087148
+Node: Checking for MPFR1087301
+Node: POSIX Floating Point Problems1088791
+Ref: POSIX Floating Point Problems-Footnote-11093611
+Node: Floating point summary1093649
+Node: Dynamic Extensions1095905
+Node: Extension Intro1097502
+Node: Plugin License1098804
+Node: Extension Mechanism Outline1099617
+Ref: figure-load-extension1100068
+Ref: figure-register-new-function1101646
+Ref: figure-call-new-function1102755
+Node: Extension API Description1104870
+Node: Extension API Functions Introduction1106599
+Ref: table-api-std-headers1108493
+Node: General Data Types1112934
+Ref: General Data Types-Footnote-11122080
+Node: Memory Allocation Functions1122383
+Ref: Memory Allocation Functions-Footnote-11127098
+Node: Constructor Functions1127197
+Node: API Ownership of MPFR and GMP Values1131098
+Node: Registration Functions1132651
+Node: Extension Functions1133355
+Node: Exit Callback Functions1138929
+Node: Extension Version String1140243
+Node: Input Parsers1140938
+Node: Output Wrappers1155557
+Node: Two-way processors1160399
+Node: Printing Messages1162752
+Ref: Printing Messages-Footnote-11163963
+Node: Updating ERRNO1164116
+Node: Requesting Values1164915
+Ref: table-value-types-returned1165668
+Node: Accessing Parameters1167727
+Node: Symbol Table Access1169008
+Node: Symbol table by name1169520
+Ref: Symbol table by name-Footnote-11172721
+Node: Symbol table by cookie1172853
+Ref: Symbol table by cookie-Footnote-11177122
+Node: Cached values1177186
+Ref: Cached values-Footnote-11180818
+Node: Array Manipulation1180975
+Ref: Array Manipulation-Footnote-11182074
+Node: Array Data Types1182111
+Ref: Array Data Types-Footnote-11184929
+Node: Array Functions1185025
+Node: Flattening Arrays1190054
+Node: Creating Arrays1197102
+Node: Redirection API1201944
+Node: Extension API Variables1204961
+Node: Extension Versioning1205684
+Ref: gawk-api-version1206113
+Node: Extension GMP/MPFR Versioning1207900
+Node: Extension API Informational Variables1209604
+Node: Extension API Boilerplate1210857
+Node: Changes from API V11214987
+Node: Finding Extensions1216619
+Node: Extension Example1217194
+Node: Internal File Description1218016
+Node: Internal File Ops1222308
+Ref: Internal File Ops-Footnote-11233858
+Node: Using Internal File Ops1234006
+Ref: Using Internal File Ops-Footnote-11236439
+Node: Extension Samples1236717
+Node: Extension Sample File Functions1238286
+Node: Extension Sample Fnmatch1246411
+Node: Extension Sample Fork1248006
+Node: Extension Sample Inplace1249282
+Node: Extension Sample Ord1253384
+Node: Extension Sample Readdir1254260
+Ref: table-readdir-file-types1255049
+Node: Extension Sample Revout1256405
+Node: Extension Sample Rev2way1257002
+Node: Extension Sample Read write array1257754
+Node: Extension Sample Readfile1261028
+Node: Extension Sample Time1262159
+Node: Extension Sample API Tests1264159
+Node: gawkextlib1264667
+Node: Extension summary1267699
+Node: Extension Exercises1271547
+Node: Language History1272817
+Node: V7/SVR3.11274529
+Node: SVR41276879
+Node: POSIX1278411
+Node: BTL1279836
+Node: POSIX/GNU1280603
+Ref: Gawk Extension Functions1283993
+Node: Feature History1287417
+Node: Common Extensions1307258
+Node: Ranges and Locales1308733
+Ref: Ranges and Locales-Footnote-11313518
+Ref: Ranges and Locales-Footnote-21313545
+Ref: Ranges and Locales-Footnote-31313780
+Node: Contributors1314003
+Node: History summary1320355
+Node: Installation1321797
+Node: Gawk Distribution1322761
+Node: Getting1323253
+Node: Extracting1324252
+Node: Distribution contents1325958
+Node: Unix Installation1333848
+Node: Quick Installation1334668
+Node: Compiling with MPFR1337208
+Node: Shell Startup Files1337914
+Node: Additional Configuration Options1339071
+Node: Configuration Philosophy1341454
+Node: Compiling from Git1343954
+Node: Building the Documentation1344513
+Node: Non-Unix Installation1345925
+Node: PC Installation1346401
+Node: PC Binary Installation1347270
+Node: PC Compiling1348163
+Node: PC Using1349341
+Node: Cygwin1353057
+Node: MSYS1354309
+Node: OpenVMS Installation1354935
+Node: OpenVMS Compilation1355616
+Ref: OpenVMS Compilation-Footnote-11357099
+Node: OpenVMS Dynamic Extensions1357157
+Node: OpenVMS Installation Details1358793
+Node: OpenVMS Running1361224
+Node: OpenVMS GNV1365361
+Node: Bugs1366116
+Node: Bug definition1367036
+Node: Bug address1370637
+Node: Usenet1374206
+Node: Performance bugs1375419
+Node: Asking for help1378423
+Node: Maintainers1380410
+Node: Other Versions1381437
+Node: Installation summary1391426
+Node: Notes1392808
+Node: Compatibility Mode1393618
+Node: Additions1394440
+Node: Accessing The Source1395385
+Node: Adding Code1396916
+Node: New Ports1404027
+Node: Derived Files1408530
+Ref: Derived Files-Footnote-11414341
+Ref: Derived Files-Footnote-21414376
+Ref: Derived Files-Footnote-31414987
+Node: Future Extensions1415101
+Node: Implementation Limitations1415771
+Node: Extension Design1417013
+Node: Old Extension Problems1418173
+Ref: Old Extension Problems-Footnote-11419745
+Node: Extension New Mechanism Goals1419806
+Ref: Extension New Mechanism Goals-Footnote-11423276
+Node: Extension Other Design Decisions1423477
+Node: Extension Future Growth1425674
+Node: Notes summary1426294
+Node: Basic Concepts1427504
+Node: Basic High Level1428189
+Ref: figure-general-flow1428471
+Ref: figure-process-flow1429173
+Ref: Basic High Level-Footnote-11432543
+Node: Basic Data Typing1432732
+Node: Glossary1436140
+Node: Copying1469018
+Node: GNU Free Documentation License1506576
+Node: Index1531699
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a78eb6d9..3eb42390 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -6105,7 +6105,7 @@ escape sequences inside bracket expressions are taken to 
represent
 only single-byte characters (characters whose values fit within
 the range 0--256).  To match a range of characters where the endpoints
 of the range are larger than 256, enter the multibyte encodings of
-the characters directly.
+the characters directly, or use the @code{\u} escape sequence.
 
 @cindex @code{\} (backslash) @subentry in bracket expressions
 @cindex backslash (@code{\}) @subentry in bracket expressions
@@ -6132,7 +6132,12 @@ characters to be matched.
 @cindex @command{egrep} utility
 The treatment of @samp{\} in bracket expressions
 is compatible with other @command{awk}
-implementations and is also mandated by POSIX.
+implementations and is also mandated by POSIX.@footnote{See
+@uref{https://pubs.opengroup.org/onlinepubs/9799919799/utilities/awk.html#tag_20_06_13_04,
+the POSIX standard for @command{awk}}.
+The standard doesn't relate to the case
+of @samp{\]}, but it does explicitly relate to @samp{\}
+before a regular expression metacharacter.}
 The regular expressions in @command{awk} are a superset
 of the POSIX specification for Extended Regular Expressions (EREs).
 POSIX EREs are based on the regular expressions accepted by the
@@ -6182,28 +6187,6 @@ With the POSIX character classes, you can write
 @code{/[[:alnum:]]/} to match the alphabetic
 and numeric characters in your character set.
 
-@ignore
-From eliz@gnu.org  Fri Feb 15 03:38:41 2019
-Date: Fri, 15 Feb 2019 12:38:23 +0200
-From: Eli Zaretskii <eliz@gnu.org>
-To: arnold@skeeve.com
-CC: pengyu.ut@gmail.com, bug-gawk@gnu.org
-Subject: Re: [bug-gawk] Does gawk character classes follow this?
-
-> From: arnold@skeeve.com
-> Date: Fri, 15 Feb 2019 03:01:34 -0700
-> Cc: pengyu.ut@gmail.com, bug-gawk@gnu.org
->
-> I get the feeling that there's something really bothering you, but
-> I don't understand what.
->
-> Can you clarify, please?
-
-I thought I already did: we cannot be expected to provide a definitive
-description of what the named classes stand for, because the answer
-depends on various factors out of our control.
-@end ignore
-
 @c Thanks to
 @c Date: Tue, 01 Jul 2014 07:39:51 +0200
 @c From: Hermann Peifer <peifer@gmx.eu>

-----------------------------------------------------------------------

Summary of changes:
 doc/ChangeLog |    6 +
 doc/gawk.info | 1122 +++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi |   31 +-
 3 files changed, 578 insertions(+), 581 deletions(-)


hooks/post-receive
-- 
gawk