diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/gawkinet.info | 160 | ||||
-rw-r--r-- | doc/gawkinet.texi | 39 |
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." |