Merge branch 'gawk-4.1-stable' into feature/zOS-try2feature/zOS-try2

4 files changed, 226 insertions, 206 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a9497df7..7948ccb4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2015-10-02         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: Note that there is no support for SSL.
+
 2015-09-25         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* texinfo.tex: Update to latest.
diff --git a/doc/gawk.info b/doc/gawk.info
index b534e005..d073efbb 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -19647,6 +19647,10 @@ programming is documented separately.  See *note (General Introduction,
 gawkinet, TCP/IP Internetworking with 'gawk')Top::, for a much more
 complete introduction and discussion, as well as extensive examples.
 
+     NOTE: 'gawk' can only open direct sockets.  There is currently no
+     way to access services available over Secure Socket Layer (SSL);
+     this includes any web service whose URL starts with 'https://'.
+
 
 File: gawk.info,  Node: Profiling,  Next: Advanced Features Summary,  Prev: TCP/IP Networking,  Up: Advanced Features
 
@@ -34879,211 +34883,211 @@ Node: Two-way I/O791641
 Ref: Two-way I/O-Footnote-1796592
 Ref: Two-way I/O-Footnote-2796779
 Node: TCP/IP Networking796861
-Node: Profiling799768
-Node: Advanced Features Summary807307
-Node: Internationalization809243
-Node: I18N and L10N810723
-Node: Explaining gettext811410
-Ref: Explaining gettext-Footnote-1816433
-Ref: Explaining gettext-Footnote-2816618
-Node: Programmer i18n816783
-Ref: Programmer i18n-Footnote-1821639
-Node: Translator i18n821688
-Node: String Extraction822482
-Ref: String Extraction-Footnote-1823615
-Node: Printf Ordering823701
-Ref: Printf Ordering-Footnote-1826487
-Node: I18N Portability826551
-Ref: I18N Portability-Footnote-1829007
-Node: I18N Example829070
-Ref: I18N Example-Footnote-1831876
-Node: Gawk I18N831949
-Node: I18N Summary832594
-Node: Debugger833935
-Node: Debugging834957
-Node: Debugging Concepts835398
-Node: Debugging Terms837207
-Node: Awk Debugging839782
-Node: Sample Debugging Session840688
-Node: Debugger Invocation841222
-Node: Finding The Bug842608
-Node: List of Debugger Commands849086
-Node: Breakpoint Control850419
-Node: Debugger Execution Control854113
-Node: Viewing And Changing Data857475
-Node: Execution Stack860849
-Node: Debugger Info862486
-Node: Miscellaneous Debugger Commands866557
-Node: Readline Support871566
-Node: Limitations872462
-Node: Debugging Summary874571
-Node: Arbitrary Precision Arithmetic875744
-Node: Computer Arithmetic877160
-Ref: table-numeric-ranges880751
-Ref: Computer Arithmetic-Footnote-1881473
-Node: Math Definitions881530
-Ref: table-ieee-formats884844
-Ref: Math Definitions-Footnote-1885447
-Node: MPFR features885552
-Node: FP Math Caution887225
-Ref: FP Math Caution-Footnote-1888297
-Node: Inexactness of computations888666
-Node: Inexact representation889626
-Node: Comparing FP Values890986
-Node: Errors accumulate892068
-Node: Getting Accuracy893501
-Node: Try To Round896211
-Node: Setting precision897110
-Ref: table-predefined-precision-strings897807
-Node: Setting the rounding mode899637
-Ref: table-gawk-rounding-modes900011
-Ref: Setting the rounding mode-Footnote-1903419
-Node: Arbitrary Precision Integers903598
-Ref: Arbitrary Precision Integers-Footnote-1906582
-Node: POSIX Floating Point Problems906731
-Ref: POSIX Floating Point Problems-Footnote-1910613
-Node: Floating point summary910651
-Node: Dynamic Extensions912841
-Node: Extension Intro914394
-Node: Plugin License915660
-Node: Extension Mechanism Outline916457
-Ref: figure-load-extension916896
-Ref: figure-register-new-function918461
-Ref: figure-call-new-function919553
-Node: Extension API Description921616
-Node: Extension API Functions Introduction923066
-Node: General Data Types927878
-Ref: General Data Types-Footnote-1933833
-Node: Memory Allocation Functions934132
-Ref: Memory Allocation Functions-Footnote-1936977
-Node: Constructor Functions937076
-Node: Registration Functions938821
-Node: Extension Functions939506
-Node: Exit Callback Functions941805
-Node: Extension Version String943055
-Node: Input Parsers943718
-Node: Output Wrappers953603
-Node: Two-way processors958115
-Node: Printing Messages960379
-Ref: Printing Messages-Footnote-1961455
-Node: Updating 'ERRNO'961608
-Node: Requesting Values962349
-Ref: table-value-types-returned963088
-Node: Accessing Parameters963971
-Node: Symbol Table Access965207
-Node: Symbol table by name965719
-Node: Symbol table by cookie967740
-Ref: Symbol table by cookie-Footnote-1971889
-Node: Cached values971953
-Ref: Cached values-Footnote-1975454
-Node: Array Manipulation975545
-Ref: Array Manipulation-Footnote-1976644
-Node: Array Data Types976681
-Ref: Array Data Types-Footnote-1979339
-Node: Array Functions979431
-Node: Flattening Arrays983290
-Node: Creating Arrays990198
-Node: Extension API Variables994970
-Node: Extension Versioning995606
-Node: Extension API Informational Variables997497
-Node: Extension API Boilerplate998561
-Node: Finding Extensions1002375
-Node: Extension Example1002935
-Node: Internal File Description1003733
-Node: Internal File Ops1007813
-Ref: Internal File Ops-Footnote-11019575
-Node: Using Internal File Ops1019715
-Ref: Using Internal File Ops-Footnote-11022098
-Node: Extension Samples1022373
-Node: Extension Sample File Functions1023902
-Node: Extension Sample Fnmatch1031551
-Node: Extension Sample Fork1033038
-Node: Extension Sample Inplace1034256
-Node: Extension Sample Ord1037466
-Node: Extension Sample Readdir1038302
-Ref: table-readdir-file-types1039191
-Node: Extension Sample Revout1039996
-Node: Extension Sample Rev2way1040585
-Node: Extension Sample Read write array1041325
-Node: Extension Sample Readfile1043267
-Node: Extension Sample Time1044362
-Node: Extension Sample API Tests1045710
-Node: gawkextlib1046202
-Node: Extension summary1048626
-Node: Extension Exercises1052318
-Node: Language History1053815
-Node: V7/SVR3.11055471
-Node: SVR41057623
-Node: POSIX1059057
-Node: BTL1060437
-Node: POSIX/GNU1061167
-Node: Feature History1066688
-Node: Common Extensions1080017
-Node: Ranges and Locales1081300
-Ref: Ranges and Locales-Footnote-11085916
-Ref: Ranges and Locales-Footnote-21085943
-Ref: Ranges and Locales-Footnote-31086178
-Node: Contributors1086399
-Node: History summary1091968
-Node: Installation1093348
-Node: Gawk Distribution1094293
-Node: Getting1094777
-Node: Extracting1095600
-Node: Distribution contents1097238
-Node: Unix Installation1102991
-Node: Quick Installation1103607
-Node: Additional Configuration Options1106034
-Node: Configuration Philosophy1107838
-Node: Non-Unix Installation1110208
-Node: PC Installation1110666
-Node: PC Binary Installation1111986
-Node: PC Compiling1113838
-Ref: PC Compiling-Footnote-11116862
-Node: PC Testing1116971
-Node: PC Using1118151
-Node: Cygwin1122265
-Node: MSYS1123035
-Node: VMS Installation1123536
-Node: VMS Compilation1124327
-Ref: VMS Compilation-Footnote-11125557
-Node: VMS Dynamic Extensions1125615
-Node: VMS Installation Details1127300
-Node: VMS Running1129553
-Node: VMS GNV1132394
-Node: VMS Old Gawk1133129
-Node: Bugs1133600
-Node: Other Versions1137797
-Node: Installation summary1144383
-Node: Notes1145441
-Node: Compatibility Mode1146306
-Node: Additions1147088
-Node: Accessing The Source1148013
-Node: Adding Code1149449
-Node: New Ports1155604
-Node: Derived Files1160092
-Ref: Derived Files-Footnote-11165577
-Ref: Derived Files-Footnote-21165612
-Ref: Derived Files-Footnote-31166210
-Node: Future Extensions1166324
-Node: Implementation Limitations1166982
-Node: Extension Design1168165
-Node: Old Extension Problems1169319
-Ref: Old Extension Problems-Footnote-11170837
-Node: Extension New Mechanism Goals1170894
-Ref: Extension New Mechanism Goals-Footnote-11174258
-Node: Extension Other Design Decisions1174447
-Node: Extension Future Growth1176560
-Node: Old Extension Mechanism1177396
-Node: Notes summary1179159
-Node: Basic Concepts1180341
-Node: Basic High Level1181022
-Ref: figure-general-flow1181304
-Ref: figure-process-flow1181989
-Ref: Basic High Level-Footnote-11185290
-Node: Basic Data Typing1185475
-Node: Glossary1188803
-Node: Copying1220749
-Node: GNU Free Documentation License1258288
-Node: Index1283406
+Node: Profiling799979
+Node: Advanced Features Summary807518
+Node: Internationalization809454
+Node: I18N and L10N810934
+Node: Explaining gettext811621
+Ref: Explaining gettext-Footnote-1816644
+Ref: Explaining gettext-Footnote-2816829
+Node: Programmer i18n816994
+Ref: Programmer i18n-Footnote-1821850
+Node: Translator i18n821899
+Node: String Extraction822693
+Ref: String Extraction-Footnote-1823826
+Node: Printf Ordering823912
+Ref: Printf Ordering-Footnote-1826698
+Node: I18N Portability826762
+Ref: I18N Portability-Footnote-1829218
+Node: I18N Example829281
+Ref: I18N Example-Footnote-1832087
+Node: Gawk I18N832160
+Node: I18N Summary832805
+Node: Debugger834146
+Node: Debugging835168
+Node: Debugging Concepts835609
+Node: Debugging Terms837418
+Node: Awk Debugging839993
+Node: Sample Debugging Session840899
+Node: Debugger Invocation841433
+Node: Finding The Bug842819
+Node: List of Debugger Commands849297
+Node: Breakpoint Control850630
+Node: Debugger Execution Control854324
+Node: Viewing And Changing Data857686
+Node: Execution Stack861060
+Node: Debugger Info862697
+Node: Miscellaneous Debugger Commands866768
+Node: Readline Support871777
+Node: Limitations872673
+Node: Debugging Summary874782
+Node: Arbitrary Precision Arithmetic875955
+Node: Computer Arithmetic877371
+Ref: table-numeric-ranges880962
+Ref: Computer Arithmetic-Footnote-1881684
+Node: Math Definitions881741
+Ref: table-ieee-formats885055
+Ref: Math Definitions-Footnote-1885658
+Node: MPFR features885763
+Node: FP Math Caution887436
+Ref: FP Math Caution-Footnote-1888508
+Node: Inexactness of computations888877
+Node: Inexact representation889837
+Node: Comparing FP Values891197
+Node: Errors accumulate892279
+Node: Getting Accuracy893712
+Node: Try To Round896422
+Node: Setting precision897321
+Ref: table-predefined-precision-strings898018
+Node: Setting the rounding mode899848
+Ref: table-gawk-rounding-modes900222
+Ref: Setting the rounding mode-Footnote-1903630
+Node: Arbitrary Precision Integers903809
+Ref: Arbitrary Precision Integers-Footnote-1906793
+Node: POSIX Floating Point Problems906942
+Ref: POSIX Floating Point Problems-Footnote-1910824
+Node: Floating point summary910862
+Node: Dynamic Extensions913052
+Node: Extension Intro914605
+Node: Plugin License915871
+Node: Extension Mechanism Outline916668
+Ref: figure-load-extension917107
+Ref: figure-register-new-function918672
+Ref: figure-call-new-function919764
+Node: Extension API Description921827
+Node: Extension API Functions Introduction923277
+Node: General Data Types928089
+Ref: General Data Types-Footnote-1934044
+Node: Memory Allocation Functions934343
+Ref: Memory Allocation Functions-Footnote-1937188
+Node: Constructor Functions937287
+Node: Registration Functions939032
+Node: Extension Functions939717
+Node: Exit Callback Functions942016
+Node: Extension Version String943266
+Node: Input Parsers943929
+Node: Output Wrappers953814
+Node: Two-way processors958326
+Node: Printing Messages960590
+Ref: Printing Messages-Footnote-1961666
+Node: Updating 'ERRNO'961819
+Node: Requesting Values962560
+Ref: table-value-types-returned963299
+Node: Accessing Parameters964182
+Node: Symbol Table Access965418
+Node: Symbol table by name965930
+Node: Symbol table by cookie967951
+Ref: Symbol table by cookie-Footnote-1972100
+Node: Cached values972164
+Ref: Cached values-Footnote-1975665
+Node: Array Manipulation975756
+Ref: Array Manipulation-Footnote-1976855
+Node: Array Data Types976892
+Ref: Array Data Types-Footnote-1979550
+Node: Array Functions979642
+Node: Flattening Arrays983501
+Node: Creating Arrays990409
+Node: Extension API Variables995181
+Node: Extension Versioning995817
+Node: Extension API Informational Variables997708
+Node: Extension API Boilerplate998772
+Node: Finding Extensions1002586
+Node: Extension Example1003146
+Node: Internal File Description1003944
+Node: Internal File Ops1008024
+Ref: Internal File Ops-Footnote-11019786
+Node: Using Internal File Ops1019926
+Ref: Using Internal File Ops-Footnote-11022309
+Node: Extension Samples1022584
+Node: Extension Sample File Functions1024113
+Node: Extension Sample Fnmatch1031762
+Node: Extension Sample Fork1033249
+Node: Extension Sample Inplace1034467
+Node: Extension Sample Ord1037677
+Node: Extension Sample Readdir1038513
+Ref: table-readdir-file-types1039402
+Node: Extension Sample Revout1040207
+Node: Extension Sample Rev2way1040796
+Node: Extension Sample Read write array1041536
+Node: Extension Sample Readfile1043478
+Node: Extension Sample Time1044573
+Node: Extension Sample API Tests1045921
+Node: gawkextlib1046413
+Node: Extension summary1048837
+Node: Extension Exercises1052529
+Node: Language History1054026
+Node: V7/SVR3.11055682
+Node: SVR41057834
+Node: POSIX1059268
+Node: BTL1060648
+Node: POSIX/GNU1061378
+Node: Feature History1066899
+Node: Common Extensions1080228
+Node: Ranges and Locales1081511
+Ref: Ranges and Locales-Footnote-11086127
+Ref: Ranges and Locales-Footnote-21086154
+Ref: Ranges and Locales-Footnote-31086389
+Node: Contributors1086610
+Node: History summary1092179
+Node: Installation1093559
+Node: Gawk Distribution1094504
+Node: Getting1094988
+Node: Extracting1095811
+Node: Distribution contents1097449
+Node: Unix Installation1103202
+Node: Quick Installation1103818
+Node: Additional Configuration Options1106245
+Node: Configuration Philosophy1108049
+Node: Non-Unix Installation1110419
+Node: PC Installation1110877
+Node: PC Binary Installation1112197
+Node: PC Compiling1114049
+Ref: PC Compiling-Footnote-11117073
+Node: PC Testing1117182
+Node: PC Using1118362
+Node: Cygwin1122476
+Node: MSYS1123246
+Node: VMS Installation1123747
+Node: VMS Compilation1124538
+Ref: VMS Compilation-Footnote-11125768
+Node: VMS Dynamic Extensions1125826
+Node: VMS Installation Details1127511
+Node: VMS Running1129764
+Node: VMS GNV1132605
+Node: VMS Old Gawk1133340
+Node: Bugs1133811
+Node: Other Versions1138008
+Node: Installation summary1144594
+Node: Notes1145652
+Node: Compatibility Mode1146517
+Node: Additions1147299
+Node: Accessing The Source1148224
+Node: Adding Code1149660
+Node: New Ports1155815
+Node: Derived Files1160303
+Ref: Derived Files-Footnote-11165788
+Ref: Derived Files-Footnote-21165823
+Ref: Derived Files-Footnote-31166421
+Node: Future Extensions1166535
+Node: Implementation Limitations1167193
+Node: Extension Design1168376
+Node: Old Extension Problems1169530
+Ref: Old Extension Problems-Footnote-11171048
+Node: Extension New Mechanism Goals1171105
+Ref: Extension New Mechanism Goals-Footnote-11174469
+Node: Extension Other Design Decisions1174658
+Node: Extension Future Growth1176771
+Node: Old Extension Mechanism1177607
+Node: Notes summary1179370
+Node: Basic Concepts1180552
+Node: Basic High Level1181233
+Ref: figure-general-flow1181515
+Ref: figure-process-flow1182200
+Ref: Basic High Level-Footnote-11185501
+Node: Basic Data Typing1185686
+Node: Glossary1189014
+Node: Copying1220960
+Node: GNU Free Documentation License1258499
+Node: Index1283617
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 546bc671..bc737777 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -27549,6 +27549,12 @@ which comes as part of the @command{gawk} distribution,
 for a much more complete introduction and discussion, as well as
 extensive examples.
 
+@quotation NOTE
+@command{gawk} can only open direct sockets. There is currently
+no way to access services available over Secure Socket Layer
+(SSL); this includes any web service whose URL starts with @samp{https://}.
+@end quotation
+
 
 @node Profiling
 @section Profiling Your @command{awk} Programs
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 6943febb..a604d983 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -26640,6 +26640,12 @@ which comes as part of the @command{gawk} distribution,
 for a much more complete introduction and discussion, as well as
 extensive examples.
 
+@quotation NOTE
+@command{gawk} can only open direct sockets. There is currently
+no way to access services available over Secure Socket Layer
+(SSL); this includes any web service whose URL starts with @samp{https://}.
+@end quotation
+
 
 @node Profiling
 @section Profiling Your @command{awk} Programs