summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawkinet.info160
-rw-r--r--doc/gawkinet.texi39
3 files changed, 107 insertions, 96 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 8e2cb7d3..f45dfceb 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2019-03-25 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawkinet.texi: Small formatting fixes. Update version and dates.
+
2019-03-13 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in: More minor fixes.
diff --git a/doc/gawkinet.info b/doc/gawkinet.info
index b2c6d9c7..dbbb5ffa 100644
--- a/doc/gawkinet.info
+++ b/doc/gawkinet.info
@@ -1,12 +1,12 @@
This is gawkinet.info, produced by makeinfo version 6.5 from
gawkinet.texi.
-This is Edition 1.4 of 'TCP/IP Internetworking with 'gawk'', for the
-4.1.4 (or later) version of the GNU implementation of AWK.
+This is Edition 1.5 of 'TCP/IP Internetworking with 'gawk'', for the
+5.0.0 (or later) version of the GNU implementation of AWK.
- Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016 Free Software
-Foundation, Inc.
+ Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016, 2019 Free
+Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
@@ -29,12 +29,12 @@ END-INFO-DIR-ENTRY
This file documents the networking features in GNU 'awk'.
- This is Edition 1.4 of 'TCP/IP Internetworking with 'gawk'', for the
-4.1.4 (or later) version of the GNU implementation of AWK.
+ This is Edition 1.5 of 'TCP/IP Internetworking with 'gawk'', for the
+5.0.0 (or later) version of the GNU implementation of AWK.
- Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016 Free Software
-Foundation, Inc.
+ Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016, 2019 Free
+Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
@@ -60,12 +60,12 @@ General Introduction
This file documents the networking features in GNU Awk ('gawk') version
4.0 and later.
- This is Edition 1.4 of 'TCP/IP Internetworking with 'gawk'', for the
-4.1.4 (or later) version of the GNU implementation of AWK.
+ This is Edition 1.5 of 'TCP/IP Internetworking with 'gawk'', for the
+5.0.0 (or later) version of the GNU implementation of AWK.
- Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016 Free Software
-Foundation, Inc.
+ Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016, 2019 Free
+Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
@@ -610,7 +610,7 @@ tcp, udp x 0 x Invalid
tcp, udp 0 0 0 Invalid
tcp, udp 0 x 0 Invalid
-Table 2.1: /inet Special File Components
+Table 2.1: '/inet' Special File Components
In general, TCP is the preferred mechanism to use. It is the
simplest protocol to understand and to use. Use UDP only if
@@ -1596,7 +1596,7 @@ holds the HTML page contents:
function HandleGET() {
# A real HTTP server would treat some parts of the URI as a file name.
# We take parts of the URI as menu choices and go on accordingly.
- if(MENU[2] == "AboutServer") {
+ if (MENU[2] == "AboutServer") {
Document = "This is not a CGI script.\
This is an httpd, an HTML file, and a CGI script all \
in one GAWK script. It needs no separate www-server, \
@@ -1639,7 +1639,7 @@ the set of possible answers:
} else {
q = toupper(YouSay)
gsub("'", "", q)
- if(q == qold) {
+ if (q == qold) {
answer = "PLEASE DONT REPEAT YOURSELF !"
} else {
if (index(q, "SHUT UP") > 0) {
@@ -1818,12 +1818,12 @@ all would love to see a 'gawk' program win in such an event. Maybe it
is up to you to accomplish this?
Some other ideas for useful networked applications:
- * Read the file 'doc/awkforai.txt' in the 'gawk' distribution. It
- was written by Ronald P. Loui (at the time, Associate Professor of
- Computer Science, at Washington University in St. Louis,
- <loui@ai.wustl.edu>) and summarizes why he taught 'gawk' to
- students of Artificial Intelligence. Here are some passages from
- the text:
+ * Read the file 'doc/awkforai.txt' in earlier 'gawk'
+ distributions.(1) It was written by Ronald P. Loui (at the time,
+ Associate Professor of Computer Science, at Washington University
+ in St. Louis, <loui@ai.wustl.edu>) and summarizes why he taught
+ 'gawk' to students of Artificial Intelligence. Here are some
+ passages from the text:
The GAWK manual can be consumed in a single lab session and
the language can be mastered by the next morning by the
@@ -1893,6 +1893,11 @@ is up to you to accomplish this?
exists, the database could, for example, consist of all the
newsgroups, mailing lists and FAQs on the Internet.
+ ---------- Footnotes ----------
+
+ (1) The file is no longer distributed with 'gawk', since the
+copyright on the file is not clear.
+

File: gawkinet.info, Node: Some Applications and Techniques, Next: Links, Prev: Using Networking, Up: Top
@@ -2108,7 +2113,7 @@ changing parameters, and the last one just saves the configuration into
a file:
function HandleGET() {
- if(MENU[2] == "AboutServer") {
+ if (MENU[2] == "AboutServer") {
Document = "This is a GUI for remote configuration of an\
embedded system. It is is implemented as one GAWK script."
} else if (MENU[2] == "ReadConfig") {
@@ -2247,7 +2252,7 @@ it, web robots do it, and sometimes even humans do it. Since we have a
tool like GETURL at hand, we can solve this problem with some help from
the Bourne shell:
- BEGIN { RS = "http://[#%&\\+\\-\\./0-9\\:;\\?A-Z_a-z\\~]*" }
+ BEGIN { RS = "https?://[#%&\\+\\-\\./0-9\\:;\\?A-Z_a-z\\~]*" }
RT != "" {
command = ("gawk -v Proxy=MyProxy -f geturl.awk " RT \
" > doc" NR ".html")
@@ -2391,7 +2396,7 @@ code for delayed opening of a window with an image. A more detailed
explanation follows:
function HandleGET() {
- if(MENU[2] == "AboutServer") {
+ if (MENU[2] == "AboutServer") {
Document = "This is a GUI for a statistical computation.\
It compares means and variances of two distributions.\
It is implemented as one GAWK script and uses GNUPLOT."
@@ -4349,58 +4354,59 @@ Index

Tag Table:
-Node: Top2022
-Node: Preface5665
-Node: Introduction7040
-Node: Stream Communications8066
-Node: Datagram Communications9240
-Node: The TCP/IP Protocols10870
-Ref: The TCP/IP Protocols-Footnote-111554
-Node: Basic Protocols11711
-Ref: Basic Protocols-Footnote-113756
-Node: Ports13785
-Node: Making Connections15192
-Ref: Making Connections-Footnote-117750
-Ref: Making Connections-Footnote-217797
-Node: Using Networking17978
-Node: Gawk Special Files20301
-Node: Special File Fields22110
-Ref: table-inet-components26003
-Node: Comparing Protocols27312
-Node: File /inet/tcp27846
-Node: File /inet/udp28874
-Ref: File /inet/udp-Footnote-130573
-Node: TCP Connecting30827
-Node: Troubleshooting33173
-Ref: Troubleshooting-Footnote-136232
-Node: Interacting36805
-Node: Setting Up39545
-Node: Email43048
-Node: Web page45380
-Ref: Web page-Footnote-148197
-Node: Primitive Service48395
-Node: Interacting Service51136
-Ref: Interacting Service-Footnote-160303
-Node: CGI Lib60335
-Node: Simple Server67310
-Ref: Simple Server-Footnote-175053
-Node: Caveats75154
-Node: Challenges76299
-Node: Some Applications and Techniques84997
-Node: PANIC87462
-Node: GETURL89186
-Node: REMCONF91819
-Node: URLCHK97314
-Node: WEBGRAB101166
-Node: STATIST105628
-Ref: STATIST-Footnote-1117377
-Node: MAZE117822
-Node: MOBAGWHO124029
-Ref: MOBAGWHO-Footnote-1138047
-Node: STOXPRED138102
-Node: PROTBASE152390
-Node: Links165506
-Node: GNU Free Documentation License168939
-Node: Index194059
+Node: Top2034
+Node: Preface5683
+Node: Introduction7058
+Node: Stream Communications8084
+Node: Datagram Communications9258
+Node: The TCP/IP Protocols10888
+Ref: The TCP/IP Protocols-Footnote-111572
+Node: Basic Protocols11729
+Ref: Basic Protocols-Footnote-113774
+Node: Ports13803
+Node: Making Connections15210
+Ref: Making Connections-Footnote-117768
+Ref: Making Connections-Footnote-217815
+Node: Using Networking17996
+Node: Gawk Special Files20319
+Node: Special File Fields22128
+Ref: table-inet-components26021
+Node: Comparing Protocols27332
+Node: File /inet/tcp27866
+Node: File /inet/udp28894
+Ref: File /inet/udp-Footnote-130593
+Node: TCP Connecting30847
+Node: Troubleshooting33193
+Ref: Troubleshooting-Footnote-136252
+Node: Interacting36825
+Node: Setting Up39565
+Node: Email43068
+Node: Web page45400
+Ref: Web page-Footnote-148217
+Node: Primitive Service48415
+Node: Interacting Service51156
+Ref: Interacting Service-Footnote-160323
+Node: CGI Lib60355
+Node: Simple Server67330
+Ref: Simple Server-Footnote-175075
+Node: Caveats75176
+Node: Challenges76321
+Ref: Challenges-Footnote-185063
+Node: Some Applications and Techniques85164
+Node: PANIC87629
+Node: GETURL89353
+Node: REMCONF91986
+Node: URLCHK97482
+Node: WEBGRAB101334
+Node: STATIST105798
+Ref: STATIST-Footnote-1117548
+Node: MAZE117993
+Node: MOBAGWHO124200
+Ref: MOBAGWHO-Footnote-1138218
+Node: STOXPRED138273
+Node: PROTBASE152561
+Node: Links165677
+Node: GNU Free Documentation License169110
+Node: Index194230

End Tag Table
diff --git a/doc/gawkinet.texi b/doc/gawkinet.texi
index 7b26c787..0195db96 100644
--- a/doc/gawkinet.texi
+++ b/doc/gawkinet.texi
@@ -61,18 +61,18 @@
@c pages, I think this is the right decision. ADR.
@set TITLE TCP/IP Internetworking with @command{gawk}
-@set EDITION 1.4
-@set UPDATE-MONTH June, 2016
+@set EDITION 1.5
+@set UPDATE-MONTH March, 2019
@c gawk versions:
-@set VERSION 4.1
-@set PATCHLEVEL 4
+@set VERSION 5.0
+@set PATCHLEVEL 0
@copying
This is Edition @value{EDITION} of @cite{@value{TITLE}},
for the @value{VERSION}.@value{PATCHLEVEL} (or later) version of the GNU
implementation of AWK.
@sp 2
-Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016
+Copyright (C) 2000, 2001, 2002, 2004, 2009, 2010, 2016, 2019
Free Software Foundation, Inc.
@sp 2
Permission is granted to copy, distribute and/or modify this document
@@ -353,8 +353,8 @@ features on top of the basic communications.
@node The TCP/IP Protocols, Making Connections, Datagram Communications, Introduction
@section The Internet Protocols
-The Internet Protocol Suite (usually referred to as just TCP/IP)@footnote{
-It should be noted that although the Internet seems to have conquered the
+The Internet Protocol Suite (usually referred to as just TCP/IP)@footnote{It
+should be noted that although the Internet seems to have conquered the
world, there are other networking protocol suites in existence and in use.}
consists of a number of different protocols at different levels or ``layers.''
For our purposes, three protocols provide the fundamental communications
@@ -733,7 +733,7 @@ use only the
patterns printed in bold letters.
@float Table,table-inet-components
-@caption{/inet Special File Components}
+@caption{@code{/inet} Special File Components}
@multitable @columnfractions .15 .15 .15 .15 .40
@headitem @sc{protocol} @tab @sc{local port} @tab @sc{host name}
@tab @sc{remote port} @tab @sc{Resulting connection-level behavior}
@@ -1899,7 +1899,7 @@ page contents:
function HandleGET() @{
# A real HTTP server would treat some parts of the URI as a file name.
# We take parts of the URI as menu choices and go on accordingly.
- if(MENU[2] == "AboutServer") @{
+ if (MENU[2] == "AboutServer") @{
Document = "This is not a CGI script.\
This is an httpd, an HTML file, and a CGI script all \
in one GAWK script. It needs no separate www-server, \
@@ -1946,7 +1946,7 @@ function ElizaSays(YouSay) @{
@} else @{
q = toupper(YouSay)
gsub("'", "", q)
- if(q == qold) @{
+ if (q == qold) @{
answer = "PLEASE DONT REPEAT YOURSELF !"
@} else @{
if (index(q, "SHUT UP") > 0) @{
@@ -2308,12 +2308,13 @@ program win in such an event. Maybe it is up to you to accomplish this?
Some other ideas for useful networked applications:
@itemize @bullet
@item
-Read the file @file{doc/awkforai.txt} in the @command{gawk} distribution.
-It was written by Ronald P.@: Loui (at the time, Associate Professor of
-Computer Science, at Washington University in St. Louis,
-@email{loui@@ai.wustl.edu}) and summarizes why
-he taught @command{gawk} to students of Artificial Intelligence. Here are
-some passages from the text:
+Read the file @file{doc/awkforai.txt} in earlier @command{gawk}
+distributions.@footnote{The file is no longer distributed with
+@command{gawk}, since the copyright on the file is not clear.}
+It was written by Ronald P.@: Loui (at the time, Associate
+Professor of Computer Science, at Washington University in St. Louis,
+@email{loui@@ai.wustl.edu}) and summarizes why he taught @command{gawk} to
+students of Artificial Intelligence. Here are some passages from the text:
@cindex AI
@cindex PROLOG
@@ -2622,7 +2623,7 @@ the configuration into a file:
@smallexample
@c file eg/network/remconf.awk
function HandleGET() @{
- if(MENU[2] == "AboutServer") @{
+ if (MENU[2] == "AboutServer") @{
Document = "This is a GUI for remote configuration of an\
embedded system. It is is implemented as one GAWK script."
@} else if (MENU[2] == "ReadConfig") @{
@@ -2775,7 +2776,7 @@ some help from the Bourne shell:
@example
@c file eg/network/webgrab.awk
-BEGIN @{ RS = "http://[#%&\\+\\-\\./0-9\\:;\\?A-Z_a-z\\~]*" @}
+BEGIN @{ RS = "https?://[#%&\\+\\-\\./0-9\\:;\\?A-Z_a-z\\~]*" @}
RT != "" @{
command = ("gawk -v Proxy=MyProxy -f geturl.awk " RT \
" > doc" NR ".html")
@@ -2964,7 +2965,7 @@ A more detailed explanation follows:
@smallexample
@c file eg/network/statist.awk
function HandleGET() @{
- if(MENU[2] == "AboutServer") @{
+ if (MENU[2] == "AboutServer") @{
Document = "This is a GUI for a statistical computation.\
It compares means and variances of two distributions.\
It is implemented as one GAWK script and uses GNUPLOT."