[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4180-g0dfeaff

[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.1-stable has been updated
       via  0dfeaff26d60ebf6e175a781fe47f4e48a0ee210 (commit)
      from  4bbf219d9f1bf3ad3e20b44fb3f4bc910d6398c3 (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=0dfeaff26d60ebf6e175a781fe47f4e48a0ee210

commit 0dfeaff26d60ebf6e175a781fe47f4e48a0ee210
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Mon Dec 7 09:15:09 2020 +0200

    gawkinet.texi, fix a number of FIXMEs.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 7280e82..a963491 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,4 +1,8 @@
-2020-12-04         Juergen Kahrs         <juergen.kahrs@googlemail.com>
+2020-12-07         Juergen Kahrs         <Juergen.Kahrs@googlemail.com>
+
+       * gawkinet.texi: Fix a number of FIXMEs.
+
+2020-12-04         Juergen Kahrs         <Juergen.Kahrs@googlemail.com>
 
        * gawkinet.texi: Update urefs.
 
diff --git a/doc/gawkinet.info b/doc/gawkinet.info
index 71e29b9..7172491 100644
--- a/doc/gawkinet.info
+++ b/doc/gawkinet.info
@@ -820,7 +820,11 @@ back-ported their TCP/IP implementation to Microsoft 
Windows for
 Workgroups 3.11, but it was a rather rudimentary and half-hearted
 implementation.  Nevertheless, the equivalent of '/etc/services' resides
 under 'C:\WINNT\system32\drivers\etc\services' on Microsoft Windows 2000
-and Microsoft Windows XP.
+and Microsoft Windows XP. On Microsoft Windows 7, 8 and 10 there is a
+directory '%WinDir%\System32\Drivers\Etc' that holds the 'hosts' file
+(https://support.microsoft.com/en-us/help/972034/how-to-reset-the-hosts-file-back-to-the-default)
+and probably also a 'services' file
+(https://www.ibm.com/support/knowledgecenter/SSRNYG_7.2.1/com.ibm.rational.synergy.install.win.doc/topics/sg_r_igw_services_file.html).
 
 
 File: gawkinet.info,  Node: Interacting,  Next: Setting Up,  Prev: 
Troubleshooting,  Up: Using Networking
@@ -927,7 +931,12 @@ running on a Unix machine, because the ports with numbers 
smaller than
 1024 ('echo' is at port 7) are reserved for 'root'.  On machines running
 some flavor of Microsoft Windows, there is no restriction that reserves
 ports 1 to 1024 for a privileged user; hence, you can start an 'echo'
-server there.
+server there.  Even in later version of Microsoft Windows, this
+restriction of the Unix world seems to have never been adopted 'Does
+windows(10/server-2016) have privileged ports?'
+(https://social.technet.microsoft.com/Forums/windowsserver/en-US/334f0770-eda9-475a-a27f-46b80ab7e872/does-windows10server2016-have-privileged-ports-?forum=ws2016).
+In Microsoft Windows it is the level of the firewall that handles port
+access restrictions, not the level of the operating system's kernel.
 
    Turning this short server program into something really useful is
 simple.  Imagine a server that first reads a file name from the client
@@ -1039,7 +1048,7 @@ existed when the web was created in the early 1990s.  
HTTP calls this
 'GET' request a "method," which tells the service to transmit a web page
 (here the home page of the Yahoo!  search engine).  Version 1.0 added
 the request methods 'HEAD' and 'POST'.  The current version of HTTP is
-1.1,(1) and knows the additional request methods 'OPTIONS', 'PUT',
+1.1,(1)(2) and knows the additional request methods 'OPTIONS', 'PUT',
 'DELETE', and 'TRACE'.  You can fill in any valid web address, and the
 program prints the HTML code of that page to your screen.
 
@@ -1069,6 +1078,14 @@ following:
 initially specified in RFC 2068.  In June 1999, RFC 2068 was made
 obsolete by RFC 2616, an update without any substantial changes.
 
+   (2) Version 2.0 of HTTP (https://en.wikipedia.org/wiki/HTTP/2) was
+defined in RFC7540 (https://tools.ietf.org/html/rfc7540) and was derived
+from Google's SPDY (https://en.wikipedia.org/wiki/SPDY) protocol.  It is
+said to be widely supported.  As of 2020 the most popular web sites
+still identify themselves as supporting HTTP/1.1.  Version 3.0 of HTTP
+(https://en.wikipedia.org/wiki/HTTP/3) is still a draft and was derived
+from Google's QUIC (https://en.wikipedia.org/wiki/QUIC) protocol.
+
 
 File: gawkinet.info,  Node: Primitive Service,  Next: Interacting Service,  
Prev: Web page,  Up: Using Networking
 
@@ -1695,10 +1712,11 @@ ELIZA just picks an index randomly:
      }
 
    Some interesting remarks and details (including the original source
-code of ELIZA) are found on Mark Humphrys' home page.  Yahoo!  also has
-a page with a collection of ELIZA-like programs.  Many of them are
-written in Java, some of them disclosing the Java source code, and a few
-even explain how to modify the Java source code.
+code of ELIZA) are found on Mark Humphrys's home page 'How my program
+passed the Turing Test' (https://computing.dcu.ie/~humphrys/eliza.html).
+Wikipedia provides much background information about ELIZA
+(https://en.wikipedia.org/wiki/ELIZA), including the original design of
+the software and its early implementations.
 
    ---------- Footnotes ----------
 
@@ -4365,37 +4383,38 @@ Ref: File /inet/udp-Footnote-129645
 Node: TCP Connecting29899
 Node: Troubleshooting32245
 Ref: Troubleshooting-Footnote-135073
-Node: Interacting35646
-Node: Setting Up38370
-Node: Email41870
-Node: Web page44253
-Ref: Web page-Footnote-147070
-Node: Primitive Service47268
-Node: Interacting Service50002
-Ref: Interacting Service-Footnote-159157
-Node: CGI Lib59189
-Node: Simple Server66189
-Ref: Simple Server-Footnote-173934
-Node: Caveats74035
-Node: Challenges75178
-Ref: Challenges-Footnote-183920
-Node: Some Applications and Techniques84021
-Node: PANIC86482
-Node: GETURL88208
-Node: REMCONF90841
-Node: URLCHK96337
-Node: WEBGRAB100181
-Node: STATIST104645
-Ref: STATIST-Footnote-1117793
-Node: MAZE118236
-Node: MOBAGWHO124461
-Ref: MOBAGWHO-Footnote-1138363
-Node: STOXPRED138431
-Node: PROTBASE152723
-Ref: PROTBASE-Footnote-1165890
-Node: Links166005
-Node: GNU Free Documentation License168896
-Node: Index194016
+Node: Interacting36030
+Node: Setting Up38754
+Node: Email42726
+Node: Web page45109
+Ref: Web page-Footnote-147929
+Ref: Web page-Footnote-248127
+Node: Primitive Service48621
+Node: Interacting Service51355
+Ref: Interacting Service-Footnote-160510
+Node: CGI Lib60542
+Node: Simple Server67542
+Ref: Simple Server-Footnote-175344
+Node: Caveats75445
+Node: Challenges76588
+Ref: Challenges-Footnote-185330
+Node: Some Applications and Techniques85431
+Node: PANIC87892
+Node: GETURL89618
+Node: REMCONF92251
+Node: URLCHK97747
+Node: WEBGRAB101591
+Node: STATIST106055
+Ref: STATIST-Footnote-1119203
+Node: MAZE119646
+Node: MOBAGWHO125871
+Ref: MOBAGWHO-Footnote-1139773
+Node: STOXPRED139841
+Node: PROTBASE154133
+Ref: PROTBASE-Footnote-1167300
+Node: Links167415
+Node: GNU Free Documentation License170306
+Node: Index195426
 
 End Tag Table
 
diff --git a/doc/gawkinet.texi b/doc/gawkinet.texi
index 7a44fd5..a2454e3 100644
--- a/doc/gawkinet.texi
+++ b/doc/gawkinet.texi
@@ -4,6 +4,9 @@
 @settitle TCP/IP Internetworking With @command{gawk}
 @c %**end of header (This is for running Texinfo on a region.)
 @c FIXME: web vs. Web
+@c Correct spelling of web is still under discussion.
+@c 
https://english.stackexchange.com/questions/120869/should-i-capitalize-the-word-web-in-this-sentence
+@c We leave the many occurrences of web in this file as they are.
 
 @dircategory Network applications
 @direntry
@@ -995,7 +998,6 @@ flavor of Microsoft Windows usually do @emph{not} support 
these services.
 Nevertheless, it @emph{is} possible to do networking with @command{gawk} on
 Microsoft
 Windows.@footnote{Microsoft preferred to ignore the TCP/IP
-@c FIXME: What about Windows 7, 8, 10?
 family of protocols until 1995. Then came the rise of the Netscape browser
 as a landmark ``killer application.'' Microsoft added TCP/IP support and
 their own browser to Microsoft Windows 95 at the last minute. They even 
back-ported
@@ -1003,7 +1005,13 @@ their TCP/IP implementation to Microsoft Windows for 
Workgroups 3.11, but it was
 a rather rudimentary and half-hearted implementation. Nevertheless,
 the equivalent of @file{/etc/services} resides under
 @file{C:\WINNT\system32\drivers\etc\services} on Microsoft Windows 2000
-and Microsoft Windows XP.}
+and Microsoft Windows XP.
+On Microsoft Windows 7, 8 and 10 there is a directory
+@file{%WinDir%\System32\Drivers\Etc}
+that holds the
+@uref{https://support.microsoft.com/en-us/help/972034/how-to-reset-the-hosts-file-back-to-the-default,
 @file{hosts} file}
+and probably also a
+@uref{https://www.ibm.com/support/knowledgecenter/SSRNYG_7.2.1/com.ibm.rational.synergy.install.win.doc/topics/sg_r_igw_services_file.html,
 @file{services} file}.}
 The first column of the file gives the name of the service, and
 the second column gives a unique number and the protocol that one can use to 
connect to
 this service.
@@ -1146,7 +1154,12 @@ than 1024 (@samp{echo} is at port 7) are reserved for 
@code{root}.
 On machines running some flavor of Microsoft Windows, there is no restriction
 that reserves ports 1 to 1024 for a privileged user; hence, you can start
 an @samp{echo} server there.
-@c FIXME: Is this still true?
+Even in later version of Microsoft Windows, this restriction of
+the Unix world seems to have never been adopted
+@uref{https://social.technet.microsoft.com/Forums/windowsserver/en-US/334f0770-eda9-475a-a27f-46b80ab7e872/does-windows10server2016-have-privileged-ports-?forum=ws2016,
+@cite{Does windows(10/server-2016) have privileged ports?}}.
+In Microsoft Windows it is the level of the firewall that handles
+port access restrictions, not the level of the operating system's kernel.
 
 Turning this short server program into something really useful is simple.
 Imagine a server that first reads a @value{FN} from the client through the
@@ -1285,11 +1298,21 @@ HTTP request that existed when the web was created in 
the early 1990s.
 HTTP calls this @code{GET} request a ``method,'' which tells the
 service to transmit a web page (here the home page of the Yahoo! search
 engine). Version 1.0 added the request methods @code{HEAD} and
-@c FIXME: Update this footnote?
 @code{POST}. The current version of HTTP is 1.1,@footnote{Version 1.0 of
 HTTP was defined in RFC 1945.  HTTP 1.1 was initially specified in RFC
 2068. In June 1999, RFC 2068 was made obsolete by RFC 2616, an update
-without any substantial changes.} and knows the additional request
+without any substantial 
changes.}@footnote{@uref{https://en.wikipedia.org/wiki/HTTP/2,
+Version 2.0 of HTTP}
+was defined in
+@uref{https://tools.ietf.org/html/rfc7540,RFC7540}
+and was derived from Google's
+@uref{https://en.wikipedia.org/wiki/SPDY,SPDY}
+protocol. It is said to be widely supported. As of 2020 the most popular
+web sites still identify themselves as supporting HTTP/1.1.
+@uref{https://en.wikipedia.org/wiki/HTTP/3, Version 3.0 of HTTP}
+is still a draft and was derived from Google's
+@uref{https://en.wikipedia.org/wiki/QUIC,QUIC} protocol.}
+and knows the additional request
 methods @code{OPTIONS}, @code{PUT}, @code{DELETE}, and @code{TRACE}.
 You can fill in any valid web address, and the program prints the
 HTML code of that page to your screen.
@@ -2199,14 +2222,16 @@ function SetUpEliza() @{
 @c endfile
 @end example
 
-@c FIXME: Not sure what this home page is, or if available any more. Needs 
updating.
 @cindex Humphrys, Mark
 @cindex ELIZA program
 Some interesting remarks and details (including the original source code
-of ELIZA) are found on Mark Humphrys' home page.  Yahoo!  also has a
-page with a collection of ELIZA-like programs. Many of them are written
-in Java, some of them disclosing the Java source code, and a few even
-explain how to modify the Java source code.
+of ELIZA) are found on Mark Humphrys's home page
+@uref{https://computing.dcu.ie/~humphrys/eliza.html,
+@cite{How my program passed the Turing Test}}.
+Wikipedia provides much background information about
+@uref{https://en.wikipedia.org/wiki/ELIZA, ELIZA},
+including the original design of the software and
+its early implementations.
 
 @node Caveats, Challenges, Simple Server, Using Networking
 @section Network Programming Caveats

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

Summary of changes:
 doc/ChangeLog     |  6 +++-
 doc/gawkinet.info | 95 +++++++++++++++++++++++++++++++++----------------------
 doc/gawkinet.texi | 45 ++++++++++++++++++++------
 3 files changed, 97 insertions(+), 49 deletions(-)


hooks/post-receive
-- 
gawk