[comp.lang.perl] Errata patch for TeXinfo version of perl manual 0.3

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