diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2014-02-03 21:05:05 +0200 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2014-02-03 21:05:05 +0200 |
commit | 9c2180330d85a9915b14c5fb5346dbc90b49fe87 (patch) | |
tree | 3cf708591cb2531865eb87e6d66b1de5fd2e0f9b | |
parent | ffef130c33f07bd245823413e6f12105aa8dcbf9 (diff) | |
download | egawk-9c2180330d85a9915b14c5fb5346dbc90b49fe87.tar.gz egawk-9c2180330d85a9915b14c5fb5346dbc90b49fe87.tar.bz2 egawk-9c2180330d85a9915b14c5fb5346dbc90b49fe87.zip |
A number of small documentation updates.
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 4 | ||||
-rw-r--r-- | doc/gawk.texi | 18 | ||||
-rw-r--r-- | doc/gawkinet.info | 72 | ||||
-rw-r--r-- | doc/gawkinet.texi | 6 | ||||
-rw-r--r-- | doc/gawktexi.in | 18 | ||||
-rw-r--r-- | doc/texinfo.tex | 14 |
7 files changed, 76 insertions, 61 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index a5d48926..d0865f91 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2014-02-03 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in, gawkinet.texi: Minor fixes, mostly in indexing. + * texinfo.tex: Update to latest. + 2014-01-31 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Add `()' to names of extension functions in indexing diff --git a/doc/gawk.info b/doc/gawk.info index 3e6c3ea4..53fd4920 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -30010,7 +30010,6 @@ Index * - (hyphen), in bracket expressions: Bracket Expressions. (line 17) * --assign option: Options. (line 46) * --bignum option: Options. (line 201) -* --c option: Options. (line 95) * --characters-as-bytes option: Options. (line 82) * --copyright option: Options. (line 102) * --debug option: Options. (line 122) @@ -30029,7 +30028,6 @@ Index * --gen-pot option: Options. (line 161) * --help option: Options. (line 168) * --include option: Options. (line 32) -* --L option: Options. (line 288) * --lint option <1>: Options. (line 182) * --lint option: Command Line. (line 20) * --lint-old option: Options. (line 288) @@ -30060,6 +30058,7 @@ Index (line 35) * -b option: Options. (line 82) * -C option: Options. (line 102) +* -c option: Options. (line 95) * -D option: Options. (line 122) * -d option: Options. (line 107) * -E option: Options. (line 139) @@ -30074,6 +30073,7 @@ Index * -g option: Options. (line 161) * -h option: Options. (line 168) * -i option: Options. (line 32) +* -L option: Options. (line 288) * -l option: Options. (line 173) * -M option: Options. (line 201) * -N option: Options. (line 215) diff --git a/doc/gawk.texi b/doc/gawk.texi index 6af87dd0..f25d21df 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -1261,7 +1261,7 @@ and the program ``the @command{awk} utility.'' This @value{DOCUMENT} explains both how to write programs in the @command{awk} language and how to run the @command{awk} utility. -The term @dfn{@command{awk} program} refers to a program written by you in +The term ``@command{awk} program'' refers to a program written by you in the @command{awk} programming language. @cindex @command{gawk}, @command{awk} and @@ -3338,7 +3338,7 @@ multibyte characters. This option is an easy way to tell @command{gawk}: @item -c @itemx --traditional -@cindex @code{--c} option +@cindex @code{-c} option @cindex @code{--traditional} option @cindex compatibility mode (@command{gawk}), specifying Specify @dfn{compatibility mode}, in which the GNU extensions to @@ -3633,7 +3633,7 @@ can't access your system (other than the specified input data file). @item -t @itemx --lint-old -@cindex @code{--L} option +@cindex @code{-L} option @cindex @code{--lint-old} option Warn about constructs that are not available in the original version of @command{awk} from Version 7 Unix @@ -8855,8 +8855,8 @@ Redirections in @command{awk} are written just like redirections in shell commands, except that they are written inside the @command{awk} program. @c the commas here are part of the see also -@cindex @code{print} statement, See Also redirection, of output -@cindex @code{printf} statement, See Also redirection, of output +@cindex @code{print} statement, See Also redirection@comma{} of output +@cindex @code{printf} statement, See Also redirection@comma{} of output There are four forms of output redirection: output to a file, output appended to a file, output through a pipe to another command, and output to a coprocess. They are all shown for the @code{print} statement, @@ -20636,7 +20636,7 @@ use @code{getopt()} to process their arguments. @c STARTOFRANGE libfudata @cindex libraries of @command{awk} functions, user database, reading @c STARTOFRANGE flibudata -@cindex functions, library, user database, reading +@cindex functions, library, user database@comma{} reading @c STARTOFRANGE udatar @cindex user database@comma{} reading @c STARTOFRANGE dataur @@ -21004,7 +21004,7 @@ uses these functions. @c STARTOFRANGE libfgdata @cindex libraries of @command{awk} functions, group database, reading @c STARTOFRANGE flibgdata -@cindex functions, library, group database, reading +@cindex functions, library, group database@comma{} reading @c STARTOFRANGE gdatar @cindex group database, reading @c STARTOFRANGE datagr @@ -24943,7 +24943,7 @@ It contains the following chapters: @node Advanced Features @chapter Advanced Features of @command{gawk} -@cindex advanced features, network connections, See Also networks, connections +@cindex advanced features, network connections, See Also networks@comma{} connections @c STARTOFRANGE gawadv @cindex @command{gawk}, features, advanced @c STARTOFRANGE advgaw @@ -34612,7 +34612,7 @@ helping David Trueman, and as the primary maintainer since around 1994. @appendix Installing @command{gawk} @c last two commas are part of see also -@cindex operating systems, See Also GNU/Linux, PC operating systems, Unix +@cindex operating systems, See Also GNU/Linux@comma{} PC operating systems@comma{} Unix @c STARTOFRANGE gligawk @cindex @command{gawk}, installing @c STARTOFRANGE ingawk diff --git a/doc/gawkinet.info b/doc/gawkinet.info index c8ce6b8d..0a0d69d8 100644 --- a/doc/gawkinet.info +++ b/doc/gawkinet.info @@ -613,7 +613,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 @@ -4358,40 +4358,40 @@ Node: Using Networking17966 Node: Gawk Special Files20284 Node: Special File Fields22094 Ref: table-inet-components25967 -Node: Comparing Protocols27290 -Node: File /inet/tcp27823 -Node: File /inet/udp28849 -Node: TCP Connecting29947 -Node: Troubleshooting32285 -Ref: Troubleshooting-Footnote-135337 -Node: Interacting35906 -Node: Setting Up38636 -Node: Email42130 -Node: Web page44456 -Ref: Web page-Footnote-147261 -Node: Primitive Service47458 -Node: Interacting Service50192 -Ref: Interacting Service-Footnote-159321 -Node: CGI Lib59353 -Node: Simple Server66314 -Ref: Simple Server-Footnote-174037 -Node: Caveats74138 -Node: Challenges75281 -Node: Some Applications and Techniques83960 -Node: PANIC86417 -Node: GETURL88135 -Node: REMCONF90758 -Node: URLCHK96234 -Node: WEBGRAB100069 -Node: STATIST104519 -Ref: STATIST-Footnote-1116227 -Node: MAZE116672 -Node: MOBAGWHO122856 -Ref: MOBAGWHO-Footnote-1136800 -Node: STOXPRED136855 -Node: PROTBASE151110 -Node: Links164191 -Node: GNU Free Documentation License167625 -Node: Index192764 +Node: Comparing Protocols27287 +Node: File /inet/tcp27820 +Node: File /inet/udp28846 +Node: TCP Connecting29944 +Node: Troubleshooting32282 +Ref: Troubleshooting-Footnote-135334 +Node: Interacting35903 +Node: Setting Up38633 +Node: Email42127 +Node: Web page44453 +Ref: Web page-Footnote-147258 +Node: Primitive Service47455 +Node: Interacting Service50189 +Ref: Interacting Service-Footnote-159318 +Node: CGI Lib59350 +Node: Simple Server66311 +Ref: Simple Server-Footnote-174034 +Node: Caveats74135 +Node: Challenges75278 +Node: Some Applications and Techniques83957 +Node: PANIC86414 +Node: GETURL88132 +Node: REMCONF90755 +Node: URLCHK96231 +Node: WEBGRAB100066 +Node: STATIST104516 +Ref: STATIST-Footnote-1116224 +Node: MAZE116669 +Node: MOBAGWHO122853 +Ref: MOBAGWHO-Footnote-1136797 +Node: STOXPRED136852 +Node: PROTBASE151107 +Node: Links164188 +Node: GNU Free Documentation License167622 +Node: Index192761 End Tag Table diff --git a/doc/gawkinet.texi b/doc/gawkinet.texi index eb0f2d81..40198e1d 100644 --- a/doc/gawkinet.texi +++ b/doc/gawkinet.texi @@ -597,7 +597,7 @@ is started, @command{gawk} creates the appropriate network connection, and then two-way I/O proceeds as usual. @c last comma is part of see-also -@cindex input/output, two-way, See Also @command{gawk}, networking +@cindex input/output, two-way, See Also @command{gawk}@comma{} networking @cindex TCP/IP, sockets and At the C, C++, and Perl level, networking is accomplished via @dfn{sockets}, an Application Programming Interface (API) originally @@ -1144,9 +1144,9 @@ or the application cannot tolerate virtual circuit overhead. @node Setting Up, Email, Interacting, Using Networking @section Setting Up a Service @c last comma is part of tertiary -@cindex networks, @command{gawk} and, service, establishing +@cindex networks, @command{gawk} and, service@comma{} establishing @c last comma is part of tertiary -@cindex @command{gawk}, networking, service, establishing +@cindex @command{gawk}, networking, service@comma{} establishing The preceding programs behaved as clients that connect to a server somewhere on the Internet and request a particular service. Now we set up such a service to mimic the behavior of the @samp{daytime} service. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index b7a8e012..ac793ea7 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -1228,7 +1228,7 @@ and the program ``the @command{awk} utility.'' This @value{DOCUMENT} explains both how to write programs in the @command{awk} language and how to run the @command{awk} utility. -The term @dfn{@command{awk} program} refers to a program written by you in +The term ``@command{awk} program'' refers to a program written by you in the @command{awk} programming language. @cindex @command{gawk}, @command{awk} and @@ -3266,7 +3266,7 @@ multibyte characters. This option is an easy way to tell @command{gawk}: @item -c @itemx --traditional -@cindex @code{--c} option +@cindex @code{-c} option @cindex @code{--traditional} option @cindex compatibility mode (@command{gawk}), specifying Specify @dfn{compatibility mode}, in which the GNU extensions to @@ -3561,7 +3561,7 @@ can't access your system (other than the specified input data file). @item -t @itemx --lint-old -@cindex @code{--L} option +@cindex @code{-L} option @cindex @code{--lint-old} option Warn about constructs that are not available in the original version of @command{awk} from Version 7 Unix @@ -8481,8 +8481,8 @@ Redirections in @command{awk} are written just like redirections in shell commands, except that they are written inside the @command{awk} program. @c the commas here are part of the see also -@cindex @code{print} statement, See Also redirection, of output -@cindex @code{printf} statement, See Also redirection, of output +@cindex @code{print} statement, See Also redirection@comma{} of output +@cindex @code{printf} statement, See Also redirection@comma{} of output There are four forms of output redirection: output to a file, output appended to a file, output through a pipe to another command, and output to a coprocess. They are all shown for the @code{print} statement, @@ -19785,7 +19785,7 @@ use @code{getopt()} to process their arguments. @c STARTOFRANGE libfudata @cindex libraries of @command{awk} functions, user database, reading @c STARTOFRANGE flibudata -@cindex functions, library, user database, reading +@cindex functions, library, user database@comma{} reading @c STARTOFRANGE udatar @cindex user database@comma{} reading @c STARTOFRANGE dataur @@ -20153,7 +20153,7 @@ uses these functions. @c STARTOFRANGE libfgdata @cindex libraries of @command{awk} functions, group database, reading @c STARTOFRANGE flibgdata -@cindex functions, library, group database, reading +@cindex functions, library, group database@comma{} reading @c STARTOFRANGE gdatar @cindex group database, reading @c STARTOFRANGE datagr @@ -24092,7 +24092,7 @@ It contains the following chapters: @node Advanced Features @chapter Advanced Features of @command{gawk} -@cindex advanced features, network connections, See Also networks, connections +@cindex advanced features, network connections, See Also networks@comma{} connections @c STARTOFRANGE gawadv @cindex @command{gawk}, features, advanced @c STARTOFRANGE advgaw @@ -33761,7 +33761,7 @@ helping David Trueman, and as the primary maintainer since around 1994. @appendix Installing @command{gawk} @c last two commas are part of see also -@cindex operating systems, See Also GNU/Linux, PC operating systems, Unix +@cindex operating systems, See Also GNU/Linux@comma{} PC operating systems@comma{} Unix @c STARTOFRANGE gligawk @cindex @command{gawk}, installing @c STARTOFRANGE ingawk diff --git a/doc/texinfo.tex b/doc/texinfo.tex index 704d6645..174e4aba 100644 --- a/doc/texinfo.tex +++ b/doc/texinfo.tex @@ -3,7 +3,7 @@ % Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi % -\def\texinfoversion{2014-01-16.10} +\def\texinfoversion{2014-01-30.15} % % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, @@ -4649,6 +4649,16 @@ end \definedummyword\verb \definedummyword\w \definedummyword\xref + % + % Consider: + % @macro mkind{arg1,arg2} + % @cindex \arg2\ + % @end macro + % @mkind{foo, bar} + % The space after the comma will end up in the temporary definition + % that we make for arg2 (see \parsemargdef ff.). We want all this to be + % expanded for the sake of the index, so we end up just seeing "bar". + \let\xeatspaces = \eatspaces } % \indexnofonts is used when outputting the strings to sort the index @@ -7474,7 +7484,7 @@ end % Parse the optional {params} list. Set up \paramno and \paramlist % so \defmacro knows what to do. Define \macarg.BLAH for each BLAH -% in the params list to some hook where the argument si to be expanded. If +% in the params list to some hook where the argument is to be expanded. If % there are less than 10 arguments that hook is to be replaced by ##N where N % is the position in that list, that is to say the macro arguments are to be % defined `a la TeX in the macro body. |