Change 25253: [PATCH] POD typos
[email protected] (Rafael Garcia-Suarez) Mon, 1 Aug 2005 01:44:48 -0700
| Newsgroups | perl.perlfaq.workers,perl.perl5.changes |
|---|---|
| Message-ID | <[email protected]> |
Change 25253 by rgs@bloom on 2005/08/01 08:13:10 Subject: [PATCH] POD typos From: "Piotr Fusik" <[email protected]> Date: Sat, 30 Jul 2005 21:54:19 +0200 Message-ID: <00ef01c59542$3198ba00$26d34dd5@piec> Affected files ... ... //depot/perl/Porting/pumpkin.pod#60 edit ... //depot/perl/Porting/repository.pod#12 edit ... //depot/perl/ext/POSIX/POSIX.pod#46 edit ... //depot/perl/pod/perl593delta.pod#3 edit ... //depot/perl/pod/perlapio.pod#25 edit ... //depot/perl/pod/perldebug.pod#56 edit ... //depot/perl/pod/perldiag.pod#408 edit ... //depot/perl/pod/perlfaq2.pod#73 edit ... //depot/perl/pod/perlfaq3.pod#86 edit ... //depot/perl/pod/perlfaq4.pod#98 edit ... //depot/perl/pod/perlfaq6.pod#50 edit ... //depot/perl/pod/perlglossary.pod#4 edit ... //depot/perl/pod/perlguts.pod#131 edit ... //depot/perl/pod/perlintern.pod#44 edit ... //depot/perl/pod/perltodo.pod#99 edit ... //depot/perl/pod/perlxs.pod#45 edit ... //depot/perl/symbian/PerlBase.pod#2 edit ... //depot/perl/vms/perlvms.pod#31 edit Differences ... ==== //depot/perl/Porting/pumpkin.pod#60 (text) ==== Index: perl/Porting/pumpkin.pod --- perl/Porting/pumpkin.pod#59~24686~ Fri Jun 3 01:04:25 2005 +++ perl/Porting/pumpkin.pod Mon Aug 1 01:13:10 2005 @@ -455,7 +455,7 @@ sometimes get scrambled around, and the changes in config_H can sometimes be very hard to follow. config.sh, on the other hand, can safely be sorted, so it's easy to track (typically very small) changes -to config.sh and then propoagate them to a canned 'config.h' by any +to config.sh and then propagate them to a canned 'config.h' by any number of means, including a perl script in win32/ or carrying config.sh and config_h.SH to a Unix system and running sh config_h.SH.) Vms uses configure.com to generate its own config.sh @@ -479,7 +479,7 @@ =head2 make regen_perly -If perly.y has been edited, it is nessary to run this target to rebuild +If perly.y has been edited, it is necessary to run this target to rebuild perly.h, perly.act and perly.tab. In fact this target just runs the Perl script regen_perly.pl. Note that perly.c is I<not> rebuilt; this is just a plain static file now. @@ -587,7 +587,7 @@ the situation as it stands when you hand over the pumpkin. You might like, early in your pumpkin-holding career, to see if you -can find champions for partiticular issues on the to-do list: an issue +can find champions for particular issues on the to-do list: an issue owned is an issue more likely to be resolved. There are also some more porting-specific L</Todo> items later in this ==== //depot/perl/Porting/repository.pod#12 (text) ==== Index: perl/Porting/repository.pod --- perl/Porting/repository.pod#11~23162~ Mon Jul 26 03:41:56 2004 +++ perl/Porting/repository.pod Mon Aug 1 01:13:10 2005 @@ -359,7 +359,7 @@ /----+-----perl - Mainline development (bleadperl) +-----perlio - PerlIO Pumpkin's Perl +-----vmsperl - VMS Pumpkin's Perl - +-----maint-5.004------perl - Maintainance branches + +-----maint-5.004------perl - Maintenance branches +-----maint-5.005------perl +-----maint-5.6--------perl +-----maint-5.8--------perl ==== //depot/perl/ext/POSIX/POSIX.pod#46 (text) ==== Index: perl/ext/POSIX/POSIX.pod --- perl/ext/POSIX/POSIX.pod#45~25207~ Thu Jul 21 08:41:39 2005 +++ perl/ext/POSIX/POSIX.pod Mon Aug 1 01:13:10 2005 @@ -509,7 +509,7 @@ =item getenv -Returns the value of the specified enironment variable. +Returns the value of the specified environment variable. The same information is available through the C<%ENV> array. =item geteuid @@ -547,7 +547,7 @@ =item getpgrp This is identical to Perl's builtin C<getpgrp()> function for -returning the prcess group identifier of the current process, see +returning the process group identifier of the current process, see L<perlfunc/getpgrp>. =item getpid @@ -1249,7 +1249,7 @@ =item stat This is identical to Perl's builtin C<stat()> function -for retutning information about files and directories. +for returning information about files and directories. =item strcat ==== //depot/perl/pod/perl593delta.pod#3 (text) ==== Index: perl/pod/perl593delta.pod --- perl/pod/perl593delta.pod#2~24223~ Mon Apr 11 02:11:53 2005 +++ perl/pod/perl593delta.pod Mon Aug 1 01:13:10 2005 @@ -5,7 +5,7 @@ =head1 DESCRIPTION This document describes differences between the 5.9.2 and the 5.9.3 -developement releases. See L<perl590delta>, L<perl591delta> and +development releases. See L<perl590delta>, L<perl591delta> and L<perl592delta> for the differences between 5.8.0 and 5.9.2. =head1 Incompatible Changes ==== //depot/perl/pod/perlapio.pod#25 (text) ==== Index: perl/pod/perlapio.pod --- perl/pod/perlapio.pod#24~23496~ Fri Nov 12 12:47:19 2004 +++ perl/pod/perlapio.pod Mon Aug 1 01:13:10 2005 @@ -237,7 +237,7 @@ This corresponds to fseek(). Sends buffered write data to the underlying file, or discards any buffered read data, then positions -the file desciptor as specified by B<offset> and B<whence> (sic). +the file descriptor as specified by B<offset> and B<whence> (sic). This is the correct thing to do when switching between read and write on the same handle (see issues with PerlIO_flush() above). Offset is of type C<Off_t> which is a perl Configure value which may not be same ==== //depot/perl/pod/perldebug.pod#56 (text) ==== Index: perl/pod/perldebug.pod --- perl/pod/perldebug.pod#55~24735~ Tue Jun 7 10:03:16 2005 +++ perl/pod/perldebug.pod Mon Aug 1 01:13:10 2005 @@ -912,7 +912,7 @@ sub afterinit { push @DB::typeahead, "b 4", "b 6"; } Which would attempt to set breakpoints on lines 4 and 6 immediately -after debugger initilization. Note that @DB::typeahead is not a supported +after debugger initialization. Note that @DB::typeahead is not a supported interface and is subject to change in future releases. If you want to modify the debugger, copy F<perl5db.pl> from the ==== //depot/perl/pod/perldiag.pod#408 (text) ==== Index: perl/pod/perldiag.pod --- perl/pod/perldiag.pod#407~25198~ Wed Jul 20 04:18:59 2005 +++ perl/pod/perldiag.pod Mon Aug 1 01:13:10 2005 @@ -1642,13 +1642,13 @@ =item Filehandle %s reopened as %s only for input (W io) You opened for reading a filehandle that got the same filehandle id -as STDOUT or STDERR. This occured because you closed STDOUT or STDERR +as STDOUT or STDERR. This occurred because you closed STDOUT or STDERR previously. =item Filehandle STDIN reopened as %s only for output (W io) You opened for writing a filehandle that got the same filehandle id -as STDIN. This occured because you closed STDIN previously. +as STDIN. This occurred because you closed STDIN previously. =item Final $ should be \$ or $name @@ -2110,7 +2110,7 @@ =item length/code after end of string in unpack -(F) While unpacking, the string buffer was alread used up when an unpack +(F) While unpacking, the string buffer was already used up when an unpack length/code combination tried to obtain more data. This results in an undefined value for the length. See L<perlfunc/pack>. @@ -3379,7 +3379,7 @@ =item Repeated format line will never terminate (~~ and @# incompatible) -(F) Your format containes the ~~ repeat-until-blank sequence and a +(F) Your format contains the ~~ repeat-until-blank sequence and a numeric field that will never go blank so that the repetition never terminates. You might use ^# instead. See L<perlform>. ==== //depot/perl/pod/perlfaq2.pod#73 (text) ==== Index: perl/pod/perlfaq2.pod --- perl/pod/perlfaq2.pod#72~24684~ Fri Jun 3 00:58:10 2005 +++ perl/pod/perlfaq2.pod Mon Aug 1 01:13:10 2005 @@ -538,7 +538,7 @@ joining, starting, or requesting services for a Perl user group. http://www.cpan.org/ is the Comprehensive Perl Archive Network, -a replicated worlwide repository of Perl software, see +a replicated worldwide repository of Perl software, see the I<What is CPAN?> question earlier in this document. =head1 AUTHOR AND COPYRIGHT ==== //depot/perl/pod/perlfaq3.pod#86 (text) ==== Index: perl/pod/perlfaq3.pod --- perl/pod/perlfaq3.pod#85~24686~ Fri Jun 3 01:04:25 2005 +++ perl/pod/perlfaq3.pod Mon Aug 1 01:13:10 2005 @@ -407,7 +407,7 @@ =item Affrus -is a full Perl development enivornment with full debugger support +is a full Perl development environment with full debugger support ( http://www.latenightsw.com ). =item Alpha ==== //depot/perl/pod/perlfaq4.pod#98 (text) ==== Index: perl/pod/perlfaq4.pod --- perl/pod/perlfaq4.pod#97~24686~ Fri Jun 3 01:04:25 2005 +++ perl/pod/perlfaq4.pod Mon Aug 1 01:13:10 2005 @@ -593,7 +593,7 @@ This is documented in L<perlref>, and although it's not the easiest thing to read, it does work. In each of these examples, we call the function inside the braces of used to dereference a reference. If we -have a more than one return value, we can contruct and dereference an +have a more than one return value, we can construct and dereference an anonymous array. In this case, we call the function in list context. print "The time values are @{ [localtime] }.\n"; ==== //depot/perl/pod/perlfaq6.pod#50 (text) ==== Index: perl/pod/perlfaq6.pod --- perl/pod/perlfaq6.pod#49~24686~ Fri Jun 3 01:04:25 2005 +++ perl/pod/perlfaq6.pod Mon Aug 1 01:13:10 2005 @@ -603,7 +603,7 @@ "Perler" # no word char before P, but one after l You don't have to use \b to match words though. You can look for -non-word characters surrrounded by word characters. These strings +non-word characters surrounded by word characters. These strings match the pattern /\b'\b/. "don't" # the ' char is surrounded by "n" and "t" ==== //depot/perl/pod/perlglossary.pod#4 (text) ==== Index: perl/pod/perlglossary.pod --- perl/pod/perlglossary.pod#3~25098~ Fri Jul 8 03:04:24 2005 +++ perl/pod/perlglossary.pod Mon Aug 1 01:13:10 2005 @@ -71,7 +71,7 @@ =item architecture -The kind of compluter you're working on, where one "kind" of computer +The kind of computer you're working on, where one "kind" of computer means all those computers sharing a compatible machine language. Since Perl programs are (typically) simple text files, not executable images, a Perl program is much less sensitive to the architecture it's ==== //depot/perl/pod/perlguts.pod#131 (text) ==== Index: perl/pod/perlguts.pod --- perl/pod/perlguts.pod#130~25229~ Wed Jul 27 09:26:16 2005 +++ perl/pod/perlguts.pod Mon Aug 1 01:13:10 2005 @@ -304,7 +304,7 @@ For example, a tied SV may have a valid underlying value in the IV slot (so SvIOKp is true), but the data should be accessed via the FETCH routine rather than directly, so SvIOK is false. Another is when -numeric conversion has occured and precision has been lost: only the +numeric conversion has occurred and precision has been lost: only the private flag is set on 'lossy' values. So when an NV is converted to an IV with loss, SvIOKp, SvNOKp and SvNOK will be set, while SvIOK wont be. @@ -2298,7 +2298,7 @@ You can use these macros if you call code that may croak, but you need to do some cleanup before giving control back to Perl. For example: - dXCPT; /* set up neccessary variables */ + dXCPT; /* set up necessary variables */ XCPT_TRY_START { code_that_may_croak(); ==== //depot/perl/pod/perlintern.pod#44 (text+w) ==== Index: perl/pod/perlintern.pod --- perl/pod/perlintern.pod#43~25229~ Wed Jul 27 09:26:16 2005 +++ perl/pod/perlintern.pod Mon Aug 1 01:13:10 2005 @@ -526,7 +526,7 @@ NV+1..IV inclusive is a range of cop_seq numbers for which the name is valid. For typed lexicals name SV is SVt_PVMG and SvSTASH points at the type. For C<our> lexicals, the type is SVt_PVGV, and GvSTASH points at the -stash of the associated global (so that duplicate C<our> delarations in the +stash of the associated global (so that duplicate C<our> declarations in the same package can be detected). SvCUR is sometimes hijacked to store the generation number during compilation. @@ -704,7 +704,7 @@ =item pad_free -Free the SV at offet po in the current pad. +Free the SV at offset po in the current pad. void pad_free(PADOFFSET po) ==== //depot/perl/pod/perltodo.pod#99 (text) ==== Index: perl/pod/perltodo.pod --- perl/pod/perltodo.pod#98~25157~ Sat Jul 16 01:07:44 2005 +++ perl/pod/perltodo.pod Mon Aug 1 01:13:10 2005 @@ -312,7 +312,7 @@ =item * -Re-implement C<:unique> in a way that is actualy thread-safe +Re-implement C<:unique> in a way that is actually thread-safe =item * ==== //depot/perl/pod/perlxs.pod#45 (text) ==== Index: perl/pod/perlxs.pod --- perl/pod/perlxs.pod#44~23742~ Tue Jan 4 04:38:03 2005 +++ perl/pod/perlxs.pod Mon Aug 1 01:13:10 2005 @@ -904,7 +904,7 @@ If one of the input arguments to the C function is the length of a string argument C<NAME>, one can substitute the name of the length-argument by -C<length(NAME)> in the XSUB declaration. This argument must be omited when +C<length(NAME)> in the XSUB declaration. This argument must be omitted when the generated Perl function is called. E.g., void ==== //depot/perl/symbian/PerlBase.pod#2 (text) ==== Index: perl/symbian/PerlBase.pod --- perl/symbian/PerlBase.pod#1~24271~ Thu Apr 21 08:38:30 2005 +++ perl/symbian/PerlBase.pod Mon Aug 1 01:13:10 2005 @@ -111,7 +111,7 @@ int Run() -Start executing an interpeter. A Parse() must have been called before +Start executing an interpreter. A Parse() must have been called before a Run(): use 3 and { "", "-e", 0 } if you do not have an argv. Note that a call to Parse() is required before Run(). ==== //depot/perl/vms/perlvms.pod#31 (text) ==== Index: perl/vms/perlvms.pod --- perl/vms/perlvms.pod#30~20832~ Fri Aug 22 06:15:35 2003 +++ perl/vms/perlvms.pod Mon Aug 1 01:13:10 2005 @@ -121,7 +121,7 @@ I<N.B.> The procedure by which extensions are built and tested creates several levels (at least 4) under the directory in which the extension's source files live. -For this reason if you are runnning a version of VMS prior +For this reason if you are running a version of VMS prior to V7.1 you shouldn't nest the source directory too deeply in your directory structure lest you exceed RMS' maximum of 8 levels of subdirectory in a filespec. (You End of Patch.