From a503e996e396e03f819fd0d1710c5e67ed2a59ec Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Fri, 2 Oct 2015 14:22:15 +0300 Subject: Small doc fix (no secure sockets). --- doc/ChangeLog | 4 + doc/gawk.info | 416 ++++++++++++++++++++++++++++---------------------------- doc/gawk.texi | 6 + doc/gawktexi.in | 6 + 4 files changed, 226 insertions(+), 206 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index e4166b8e..ceb2e197 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2015-10-02 Arnold D. Robbins + + * gawktexi.in: Note that there is no support for SSL. + 2015-09-25 Arnold D. Robbins * texinfo.tex: Update to latest. diff --git a/doc/gawk.info b/doc/gawk.info index b6684300..66167218 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -19646,6 +19646,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 @@ -34875,211 +34879,211 @@ Node: Two-way I/O791622 Ref: Two-way I/O-Footnote-1796573 Ref: Two-way I/O-Footnote-2796760 Node: TCP/IP Networking796842 -Node: Profiling799749 -Node: Advanced Features Summary807288 -Node: Internationalization809224 -Node: I18N and L10N810704 -Node: Explaining gettext811391 -Ref: Explaining gettext-Footnote-1816414 -Ref: Explaining gettext-Footnote-2816599 -Node: Programmer i18n816764 -Ref: Programmer i18n-Footnote-1821620 -Node: Translator i18n821669 -Node: String Extraction822463 -Ref: String Extraction-Footnote-1823596 -Node: Printf Ordering823682 -Ref: Printf Ordering-Footnote-1826468 -Node: I18N Portability826532 -Ref: I18N Portability-Footnote-1828988 -Node: I18N Example829051 -Ref: I18N Example-Footnote-1831857 -Node: Gawk I18N831930 -Node: I18N Summary832575 -Node: Debugger833916 -Node: Debugging834938 -Node: Debugging Concepts835379 -Node: Debugging Terms837188 -Node: Awk Debugging839763 -Node: Sample Debugging Session840669 -Node: Debugger Invocation841203 -Node: Finding The Bug842589 -Node: List of Debugger Commands849067 -Node: Breakpoint Control850400 -Node: Debugger Execution Control854094 -Node: Viewing And Changing Data857456 -Node: Execution Stack860830 -Node: Debugger Info862467 -Node: Miscellaneous Debugger Commands866538 -Node: Readline Support871547 -Node: Limitations872443 -Node: Debugging Summary874552 -Node: Arbitrary Precision Arithmetic875725 -Node: Computer Arithmetic877141 -Ref: table-numeric-ranges880732 -Ref: Computer Arithmetic-Footnote-1881454 -Node: Math Definitions881511 -Ref: table-ieee-formats884825 -Ref: Math Definitions-Footnote-1885428 -Node: MPFR features885533 -Node: FP Math Caution887206 -Ref: FP Math Caution-Footnote-1888278 -Node: Inexactness of computations888647 -Node: Inexact representation889607 -Node: Comparing FP Values890967 -Node: Errors accumulate892049 -Node: Getting Accuracy893482 -Node: Try To Round896192 -Node: Setting precision897091 -Ref: table-predefined-precision-strings897788 -Node: Setting the rounding mode899618 -Ref: table-gawk-rounding-modes899992 -Ref: Setting the rounding mode-Footnote-1903400 -Node: Arbitrary Precision Integers903579 -Ref: Arbitrary Precision Integers-Footnote-1906563 -Node: POSIX Floating Point Problems906712 -Ref: POSIX Floating Point Problems-Footnote-1910594 -Node: Floating point summary910632 -Node: Dynamic Extensions912822 -Node: Extension Intro914375 -Node: Plugin License915641 -Node: Extension Mechanism Outline916438 -Ref: figure-load-extension916877 -Ref: figure-register-new-function918442 -Ref: figure-call-new-function919534 -Node: Extension API Description921597 -Node: Extension API Functions Introduction923047 -Node: General Data Types927859 -Ref: General Data Types-Footnote-1933814 -Node: Memory Allocation Functions934113 -Ref: Memory Allocation Functions-Footnote-1936958 -Node: Constructor Functions937057 -Node: Registration Functions938802 -Node: Extension Functions939487 -Node: Exit Callback Functions941786 -Node: Extension Version String943036 -Node: Input Parsers943699 -Node: Output Wrappers953584 -Node: Two-way processors958096 -Node: Printing Messages960360 -Ref: Printing Messages-Footnote-1961436 -Node: Updating 'ERRNO'961589 -Node: Requesting Values962330 -Ref: table-value-types-returned963069 -Node: Accessing Parameters963952 -Node: Symbol Table Access965188 -Node: Symbol table by name965700 -Node: Symbol table by cookie967721 -Ref: Symbol table by cookie-Footnote-1971870 -Node: Cached values971934 -Ref: Cached values-Footnote-1975435 -Node: Array Manipulation975526 -Ref: Array Manipulation-Footnote-1976625 -Node: Array Data Types976662 -Ref: Array Data Types-Footnote-1979320 -Node: Array Functions979412 -Node: Flattening Arrays983271 -Node: Creating Arrays990179 -Node: Extension API Variables994951 -Node: Extension Versioning995587 -Node: Extension API Informational Variables997478 -Node: Extension API Boilerplate998542 -Node: Finding Extensions1002356 -Node: Extension Example1002916 -Node: Internal File Description1003714 -Node: Internal File Ops1007794 -Ref: Internal File Ops-Footnote-11019556 -Node: Using Internal File Ops1019696 -Ref: Using Internal File Ops-Footnote-11022079 -Node: Extension Samples1022354 -Node: Extension Sample File Functions1023883 -Node: Extension Sample Fnmatch1031532 -Node: Extension Sample Fork1033019 -Node: Extension Sample Inplace1034237 -Node: Extension Sample Ord1037447 -Node: Extension Sample Readdir1038283 -Ref: table-readdir-file-types1039172 -Node: Extension Sample Revout1039977 -Node: Extension Sample Rev2way1040566 -Node: Extension Sample Read write array1041306 -Node: Extension Sample Readfile1043248 -Node: Extension Sample Time1044343 -Node: Extension Sample API Tests1045691 -Node: gawkextlib1046183 -Node: Extension summary1048607 -Node: Extension Exercises1052299 -Node: Language History1053796 -Node: V7/SVR3.11055452 -Node: SVR41057604 -Node: POSIX1059038 -Node: BTL1060418 -Node: POSIX/GNU1061148 -Node: Feature History1066669 -Node: Common Extensions1079998 -Node: Ranges and Locales1081281 -Ref: Ranges and Locales-Footnote-11085897 -Ref: Ranges and Locales-Footnote-21085924 -Ref: Ranges and Locales-Footnote-31086159 -Node: Contributors1086380 -Node: History summary1091949 -Node: Installation1093329 -Node: Gawk Distribution1094274 -Node: Getting1094758 -Node: Extracting1095581 -Node: Distribution contents1097219 -Node: Unix Installation1102972 -Node: Quick Installation1103588 -Node: Additional Configuration Options1106015 -Node: Configuration Philosophy1107819 -Node: Non-Unix Installation1110189 -Node: PC Installation1110647 -Node: PC Binary Installation1111967 -Node: PC Compiling1113819 -Ref: PC Compiling-Footnote-11116843 -Node: PC Testing1116952 -Node: PC Using1118132 -Node: Cygwin1122246 -Node: MSYS1123016 -Node: VMS Installation1123517 -Node: VMS Compilation1124308 -Ref: VMS Compilation-Footnote-11125538 -Node: VMS Dynamic Extensions1125596 -Node: VMS Installation Details1127281 -Node: VMS Running1129534 -Node: VMS GNV1132375 -Node: VMS Old Gawk1133110 -Node: Bugs1133581 -Node: Other Versions1137695 -Node: Installation summary1144281 -Node: Notes1145339 -Node: Compatibility Mode1146204 -Node: Additions1146986 -Node: Accessing The Source1147911 -Node: Adding Code1149347 -Node: New Ports1155502 -Node: Derived Files1159990 -Ref: Derived Files-Footnote-11165475 -Ref: Derived Files-Footnote-21165510 -Ref: Derived Files-Footnote-31166108 -Node: Future Extensions1166222 -Node: Implementation Limitations1166880 -Node: Extension Design1168063 -Node: Old Extension Problems1169217 -Ref: Old Extension Problems-Footnote-11170735 -Node: Extension New Mechanism Goals1170792 -Ref: Extension New Mechanism Goals-Footnote-11174156 -Node: Extension Other Design Decisions1174345 -Node: Extension Future Growth1176458 -Node: Old Extension Mechanism1177294 -Node: Notes summary1179057 -Node: Basic Concepts1180239 -Node: Basic High Level1180920 -Ref: figure-general-flow1181202 -Ref: figure-process-flow1181887 -Ref: Basic High Level-Footnote-11185188 -Node: Basic Data Typing1185373 -Node: Glossary1188701 -Node: Copying1220647 -Node: GNU Free Documentation License1258186 -Node: Index1283304 +Node: Profiling799960 +Node: Advanced Features Summary807499 +Node: Internationalization809435 +Node: I18N and L10N810915 +Node: Explaining gettext811602 +Ref: Explaining gettext-Footnote-1816625 +Ref: Explaining gettext-Footnote-2816810 +Node: Programmer i18n816975 +Ref: Programmer i18n-Footnote-1821831 +Node: Translator i18n821880 +Node: String Extraction822674 +Ref: String Extraction-Footnote-1823807 +Node: Printf Ordering823893 +Ref: Printf Ordering-Footnote-1826679 +Node: I18N Portability826743 +Ref: I18N Portability-Footnote-1829199 +Node: I18N Example829262 +Ref: I18N Example-Footnote-1832068 +Node: Gawk I18N832141 +Node: I18N Summary832786 +Node: Debugger834127 +Node: Debugging835149 +Node: Debugging Concepts835590 +Node: Debugging Terms837399 +Node: Awk Debugging839974 +Node: Sample Debugging Session840880 +Node: Debugger Invocation841414 +Node: Finding The Bug842800 +Node: List of Debugger Commands849278 +Node: Breakpoint Control850611 +Node: Debugger Execution Control854305 +Node: Viewing And Changing Data857667 +Node: Execution Stack861041 +Node: Debugger Info862678 +Node: Miscellaneous Debugger Commands866749 +Node: Readline Support871758 +Node: Limitations872654 +Node: Debugging Summary874763 +Node: Arbitrary Precision Arithmetic875936 +Node: Computer Arithmetic877352 +Ref: table-numeric-ranges880943 +Ref: Computer Arithmetic-Footnote-1881665 +Node: Math Definitions881722 +Ref: table-ieee-formats885036 +Ref: Math Definitions-Footnote-1885639 +Node: MPFR features885744 +Node: FP Math Caution887417 +Ref: FP Math Caution-Footnote-1888489 +Node: Inexactness of computations888858 +Node: Inexact representation889818 +Node: Comparing FP Values891178 +Node: Errors accumulate892260 +Node: Getting Accuracy893693 +Node: Try To Round896403 +Node: Setting precision897302 +Ref: table-predefined-precision-strings897999 +Node: Setting the rounding mode899829 +Ref: table-gawk-rounding-modes900203 +Ref: Setting the rounding mode-Footnote-1903611 +Node: Arbitrary Precision Integers903790 +Ref: Arbitrary Precision Integers-Footnote-1906774 +Node: POSIX Floating Point Problems906923 +Ref: POSIX Floating Point Problems-Footnote-1910805 +Node: Floating point summary910843 +Node: Dynamic Extensions913033 +Node: Extension Intro914586 +Node: Plugin License915852 +Node: Extension Mechanism Outline916649 +Ref: figure-load-extension917088 +Ref: figure-register-new-function918653 +Ref: figure-call-new-function919745 +Node: Extension API Description921808 +Node: Extension API Functions Introduction923258 +Node: General Data Types928070 +Ref: General Data Types-Footnote-1934025 +Node: Memory Allocation Functions934324 +Ref: Memory Allocation Functions-Footnote-1937169 +Node: Constructor Functions937268 +Node: Registration Functions939013 +Node: Extension Functions939698 +Node: Exit Callback Functions941997 +Node: Extension Version String943247 +Node: Input Parsers943910 +Node: Output Wrappers953795 +Node: Two-way processors958307 +Node: Printing Messages960571 +Ref: Printing Messages-Footnote-1961647 +Node: Updating 'ERRNO'961800 +Node: Requesting Values962541 +Ref: table-value-types-returned963280 +Node: Accessing Parameters964163 +Node: Symbol Table Access965399 +Node: Symbol table by name965911 +Node: Symbol table by cookie967932 +Ref: Symbol table by cookie-Footnote-1972081 +Node: Cached values972145 +Ref: Cached values-Footnote-1975646 +Node: Array Manipulation975737 +Ref: Array Manipulation-Footnote-1976836 +Node: Array Data Types976873 +Ref: Array Data Types-Footnote-1979531 +Node: Array Functions979623 +Node: Flattening Arrays983482 +Node: Creating Arrays990390 +Node: Extension API Variables995162 +Node: Extension Versioning995798 +Node: Extension API Informational Variables997689 +Node: Extension API Boilerplate998753 +Node: Finding Extensions1002567 +Node: Extension Example1003127 +Node: Internal File Description1003925 +Node: Internal File Ops1008005 +Ref: Internal File Ops-Footnote-11019767 +Node: Using Internal File Ops1019907 +Ref: Using Internal File Ops-Footnote-11022290 +Node: Extension Samples1022565 +Node: Extension Sample File Functions1024094 +Node: Extension Sample Fnmatch1031743 +Node: Extension Sample Fork1033230 +Node: Extension Sample Inplace1034448 +Node: Extension Sample Ord1037658 +Node: Extension Sample Readdir1038494 +Ref: table-readdir-file-types1039383 +Node: Extension Sample Revout1040188 +Node: Extension Sample Rev2way1040777 +Node: Extension Sample Read write array1041517 +Node: Extension Sample Readfile1043459 +Node: Extension Sample Time1044554 +Node: Extension Sample API Tests1045902 +Node: gawkextlib1046394 +Node: Extension summary1048818 +Node: Extension Exercises1052510 +Node: Language History1054007 +Node: V7/SVR3.11055663 +Node: SVR41057815 +Node: POSIX1059249 +Node: BTL1060629 +Node: POSIX/GNU1061359 +Node: Feature History1066880 +Node: Common Extensions1080209 +Node: Ranges and Locales1081492 +Ref: Ranges and Locales-Footnote-11086108 +Ref: Ranges and Locales-Footnote-21086135 +Ref: Ranges and Locales-Footnote-31086370 +Node: Contributors1086591 +Node: History summary1092160 +Node: Installation1093540 +Node: Gawk Distribution1094485 +Node: Getting1094969 +Node: Extracting1095792 +Node: Distribution contents1097430 +Node: Unix Installation1103183 +Node: Quick Installation1103799 +Node: Additional Configuration Options1106226 +Node: Configuration Philosophy1108030 +Node: Non-Unix Installation1110400 +Node: PC Installation1110858 +Node: PC Binary Installation1112178 +Node: PC Compiling1114030 +Ref: PC Compiling-Footnote-11117054 +Node: PC Testing1117163 +Node: PC Using1118343 +Node: Cygwin1122457 +Node: MSYS1123227 +Node: VMS Installation1123728 +Node: VMS Compilation1124519 +Ref: VMS Compilation-Footnote-11125749 +Node: VMS Dynamic Extensions1125807 +Node: VMS Installation Details1127492 +Node: VMS Running1129745 +Node: VMS GNV1132586 +Node: VMS Old Gawk1133321 +Node: Bugs1133792 +Node: Other Versions1137906 +Node: Installation summary1144492 +Node: Notes1145550 +Node: Compatibility Mode1146415 +Node: Additions1147197 +Node: Accessing The Source1148122 +Node: Adding Code1149558 +Node: New Ports1155713 +Node: Derived Files1160201 +Ref: Derived Files-Footnote-11165686 +Ref: Derived Files-Footnote-21165721 +Ref: Derived Files-Footnote-31166319 +Node: Future Extensions1166433 +Node: Implementation Limitations1167091 +Node: Extension Design1168274 +Node: Old Extension Problems1169428 +Ref: Old Extension Problems-Footnote-11170946 +Node: Extension New Mechanism Goals1171003 +Ref: Extension New Mechanism Goals-Footnote-11174367 +Node: Extension Other Design Decisions1174556 +Node: Extension Future Growth1176669 +Node: Old Extension Mechanism1177505 +Node: Notes summary1179268 +Node: Basic Concepts1180450 +Node: Basic High Level1181131 +Ref: figure-general-flow1181413 +Ref: figure-process-flow1182098 +Ref: Basic High Level-Footnote-11185399 +Node: Basic Data Typing1185584 +Node: Glossary1188912 +Node: Copying1220858 +Node: GNU Free Documentation License1258397 +Node: Index1283515  End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 50c10c71..0dcaf135 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -27547,6 +27547,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 78f3b40d..d63a6f60 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -26638,6 +26638,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 -- cgit v1.2.1