composer@buchm1.bu.edu (Jeff Kellem) (08/21/90)
Following is an errata patch for the TeXinfo version of the perl manual. It mainly fixes a few typos. Cheers... -jeff Jeff Kellem Internet: composer@chem.bu.edu p.s. For those that use `makeinfo', I've posted a quick patch to the bug-gnu-utils mailing list (aka gnUSENET newsgroup gnu.utils.bug) that allows the `@today{}' texinfo macro to be used. Errata for first release 0.3 of TeXinfo version of perl manual ============================================================== This patch is only needed if you obtained the TeXinfo version of the perl manual, 0.3, before 20 August 1990 6:30pm EDT. If you just grabbed this file along with the texinfo/info files, there is no need to apply this patch. It's mainly some quick typo fixes, and only a few. This patch changes the version number from 0.3 to 0.3a. Cheers... -jeff Jeff Kellem Internet: composer@chem.bu.edu ===CUT HERE===diff -c perl.texinfo{-first-release,}=== *** perl.texinfo-first-release Mon Aug 20 13:01:14 1990 --- perl.texinfo Mon Aug 20 18:55:50 1990 *************** *** 41,47 **** @titlepage @title Perl Manual (@TeX{}info version) @subtitle for perl version 3.0 patchlevel 28 ! @subtitle Version 0.3, dated 16 August 1990, printed on @today{} @sp 2 @center This is a @strong{DRAFT} copy of the @TeX{}info version of the perl manual! --- 41,47 ---- @titlepage @title Perl Manual (@TeX{}info version) @subtitle for perl version 3.0 patchlevel 28 ! @subtitle Version 0.3a, dated 20 August 1990, printed on @today{} @sp 2 @center This is a @strong{DRAFT} copy of the @TeX{}info version of the perl manual! *************** *** 77,83 **** @comment node-name, next, previous, up @ifinfo ! This Info file contains edition 0.3, dated 16 August 1990, "printed" on @today{} of the Perl Manual for Perl version 3.0 patchlevel 28. This is a @strong{DRAFT} copy of the @TeX{}info version of the perl manual! --- 77,83 ---- @comment node-name, next, previous, up @ifinfo ! This Info file contains edition 0.3a, dated 20 August 1990, "printed" on @today{} of the Perl Manual for Perl version 3.0 patchlevel 28. This is a @strong{DRAFT} copy of the @TeX{}info version of the perl manual! *************** *** 1270,1276 **** level of @samp{$} interpretation is done first, but you can't say @samp{<$foo>} because that's an indirect filehandle as explained in the previous paragraph. You could insert curly brackets to force ! interpretation as a filename glob: @samp{<${foo}>}. Example:@refill @example while (<*.c>) @{ --- 1270,1276 ---- level of @samp{$} interpretation is done first, but you can't say @samp{<$foo>} because that's an indirect filehandle as explained in the previous paragraph. You could insert curly brackets to force ! interpretation as a filename glob: @samp{<$@{foo@}>}. Example:@refill @example while (<*.c>) @{ *************** *** 1679,1685 **** @noindent As an array operator: @example ! for (101 .. 200) { print; } # print $_ 100 times @@foo = @@foo[$[ .. $#foo]; # an expensive no-op @@foo = @@foo[$#foo-4 .. $#foo]; # slice last 5 items --- 1679,1685 ---- @noindent As an array operator: @example ! for (101 .. 200) @{ print; @} # print $_ 100 times @@foo = @@foo[$[ .. $#foo]; # an expensive no-op @@foo = @@foo[$#foo-4 .. $#foo]; # slice last 5 items *************** *** 1856,1862 **** portable way to find out the home directory might be:@refill @example ! $home = $ENV{'HOME'} || $ENV{'LOGDIR'} || (getpwuid($<))[7] || die "You're homeless!\en"; @end example --- 1856,1862 ---- portable way to find out the home directory might be:@refill @example ! $home = $ENV@{'HOME'@} || $ENV@{'LOGDIR'@} || (getpwuid($<))[7] || die "You're homeless!\en"; @end example *************** *** 1886,1893 **** @cindex List of Commands @cindex Command Syntax - @menu @c @@@@ this menu should probably be broken into subgroups @@@@ * Math Functions:: Various trigonometric and math functions. * Structure Conversion:: How to convert binary structures. * String Functions:: Functions to interact with strings. --- 1886,1895 ---- @cindex List of Commands @cindex Command Syntax @c @@@@ this menu should probably be broken into subgroups @@@@ + @c @@@@ taken out of menu 'cos makeinfo did not like it .. @@@@ + @c @@@@ still formatted okay .. just gave warning @@@@ + @menu * Math Functions:: Various trigonometric and math functions. * Structure Conversion:: How to convert binary structures. * String Functions:: Functions to interact with strings. *************** *** 1905,1913 **** * Subroutine Functions:: Functions related to user-defined subs. * Variable Functions:: Functions dealing with variables. (not already mentioned) - @c @@@@ reword above 2 lines @@@@ * Miscellaneous Functions:: A catch-all for all other functions. ;-) @end menu @node Math Functions, Structure Conversion, , Commands @comment node-name, next, previous, up --- 1907,1917 ---- * Subroutine Functions:: Functions related to user-defined subs. * Variable Functions:: Functions dealing with variables. (not already mentioned) * Miscellaneous Functions:: A catch-all for all other functions. ;-) @end menu + @c @@@@ reword above 2 lines @@@@ + @c @@@@ above 2 lines now refers to "Variable Functions" menu item @@@@ + @c @@@@ see comment above menu @@@@ @node Math Functions, Structure Conversion, , Commands @comment node-name, next, previous, up *************** *** 2056,2062 **** follows:@refill @ignore ! Comments on f & d by gnb@melba.bby.oz.au 22 Nov 89 @end ignore @example A An ascii string, will be space padded. --- 2060,2066 ---- follows:@refill @ignore ! Comments on f & d by gnb@@melba.bby.oz.au 22 Nov 89 @end ignore @example A An ascii string, will be space padded. *************** *** 2309,2317 **** @cindex Example, deleting values of associative arrays @end ifinfo @example ! foreach $key (keys %ARRAY) { ! delete $ARRAY{$key}; ! } @end example (But it would be faster to use the @code{reset} command. Saying --- 2313,2321 ---- @cindex Example, deleting values of associative arrays @end ifinfo @example ! foreach $key (keys %ARRAY) @{ ! delete $ARRAY@{$key@}; ! @} @end example (But it would be faster to use the @code{reset} command. Saying *************** *** 4573,4579 **** Suitable for feeding to @code{gmtime()} and @code{localtime()}.@refill @end table ! @node DBM Functions, Miscellaneous Functions, Time Functions, Commands @comment node-name, next, previous, up @section DBM Functions @cindex dbm functions --- 4577,4583 ---- Suitable for feeding to @code{gmtime()} and @code{localtime()}.@refill @end table ! @node DBM Functions, Flow Control Functions, Time Functions, Commands @comment node-name, next, previous, up @section DBM Functions @cindex dbm functions *************** *** 4815,4821 **** except that it's more efficient, more concise, keeps track of the current filename for error messages, and searches all the @samp{-I} libraries if the file isn't in the current directory (@pxref{Predefined ! Names,``@@INC'' array}, for more info). It's the same, however, in that it does reparse the file every time you call it, so if you are going to use the file inside a loop you might prefer to use @samp{-P} and @samp{#include}, at the expense of a little more startup time. (The --- 4819,4825 ---- except that it's more efficient, more concise, keeps track of the current filename for error messages, and searches all the @samp{-I} libraries if the file isn't in the current directory (@pxref{Predefined ! Names,``INC'' array}, for more info). It's the same, however, in that it does reparse the file every time you call it, so if you are going to use the file inside a loop you might prefer to use @samp{-P} and @samp{#include}, at the expense of a little more startup time. (The *************** *** 7103,7109 **** The environment is not automatically made available as variables.@refill @end itemize ! @node Bugs, Command Summary, Traps, Top @comment node-name, next, previous, up @chapter Bugs @cindex Bugs --- 7107,7113 ---- The environment is not automatically made available as variables.@refill @end itemize ! @node Bugs, Credits, Traps, Top @comment node-name, next, previous, up @chapter Bugs @cindex Bugs *************** *** 7140,7146 **** @TeX{}info version of @emph{perl} manual by@dots{} @dots{}Jeff Kellem <composer@@chem.bu.edu> ! @node Command Summary, Concept Index, Bugs, Top @comment node-name, next, previous, up @appendix Command Summary (syntax only) @cindex Command Summary (syntax only) --- 7144,7150 ---- @TeX{}info version of @emph{perl} manual by@dots{} @dots{}Jeff Kellem <composer@@chem.bu.edu> ! @node Command Summary, Function Index, Credits, Top @comment node-name, next, previous, up @appendix Command Summary (syntax only) @cindex Command Summary (syntax only) *************** *** 7192,7198 **** dbmopen(ASSOC,DBNAME,MODE) defined(EXPR) defined EXPR ! delete $ASSOC{KEY} die(LIST) die LIST die --- 7196,7202 ---- dbmopen(ASSOC,DBNAME,MODE) defined(EXPR) defined EXPR ! delete $ASSOC@{KEY@} die(LIST) die LIST die