[gawk-diffs] [SCM] gawk branch, feature/namespaces, updated. gawk-4.1.0-3837-g6bcc48b

[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, feature/namespaces has been updated
       via  6bcc48bb0eefff5f0263a9569973a0b33ebed4cd (commit)
      from  17e79e71846c38a3f32e424ec8b23a31c5695a08 (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=6bcc48bb0eefff5f0263a9569973a0b33ebed4cd

commit 6bcc48bb0eefff5f0263a9569973a0b33ebed4cd
Author: Arnold D. Robbins <address@hidden>
Date:   Mon Dec 31 21:43:56 2018 +0200

    Some namespace doc fixes.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 73fdea2..ee7b4ba 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2018-12-31         Arnold D. Robbins     <address@hidden>
+
+       * gawktexi.in: A few fixes w.r.t. namespaces. Thanks to
+       Antonio Giovanni Colombo for pointing out the problems.
+
 2018-12-18         Arnold D. Robbins     <address@hidden>
 
        * gawktexi.in: Added more indexing to the debugger chapter.
diff --git a/doc/gawk.info b/doc/gawk.info
index 2421363..5ed291a 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -22736,7 +22736,8 @@ File: gawk.info,  Node: Global Namespace,  Next: 
Qualified Names,  Up: Namespace
 In standard 'awk', there is a single, global, "namespace".  This means
 that _all_ function names and global variable names must be unique.  For
 example, two different 'awk' source files cannot both define a function
-named 'min()', or define an array named 'data'.
+named 'min()', or define the same identifier, used as a scalar in one
+and as an array in the other.
 
    This situation is okay when programs are small, say a few hundred
 lines, or even a few thousand, but it prevents the development of
@@ -24892,9 +24893,11 @@ register it with 'gawk' using this API function:
 
 'awk_bool_t add_ext_func(const char *name_space, awk_ext_func_t *func);'
      This function returns true upon success, false otherwise.  The
-     'name_space' parameter is currently not used; you should pass in an
-     empty string ('""').  The 'func' pointer is the address of a
-     'struct' representing your function, as just described.
+     'name_space' parameter is the namespace in which to place the
+     function (*note Namespaces::).  Use an empty string ('""') or
+     '"awk"' to place the function in the default 'awk' namespace.  The
+     'func' pointer is the address of a 'struct' representing your
+     function, as just described.
 
      'gawk' does not modify what 'func' points to, but the extension
      function itself receives this pointer and can modify what it points
@@ -35592,7 +35595,7 @@ Index
 * minimum precision required by MPFR library: Auto-set.       (line 279)
 * mktime:                                Time Functions.      (line  25)
 * modifiers, in format specifiers:       Format Modifiers.    (line   6)
-* module, definition of:                 Global Namespace.    (line  17)
+* module, definition of:                 Global Namespace.    (line  18)
 * monetary information, localization:    Explaining gettext.  (line 104)
 * Moore, Duncan:                         Getline Notes.       (line  40)
 * MPFR, checking availability of:        Checking for MPFR.   (line   6)
@@ -35794,7 +35797,7 @@ Index
 * output, standard:                      Special FD.          (line   6)
 * p debugger command (alias for print):  Viewing And Changing Data.
                                                               (line  35)
-* package, definition of:                Global Namespace.    (line  17)
+* package, definition of:                Global Namespace.    (line  18)
 * Papadopoulos, Panos:                   Contributors.        (line 131)
 * parent process ID of gawk process:     Auto-set.            (line 251)
 * parentheses (), in a profile:          Profiling.           (line 146)
@@ -37112,190 +37115,190 @@ Node: Limitations916880
 Node: Debugging Summary918989
 Node: Namespaces920268
 Node: Global Namespace921086
-Node: Qualified Names922432
-Node: Default Namespace923431
-Node: Changing The Namespace924172
-Node: Naming Rules925786
-Node: Internal Name Management927634
-Node: Namespace Example928676
-Node: Namespace And Features931238
-Node: Namespace Summary932673
-Node: Arbitrary Precision Arithmetic934150
-Node: Computer Arithmetic935637
-Ref: table-numeric-ranges939403
-Ref: table-floating-point-ranges939896
-Ref: Computer Arithmetic-Footnote-1940554
-Node: Math Definitions940611
-Ref: table-ieee-formats943927
-Ref: Math Definitions-Footnote-1944530
-Node: MPFR features944635
-Node: FP Math Caution946353
-Ref: FP Math Caution-Footnote-1947425
-Node: Inexactness of computations947794
-Node: Inexact representation948754
-Node: Comparing FP Values950114
-Node: Errors accumulate951355
-Node: Getting Accuracy952788
-Node: Try To Round955498
-Node: Setting precision956397
-Ref: table-predefined-precision-strings957094
-Node: Setting the rounding mode958924
-Ref: table-gawk-rounding-modes959298
-Ref: Setting the rounding mode-Footnote-1963229
-Node: Arbitrary Precision Integers963408
-Ref: Arbitrary Precision Integers-Footnote-1966583
-Node: Checking for MPFR966732
-Node: POSIX Floating Point Problems968206
-Ref: POSIX Floating Point Problems-Footnote-1972491
-Node: Floating point summary972529
-Node: Dynamic Extensions974719
-Node: Extension Intro976272
-Node: Plugin License977538
-Node: Extension Mechanism Outline978335
-Ref: figure-load-extension978774
-Ref: figure-register-new-function980339
-Ref: figure-call-new-function981431
-Node: Extension API Description983493
-Node: Extension API Functions Introduction985135
-Ref: table-api-std-headers986971
-Node: General Data Types990836
-Ref: General Data Types-Footnote-1999197
-Node: Memory Allocation Functions999496
-Ref: Memory Allocation Functions-Footnote-11003706
-Node: Constructor Functions1003805
-Node: Registration Functions1007391
-Node: Extension Functions1008076
-Node: Exit Callback Functions1013291
-Node: Extension Version String1014541
-Node: Input Parsers1015204
-Node: Output Wrappers1027925
-Node: Two-way processors1032437
-Node: Printing Messages1034702
-Ref: Printing Messages-Footnote-11035873
-Node: Updating ERRNO1036026
-Node: Requesting Values1036765
-Ref: table-value-types-returned1037502
-Node: Accessing Parameters1038438
-Node: Symbol Table Access1039673
-Node: Symbol table by name1040185
-Ref: Symbol table by name-Footnote-11043208
-Node: Symbol table by cookie1043336
-Ref: Symbol table by cookie-Footnote-11047521
-Node: Cached values1047585
-Ref: Cached values-Footnote-11051121
-Node: Array Manipulation1051274
-Ref: Array Manipulation-Footnote-11052365
-Node: Array Data Types1052402
-Ref: Array Data Types-Footnote-11055060
-Node: Array Functions1055152
-Node: Flattening Arrays1059650
-Node: Creating Arrays1066626
-Node: Redirection API1071393
-Node: Extension API Variables1074226
-Node: Extension Versioning1074937
-Ref: gawk-api-version1075366
-Node: Extension GMP/MPFR Versioning1077097
-Node: Extension API Informational Variables1078725
-Node: Extension API Boilerplate1079798
-Node: Changes from API V11083772
-Node: Finding Extensions1085344
-Node: Extension Example1085903
-Node: Internal File Description1086701
-Node: Internal File Ops1090781
-Ref: Internal File Ops-Footnote-11102131
-Node: Using Internal File Ops1102271
-Ref: Using Internal File Ops-Footnote-11104654
-Node: Extension Samples1104928
-Node: Extension Sample File Functions1106457
-Node: Extension Sample Fnmatch1114106
-Node: Extension Sample Fork1115593
-Node: Extension Sample Inplace1116811
-Node: Extension Sample Ord1120115
-Node: Extension Sample Readdir1120951
-Ref: table-readdir-file-types1121840
-Node: Extension Sample Revout1122645
-Node: Extension Sample Rev2way1123234
-Node: Extension Sample Read write array1123974
-Node: Extension Sample Readfile1125916
-Node: Extension Sample Time1127011
-Node: Extension Sample API Tests1128359
-Node: gawkextlib1128851
-Node: Extension summary1131769
-Node: Extension Exercises1135471
-Node: Language History1136713
-Node: V7/SVR3.11138369
-Node: SVR41140521
-Node: POSIX1141955
-Node: BTL1143335
-Node: POSIX/GNU1144064
-Node: Feature History1149842
-Node: Common Extensions1165888
-Node: Ranges and Locales1167171
-Ref: Ranges and Locales-Footnote-11171787
-Ref: Ranges and Locales-Footnote-21171814
-Ref: Ranges and Locales-Footnote-31172049
-Node: Contributors1172270
-Node: History summary1178215
-Node: Installation1179595
-Node: Gawk Distribution1180539
-Node: Getting1181023
-Node: Extracting1181986
-Node: Distribution contents1183624
-Node: Unix Installation1190104
-Node: Quick Installation1190786
-Node: Shell Startup Files1193200
-Node: Additional Configuration Options1194289
-Node: Configuration Philosophy1196454
-Node: Non-Unix Installation1198823
-Node: PC Installation1199283
-Node: PC Binary Installation1200121
-Node: PC Compiling1200556
-Node: PC Using1201673
-Node: Cygwin1205226
-Node: MSYS1206325
-Node: VMS Installation1206826
-Node: VMS Compilation1207617
-Ref: VMS Compilation-Footnote-11208846
-Node: VMS Dynamic Extensions1208904
-Node: VMS Installation Details1210589
-Node: VMS Running1212842
-Node: VMS GNV1217121
-Node: VMS Old Gawk1217856
-Node: Bugs1218327
-Node: Bug address1218990
-Node: Usenet1221972
-Node: Maintainers1222976
-Node: Other Versions1224237
-Node: Installation summary1231151
-Node: Notes1232353
-Node: Compatibility Mode1233147
-Node: Additions1233929
-Node: Accessing The Source1234854
-Node: Adding Code1236291
-Node: New Ports1242510
-Node: Derived Files1246998
-Ref: Derived Files-Footnote-11252644
-Ref: Derived Files-Footnote-21252679
-Ref: Derived Files-Footnote-31253277
-Node: Future Extensions1253391
-Node: Implementation Limitations1254049
-Node: Extension Design1255232
-Node: Old Extension Problems1256376
-Ref: Old Extension Problems-Footnote-11257894
-Node: Extension New Mechanism Goals1257951
-Ref: Extension New Mechanism Goals-Footnote-11261315
-Node: Extension Other Design Decisions1261504
-Node: Extension Future Growth1263617
-Node: Notes summary1264453
-Node: Basic Concepts1265628
-Node: Basic High Level1266309
-Ref: figure-general-flow1266591
-Ref: figure-process-flow1267276
-Ref: Basic High Level-Footnote-11270577
-Node: Basic Data Typing1270762
-Node: Glossary1274090
-Node: Copying1305928
-Node: GNU Free Documentation License1343471
-Node: Index1368591
+Node: Qualified Names922484
+Node: Default Namespace923483
+Node: Changing The Namespace924224
+Node: Naming Rules925838
+Node: Internal Name Management927686
+Node: Namespace Example928728
+Node: Namespace And Features931290
+Node: Namespace Summary932725
+Node: Arbitrary Precision Arithmetic934202
+Node: Computer Arithmetic935689
+Ref: table-numeric-ranges939455
+Ref: table-floating-point-ranges939948
+Ref: Computer Arithmetic-Footnote-1940606
+Node: Math Definitions940663
+Ref: table-ieee-formats943979
+Ref: Math Definitions-Footnote-1944582
+Node: MPFR features944687
+Node: FP Math Caution946405
+Ref: FP Math Caution-Footnote-1947477
+Node: Inexactness of computations947846
+Node: Inexact representation948806
+Node: Comparing FP Values950166
+Node: Errors accumulate951407
+Node: Getting Accuracy952840
+Node: Try To Round955550
+Node: Setting precision956449
+Ref: table-predefined-precision-strings957146
+Node: Setting the rounding mode958976
+Ref: table-gawk-rounding-modes959350
+Ref: Setting the rounding mode-Footnote-1963281
+Node: Arbitrary Precision Integers963460
+Ref: Arbitrary Precision Integers-Footnote-1966635
+Node: Checking for MPFR966784
+Node: POSIX Floating Point Problems968258
+Ref: POSIX Floating Point Problems-Footnote-1972543
+Node: Floating point summary972581
+Node: Dynamic Extensions974771
+Node: Extension Intro976324
+Node: Plugin License977590
+Node: Extension Mechanism Outline978387
+Ref: figure-load-extension978826
+Ref: figure-register-new-function980391
+Ref: figure-call-new-function981483
+Node: Extension API Description983545
+Node: Extension API Functions Introduction985187
+Ref: table-api-std-headers987023
+Node: General Data Types990888
+Ref: General Data Types-Footnote-1999249
+Node: Memory Allocation Functions999548
+Ref: Memory Allocation Functions-Footnote-11003758
+Node: Constructor Functions1003857
+Node: Registration Functions1007443
+Node: Extension Functions1008128
+Node: Exit Callback Functions1013450
+Node: Extension Version String1014700
+Node: Input Parsers1015363
+Node: Output Wrappers1028084
+Node: Two-way processors1032596
+Node: Printing Messages1034861
+Ref: Printing Messages-Footnote-11036032
+Node: Updating ERRNO1036185
+Node: Requesting Values1036924
+Ref: table-value-types-returned1037661
+Node: Accessing Parameters1038597
+Node: Symbol Table Access1039832
+Node: Symbol table by name1040344
+Ref: Symbol table by name-Footnote-11043367
+Node: Symbol table by cookie1043495
+Ref: Symbol table by cookie-Footnote-11047680
+Node: Cached values1047744
+Ref: Cached values-Footnote-11051280
+Node: Array Manipulation1051433
+Ref: Array Manipulation-Footnote-11052524
+Node: Array Data Types1052561
+Ref: Array Data Types-Footnote-11055219
+Node: Array Functions1055311
+Node: Flattening Arrays1059809
+Node: Creating Arrays1066785
+Node: Redirection API1071552
+Node: Extension API Variables1074385
+Node: Extension Versioning1075096
+Ref: gawk-api-version1075525
+Node: Extension GMP/MPFR Versioning1077256
+Node: Extension API Informational Variables1078884
+Node: Extension API Boilerplate1079957
+Node: Changes from API V11083931
+Node: Finding Extensions1085503
+Node: Extension Example1086062
+Node: Internal File Description1086860
+Node: Internal File Ops1090940
+Ref: Internal File Ops-Footnote-11102290
+Node: Using Internal File Ops1102430
+Ref: Using Internal File Ops-Footnote-11104813
+Node: Extension Samples1105087
+Node: Extension Sample File Functions1106616
+Node: Extension Sample Fnmatch1114265
+Node: Extension Sample Fork1115752
+Node: Extension Sample Inplace1116970
+Node: Extension Sample Ord1120274
+Node: Extension Sample Readdir1121110
+Ref: table-readdir-file-types1121999
+Node: Extension Sample Revout1122804
+Node: Extension Sample Rev2way1123393
+Node: Extension Sample Read write array1124133
+Node: Extension Sample Readfile1126075
+Node: Extension Sample Time1127170
+Node: Extension Sample API Tests1128518
+Node: gawkextlib1129010
+Node: Extension summary1131928
+Node: Extension Exercises1135630
+Node: Language History1136872
+Node: V7/SVR3.11138528
+Node: SVR41140680
+Node: POSIX1142114
+Node: BTL1143494
+Node: POSIX/GNU1144223
+Node: Feature History1150001
+Node: Common Extensions1166047
+Node: Ranges and Locales1167330
+Ref: Ranges and Locales-Footnote-11171946
+Ref: Ranges and Locales-Footnote-21171973
+Ref: Ranges and Locales-Footnote-31172208
+Node: Contributors1172429
+Node: History summary1178374
+Node: Installation1179754
+Node: Gawk Distribution1180698
+Node: Getting1181182
+Node: Extracting1182145
+Node: Distribution contents1183783
+Node: Unix Installation1190263
+Node: Quick Installation1190945
+Node: Shell Startup Files1193359
+Node: Additional Configuration Options1194448
+Node: Configuration Philosophy1196613
+Node: Non-Unix Installation1198982
+Node: PC Installation1199442
+Node: PC Binary Installation1200280
+Node: PC Compiling1200715
+Node: PC Using1201832
+Node: Cygwin1205385
+Node: MSYS1206484
+Node: VMS Installation1206985
+Node: VMS Compilation1207776
+Ref: VMS Compilation-Footnote-11209005
+Node: VMS Dynamic Extensions1209063
+Node: VMS Installation Details1210748
+Node: VMS Running1213001
+Node: VMS GNV1217280
+Node: VMS Old Gawk1218015
+Node: Bugs1218486
+Node: Bug address1219149
+Node: Usenet1222131
+Node: Maintainers1223135
+Node: Other Versions1224396
+Node: Installation summary1231310
+Node: Notes1232512
+Node: Compatibility Mode1233306
+Node: Additions1234088
+Node: Accessing The Source1235013
+Node: Adding Code1236450
+Node: New Ports1242669
+Node: Derived Files1247157
+Ref: Derived Files-Footnote-11252803
+Ref: Derived Files-Footnote-21252838
+Ref: Derived Files-Footnote-31253436
+Node: Future Extensions1253550
+Node: Implementation Limitations1254208
+Node: Extension Design1255391
+Node: Old Extension Problems1256535
+Ref: Old Extension Problems-Footnote-11258053
+Node: Extension New Mechanism Goals1258110
+Ref: Extension New Mechanism Goals-Footnote-11261474
+Node: Extension Other Design Decisions1261663
+Node: Extension Future Growth1263776
+Node: Notes summary1264612
+Node: Basic Concepts1265787
+Node: Basic High Level1266468
+Ref: figure-general-flow1266750
+Ref: figure-process-flow1267435
+Ref: Basic High Level-Footnote-11270736
+Node: Basic Data Typing1270921
+Node: Glossary1274249
+Node: Copying1306087
+Node: GNU Free Documentation License1343630
+Node: Index1368750
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 8b540ee..7f78809 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -21838,7 +21838,7 @@ The conventions presented in this @value{SECTION} are 
exactly
 that: conventions. You are not required to write your programs this
 way---we merely recommend that you do so.
 
-Beginning with version 5.0, @command{gawk} provides
+Beginning with @value{PVERSION} 5.0, @command{gawk} provides
 a powerful mechanism for solving the problems described in this
 section: @dfn{namespaces}.  Namespaces and their use are described
 in detail in @ref{Namespaces}.
@@ -31706,7 +31706,8 @@ This @value{CHAPTER} describes a feature that is 
specific to @command{gawk}.
 In standard @command{awk}, there is a single, global, @dfn{namespace}.
 This means that @emph{all} function names and global variable names must
 be unique. For example, two different @command{awk} source files cannot
-both define a function named @code{min()}, or define an array named 
@code{data}.
+both define a function named @code{min()}, or define the same identifier,
+used as a scalar in one and as an array in the other.
 
 This situation is okay when programs are small, say a few hundred
 lines, or even a few thousand, but it prevents the development of
@@ -34313,8 +34314,11 @@ it with @command{gawk} using this API function:
 @table @code
 @item awk_bool_t add_ext_func(const char *name_space, awk_ext_func_t *func);
 This function returns true upon success, false otherwise.
-The @code{name_space} parameter is currently not used; you should pass in an
-empty string (@code{""}).  The @code{func} pointer is the address of a
+The @code{name_space} parameter is the namespace in which to place
+the function (@pxref{Namespaces}).
+Use an empty string (@code{""}) or @code{"awk"} to place
+the function in the default @code{awk} namespace.
+The @code{func} pointer is the address of a
 @code{struct} representing your function, as just described.
 
 @command{gawk} does not modify what @code{func} points to, but the
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index fb16364..4d2f051 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -20881,7 +20881,7 @@ The conventions presented in this @value{SECTION} are 
exactly
 that: conventions. You are not required to write your programs this
 way---we merely recommend that you do so.
 
-Beginning with version 5.0, @command{gawk} provides
+Beginning with @value{PVERSION} 5.0, @command{gawk} provides
 a powerful mechanism for solving the problems described in this
 section: @dfn{namespaces}.  Namespaces and their use are described
 in detail in @ref{Namespaces}.
@@ -30719,7 +30719,8 @@ This @value{CHAPTER} describes a feature that is 
specific to @command{gawk}.
 In standard @command{awk}, there is a single, global, @dfn{namespace}.
 This means that @emph{all} function names and global variable names must
 be unique. For example, two different @command{awk} source files cannot
-both define a function named @code{min()}, or define an array named 
@code{data}.
+both define a function named @code{min()}, or define the same identifier,
+used as a scalar in one and as an array in the other.
 
 This situation is okay when programs are small, say a few hundred
 lines, or even a few thousand, but it prevents the development of
@@ -33287,8 +33288,11 @@ it with @command{gawk} using this API function:
 @table @code
 @item awk_bool_t add_ext_func(const char *name_space, awk_ext_func_t *func);
 This function returns true upon success, false otherwise.
-The @code{name_space} parameter is currently not used; you should pass in an
-empty string (@code{""}).  The @code{func} pointer is the address of a
+The @code{name_space} parameter is the namespace in which to place
+the function (@pxref{Namespaces}).
+Use an empty string (@code{""}) or @code{"awk"} to place
+the function in the default @code{awk} namespace.
+The @code{func} pointer is the address of a
 @code{struct} representing your function, as just described.
 
 @command{gawk} does not modify what @code{func} points to, but the

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

Summary of changes:
 doc/ChangeLog   |   5 +
 doc/gawk.info   | 385 ++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi   |  12 +-
 doc/gawktexi.in |  12 +-
 4 files changed, 215 insertions(+), 199 deletions(-)


hooks/post-receive
-- 
gawk