From: Abigail Date: Tue, 5 Jan 1999 12:01:42 +0000 (-0500) Subject: Jumbo doc patch from Abigail (almost identical to X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=de592821d3f82766f756d9769074aec8d884d942;p=p5sagit%2Fp5-mst-13.2.git Jumbo doc patch from Abigail (almost identical to the 5.005-maint change #2562 except for the ext/IO/lib/IO/Socket.pm patch which was not applicable because the IO version of 5.005-devel is somewhat different (why?)) Message-ID: <19990105170142.4889.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03-TRIAL2 lib/ExtUtils/Liblist.pm] pod fixes Date: Tue, 5 Jan 1999 12:01:42 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105172855.5115.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 MAINT2 lib/ExtUtils/Commands.pm] Typo fix. Date: Tue, 5 Jan 1999 12:28:55 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105173808.5260.qmail@alexandra.wayne.fnx.com> Subject: [PATCH perl5.005_03 MAINT3 lib/ExtUtils/Embed.pm] Typo fix Date: Tue, 5 Jan 1999 12:38:08 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105174859.5533.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 MAINT2 lib/ExtUtils/Install.pm] Typo fix Date: Tue, 5 Jan 1999 12:48:59 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105174947.5547.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 lib/ExtUtils/MM_Unix.pm] Typo fixes Date: Tue, 5 Jan 1999 12:49:46 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105182301.5966.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 lib/ExtUtils/MakeMaker.pm] Typos fixes. Date: Tue, 5 Jan 1999 13:23:00 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105183344.6065.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 TRIAL2 lib/ExtUtils/Manifest.pm] Typo fixes Date: Tue, 5 Jan 1999 13:33:44 -0500 (EST) From: abigail@fnx.com Message-ID: <19990105184028.6220.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 TRIAL2 lib/ExtUtils/Mksymlists.pm] Typo fix Date: Tue, 5 Jan 1999 13:40:28 -0500 (EST) From: abigail@fnx.com Message-ID: <19990106012015.9451.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 TRIAL2 lib/IO/Pipe.pm] Typo fixes. Date: Tue, 5 Jan 1999 20:20:15 -0500 (EST) From: abigail@fnx.com Message-ID: <19990106012047.9459.qmail@alexandra.wayne.fnx.com> Subject: [PATCH 5.005_03 TRAIL2 lib/IO/Seekable.pm] Typo fixes Date: Tue, 5 Jan 1999 20:20:47 -0500 (EST) p4raw-link: @2562 on //depot/maint-5.005/perl: ea6328d3b8eaabcf5a54869eeea7771d78f51f1e p4raw-id: //depot/cfgperl@2569 --- diff --git a/ext/IO/lib/IO/Pipe.pm b/ext/IO/lib/IO/Pipe.pm index 59f6293..3a91b9e 100644 --- a/ext/IO/lib/IO/Pipe.pm +++ b/ext/IO/lib/IO/Pipe.pm @@ -189,10 +189,10 @@ IO::Pipe - supply object methods for pipes =head1 DESCRIPTION -C provides an interface to createing pipes between +C provides an interface to creating pipes between processes. -=head1 CONSTRCUTOR +=head1 CONSTRUCTOR =over 4 diff --git a/ext/IO/lib/IO/Seekable.pm b/ext/IO/lib/IO/Seekable.pm index de982ed..6c07e94 100644 --- a/ext/IO/lib/IO/Seekable.pm +++ b/ext/IO/lib/IO/Seekable.pm @@ -14,7 +14,7 @@ IO::Seekable - supply seek based methods for I/O objects =head1 DESCRIPTION -C does not have a constuctor of its own as is intended to +C does not have a constructor of its own as it is intended to be inherited by other C based objects. It provides methods which allow seeking of the file descriptors. diff --git a/lib/ExtUtils/Command.pm b/lib/ExtUtils/Command.pm index 2f5f1e1..e900e51 100644 --- a/lib/ExtUtils/Command.pm +++ b/lib/ExtUtils/Command.pm @@ -31,8 +31,8 @@ ExtUtils::Command - utilities to replace common UNIX commands in Makefiles etc. =head1 DESCRIPTION -The module is used in Win32 port to replace common UNIX commands. -Most commands are wrapers on generic modules File::Path and File::Basename. +The module is used in the Win32 port to replace common UNIX commands. +Most commands are wrappers on generic modules File::Path and File::Basename. =over 4 diff --git a/lib/ExtUtils/Embed.pm b/lib/ExtUtils/Embed.pm index e41ca40..4b56e88 100644 --- a/lib/ExtUtils/Embed.pm +++ b/lib/ExtUtils/Embed.pm @@ -416,7 +416,7 @@ This will print arguments for linking with B, B and extensions found in B<$Config{static_ext}>. This includes libraries found in B<$Config{libs}> and the first ModuleName.a library for each extension that is found by searching B<@INC> or the path -specifed by the B<-I> option. +specified by the B<-I> option. In addition, when ModuleName.a is found, additional linker arguments are picked up from the B file in the same directory. diff --git a/lib/ExtUtils/Install.pm b/lib/ExtUtils/Install.pm index 6a5c184..f75aa55 100644 --- a/lib/ExtUtils/Install.pm +++ b/lib/ExtUtils/Install.pm @@ -354,7 +354,7 @@ The argument is the value of MakeMaker's C key, like F. This function calls install() with the same arguments as the defaults the MakeMaker would use. -The argumement-less form is convenient for install scripts like +The argument-less form is convenient for install scripts like perl -MExtUtils::Install -e install_default Tk/Canvas diff --git a/lib/ExtUtils/Liblist.pm b/lib/ExtUtils/Liblist.pm index 1710c5e..dae3125 100644 --- a/lib/ExtUtils/Liblist.pm +++ b/lib/ExtUtils/Liblist.pm @@ -578,7 +578,7 @@ Unix-OS/2 version in several respects: =item * Input library and path specifications are accepted with or without the -C<-l> and C<-L> prefices used by Unix linkers. If neither prefix is +C<-l> and C<-L> prefixes used by Unix linkers. If neither prefix is present, a token is considered a directory to search if it is in fact a directory, and a library to search for otherwise. Authors who wish their extensions to be portable to Unix or OS/2 should use the Unix @@ -589,7 +589,7 @@ prefixes, since the Unix-OS/2 version of ext() requires them. Wherever possible, shareable images are preferred to object libraries, and object libraries to plain object files. In accordance with VMS naming conventions, ext() looks for files named Ishr and Irtl; -it also looks for Ilib and libI to accomodate Unix conventions +it also looks for Ilib and libI to accommodate Unix conventions used in some ported software. =item * @@ -636,7 +636,7 @@ library pathnames is generated. =item * Input library and path specifications are accepted with or without the -C<-l> and C<-L> prefices used by Unix linkers. +C<-l> and C<-L> prefixes used by Unix linkers. An entry of the form C<-La:\foo> specifies the C directory to look for the libraries that follow. @@ -655,7 +655,7 @@ library to search for otherwise. The C<$Config{lib_ext}> suffix will be appended to any entries that are not directories and don't already have the suffix. -Note that the C<-L> and <-l> prefixes are B, but authors +Note that the C<-L> and C<-l> prefixes are B, but authors who wish their extensions to be portable to Unix or OS/2 should use the prefixes, since the Unix-OS/2 version of ext() requires them. diff --git a/lib/ExtUtils/MM_Unix.pm b/lib/ExtUtils/MM_Unix.pm index d36741c..43d37ff 100644 --- a/lib/ExtUtils/MM_Unix.pm +++ b/lib/ExtUtils/MM_Unix.pm @@ -819,7 +819,7 @@ ci : =item dist_core (o) -Defeines the targets dist, tardist, zipdist, uutardist, shdist +Defines the targets dist, tardist, zipdist, uutardist, shdist =cut @@ -2789,7 +2789,7 @@ Returns the attribute C or the string C<644>. Used as the string that is passed to the C command to set the permissions for read/writeable files. MakeMaker chooses C<644> because it has turned out in the past that -relying on the umask provokes hard-to-track bugreports. +relying on the umask provokes hard-to-track bug reports. When the return value is used by the perl function C, it is interpreted as an octal value. @@ -3469,7 +3469,7 @@ Version_check: =item writedoc -Obsolete, depecated method. Not used since Version 5.21. +Obsolete, deprecated method. Not used since Version 5.21. =cut diff --git a/lib/ExtUtils/MakeMaker.pm b/lib/ExtUtils/MakeMaker.pm index 6bc0f6c..070156b 100644 --- a/lib/ExtUtils/MakeMaker.pm +++ b/lib/ExtUtils/MakeMaker.pm @@ -1022,7 +1022,7 @@ This will replace the string specified by $Config{prefix} in all $Config{install*} values. Note, that in both cases the tilde expansion is done by MakeMaker, not -by perl by default, nor by make. Conflicts between parmeters LIB, +by perl by default, nor by make. Conflicts between parameters LIB, PREFIX and the various INSTALL* arguments are resolved so that XXX @@ -1288,7 +1288,7 @@ is ignored if INCLUDE_EXT is present. Consult INCLUDE_EXT for more details. (e.g. [ qw( Socket POSIX ) ] ) This attribute may be most useful when specified as a string on the -commandline: perl Makefile.PL EXCLUDE_EXT='Socket Safe' +command line: perl Makefile.PL EXCLUDE_EXT='Socket Safe' =item EXE_FILES @@ -1339,7 +1339,7 @@ filling in INCLUDE_EXT. If the INCLUDE_EXT is mentioned but is empty then only DynaLoader and the current extension will be included in the build. This attribute may be most useful when specified as a string on the -commandline: perl Makefile.PL INCLUDE_EXT='POSIX Socket Devel::Peek' +command line: perl Makefile.PL INCLUDE_EXT='POSIX Socket Devel::Peek' =item INSTALLARCHLIB @@ -1563,7 +1563,7 @@ avoided, it may be undefined) =item PERM_RW -Desired Permission for read/writable files. Defaults to C<644>. +Desired permission for read/writable files. Defaults to C<644>. See also L. =item PERM_RWX diff --git a/lib/ExtUtils/Manifest.pm b/lib/ExtUtils/Manifest.pm index 5557089..1a6dde7 100644 --- a/lib/ExtUtils/Manifest.pm +++ b/lib/ExtUtils/Manifest.pm @@ -298,7 +298,7 @@ but in doing so checks each line in an existing C file and includes any comments that are found in the existing C file in the new one. Anything between white space and an end of line within a C file is considered to be a comment. Filenames and -comments are seperated by one or more TAB characters in the +comments are separated by one or more TAB characters in the output. All files that match any regular expression in a file C (if such a file exists) are ignored. @@ -317,7 +317,7 @@ Fullcheck() does both a manicheck() and a filecheck(). Skipcheck() lists all the files that are skipped due to your C file. -Manifind() retruns a hash reference. The keys of the hash are the +Manifind() returns a hash reference. The keys of the hash are the files found below the current directory. Maniread($file) reads a named C file (defaults to diff --git a/lib/ExtUtils/Mksymlists.pm b/lib/ExtUtils/Mksymlists.pm index 151f44e..76535d9 100644 --- a/lib/ExtUtils/Mksymlists.pm +++ b/lib/ExtUtils/Mksymlists.pm @@ -254,7 +254,7 @@ This provides an alternate means to specify function names to be exported from the extension. Its value is a reference to an array of function names to be exported by the extension. These names are passed through unaltered to the linker options file. -Specifying a value for the FUNCLIST attribute supresses automatic +Specifying a value for the FUNCLIST attribute suppresses automatic generation of the bootstrap function for the package. To still create the bootstrap name you have to specify the package name in the DL_FUNCS hash: