diff options
Diffstat (limited to 'lib')
39 files changed, 105 insertions, 105 deletions
diff --git a/lib/Attribute/Handlers.pm b/lib/Attribute/Handlers.pm index aa42bc8912..5e8f86162c 100644 --- a/lib/Attribute/Handlers.pm +++ b/lib/Attribute/Handlers.pm @@ -279,7 +279,7 @@ attribute C<:ATTR>. For example: "in phase $phase\n"; } -This creates an handler for the attribute C<:Loud> in the class LoudDecl. +This creates a handler for the attribute C<:Loud> in the class LoudDecl. Thereafter, any subroutine declared with a C<:Loud> attribute in the class LoudDecl: @@ -441,7 +441,7 @@ the data argument (C<$_[4]>) to a useable form before passing it to the handler get in the way. You can turn off that eagerness-to-help by declaring -an attribute handler with the the keyword C<RAWDATA>. For example: +an attribute handler with the keyword C<RAWDATA>. For example: sub Raw : ATTR(RAWDATA) {...} sub Nekkid : ATTR(SCALAR,RAWDATA) {...} diff --git a/lib/AutoSplit.t b/lib/AutoSplit.t index dbd003d446..8d764c1eef 100644 --- a/lib/AutoSplit.t +++ b/lib/AutoSplit.t @@ -369,7 +369,7 @@ is (&*MOD*::zombie, "You didn't use fire.", "Are our zombies undead?"); True, so don't scrub this directory. ################################################################ ## Name -Without the the timestamp check make sure that nothing happens +Without the timestamp check make sure that nothing happens ## Extra 0, 1, 1 ## Require @@ -391,7 +391,7 @@ is (&*MOD*::zombie, "You didn't use fire.", "Are our zombies still undead?"); True, so don't scrub this directory. ################################################################ ## Name -With the the timestamp check make sure that things happen (stuff gets deleted) +With the timestamp check make sure that things happen (stuff gets deleted) ## Extra 0, 1, 0 ## Get diff --git a/lib/CGI.pm b/lib/CGI.pm index 0be5060dcb..6ad0191cb2 100644 --- a/lib/CGI.pm +++ b/lib/CGI.pm @@ -4300,7 +4300,7 @@ such as expiration time. Use the cookie() method to create and retrieve session cookies. The B<-nph> parameter, if set to a true value, will issue the correct -headers to work with a NPH (no-parse-header) script. This is important +headers to work with an NPH (no-parse-header) script. This is important to use with certain servers that expect all their scripts to be NPH. The B<-charset> parameter can be used to control the character set @@ -4337,7 +4337,7 @@ You can also use named arguments: -nph=>1); The B<-nph> parameter, if set to a true value, will issue the correct -headers to work with a NPH (no-parse-header) script. This is important +headers to work with an NPH (no-parse-header) script. This is important to use with certain servers, such as Microsoft Internet Explorer, which expect all their scripts to be NPH. @@ -4723,14 +4723,14 @@ you prefer: <IMG ALIGN="LEFT" SRC="fred.gif"> Sometimes an HTML tag attribute has no argument. For example, ordered -lists can be marked as COMPACT. The syntax for this is an argument that +lists can be marked as COMPACT. The syntax for this is an argument that points to an undef string: print ol({compact=>undef},li('one'),li('two'),li('three')); Prior to CGI.pm version 2.41, providing an empty ('') string as an attribute argument was the same as providing undef. However, this has -changed in order to accommodate those who want to create tags of the form +changed in order to accommodate those who want to create tags of the form <IMG ALT="">. The difference is shown in these two pieces of code: CODE RESULT diff --git a/lib/CGI/Fast.pm b/lib/CGI/Fast.pm index 669b38e010..f165acfaea 100644 --- a/lib/CGI/Fast.pm +++ b/lib/CGI/Fast.pm @@ -31,7 +31,7 @@ sub save_request { # no-op } -# If ENV{FCGI_SOCKET_PATH} is specified, we maintain a FCGI Request handle +# If ENV{FCGI_SOCKET_PATH} is specified, we maintain an FCGI Request handle # in this package variable. use vars qw($Ext_Request); BEGIN { @@ -187,7 +187,7 @@ documentation for C<FCGI::OpenSocket> for more information.) =item FCGI_SOCKET_PATH The address (TCP/IP) or path (UNIX Domain) of the socket the external FastCGI -script to which bind an listen for incoming connections from the web server. +script to which bind can listen for incoming connections from the web server. =item FCGI_LISTEN_QUEUE diff --git a/lib/CPAN.pm b/lib/CPAN.pm index de1158d97c..948ec46b31 100644 --- a/lib/CPAN.pm +++ b/lib/CPAN.pm @@ -5475,7 +5475,7 @@ sub inst_version { # compare it use utility for compare # print it do nothing - # Alt2 maintain it as what is is + # Alt2 maintain it as what it is # read index files convert # compare it use utility because there's still a ">" vs "gt" issue # print it use CPAN::Version for print @@ -6319,7 +6319,7 @@ current session. Changes to the directory where the distribution has been unpacked and runs the external command C<make install> there. If C<make> has not yet been run, it will be run first. A C<make test> will be issued in -any case and if this fails, the install will be cancelled. The +any case and if this fails, the install will be canceled. The cancellation can be avoided by letting C<force> run the C<install> for you. @@ -6406,7 +6406,7 @@ Runs a cvs_import on the distribution associated with this module. =item CPAN::Module::description() -Returns a 44 chracter description of this module. Only available for +Returns a 44 character description of this module. Only available for modules listed in The Module List (CPAN/modules/00modlist.long.html or 00modlist.long.txt.gz) @@ -6438,7 +6438,7 @@ Runs an C<install> on the distribution associated with this module. =item CPAN::Module::look() -Changes to the directory where the distribution assoicated with this +Changes to the directory where the distribution associated with this module has been unpacked and opens a subshell there. Exiting the subshell returns. @@ -6527,7 +6527,7 @@ If you have a local mirror of CPAN and can access all files with "file:" URLs, then you only need a perl better than perl5.003 to run this module. Otherwise Net::FTP is strongly recommended. LWP may be required for non-UNIX systems or if your nearest CPAN site is -associated with an URL that is not C<ftp:>. +associated with a URL that is not C<ftp:>. If you have neither Net::FTP nor LWP, there is a fallback mechanism implemented for an external ftp command or for an external lynx @@ -6709,7 +6709,7 @@ development will go towards strong authentication. Most functions in package CPAN are exported per default. The reason for this is that the primary use is intended for the cpan shell or for -oneliners. +one-liners. =head1 POPULATE AN INSTALLATION WITH LOTS OF MODULES @@ -6758,14 +6758,14 @@ This is where the firewall machine runs a web server and to access the outside world you must do it via the web server. If you set environment variables like http_proxy or ftp_proxy to a values beginning with http:// or in your web browser you have to set proxy information then you know -you are running a http firewall. +you are running an http firewall. To access servers outside these types of firewalls with perl (even for ftp) you will need to use LWP. =item ftp firewall -This where the firewall machine runs a ftp server. This kind of +This where the firewall machine runs an ftp server. This kind of firewall will only let you access ftp servers outside the firewall. This is usually done by connecting to the firewall with ftp, then entering a username like "user@outside.host.com" @@ -6775,7 +6775,7 @@ will need to use Net::FTP. =item One way visibility -I say one way visibility as these firewalls try to make themselve look +I say one way visibility as these firewalls try to make themselves look invisible to the users inside the firewall. An FTP data connection is normally created by sending the remote server your IP address and then listening for the connection. But the remote server will not be able to @@ -6819,7 +6819,7 @@ like o conf ncftp "/usr/bin/ncftp -f /home/scott/ncftplogin.cfg" -Your milage may vary... +Your mileage may vary... =head1 FAQ diff --git a/lib/Digest.pm b/lib/Digest.pm index 047380ebeb..9727a1c4b9 100644 --- a/lib/Digest.pm +++ b/lib/Digest.pm @@ -124,7 +124,7 @@ load the right module on first use. The second form allow you to use algorithm names which contains letters which are not legal perl identifiers, e.g. "SHA-1". -If new() is called as a instance method (i.e. $ctx->new) it will just +If new() is called as an instance method (i.e. $ctx->new) it will just reset the state the object to the state of a newly created object. No new object is created in this case, and the return value is the reference to the object (i.e. $ctx). diff --git a/lib/ExtUtils/Constant.pm b/lib/ExtUtils/Constant.pm index cb3931821d..57b471f6de 100644 --- a/lib/ExtUtils/Constant.pm +++ b/lib/ExtUtils/Constant.pm @@ -300,7 +300,7 @@ I<VALUE> when not defined. If I<TYPE> is aggregate (eg I<PVN> expects both pointer and length) then I<VALUE> should be a reference to an array of values in the order expected by the type. C<C_constant> will always call this function with I<MACRO> defined, defaulting to the constant's name. -I<DEFAULT> if defined is an array reference giving default type and and +I<DEFAULT> if defined is an array reference giving default type and value(s) if the clause generated by I<MACRO> doesn't evaluate to true. The two pairs I<PRE> and I<POST> if defined give C code snippets to proceed and follow the value, and the default value. @@ -853,7 +853,7 @@ be the same list of types as C<C_constant> was given. the number of parameters passed to the C function C<constant>] You can call the perl visible subroutine something other than C<constant> if -you give the parameter I<SUBNAME>. The C subroutine it calls defaults to the +you give the parameter I<SUBNAME>. The C subroutine it calls defaults to the name of the perl visible subroutine, unless you give the parameter I<C_SUBNAME>. @@ -1047,7 +1047,7 @@ END WriteMakefileSnippet ATTRIBUTE =E<gt> VALUE [, ...] -An function to generate perl code for Makefile.PL that will regenerate +A function to generate perl code for Makefile.PL that will regenerate the constant subroutines. Parameters are named as passed to C<WriteConstants>, with the addition of C<INDENT> to specify the number of leading spaces (default 2). diff --git a/lib/ExtUtils/MM_Unix.pm b/lib/ExtUtils/MM_Unix.pm index 0645268d91..8370f213dd 100644 --- a/lib/ExtUtils/MM_Unix.pm +++ b/lib/ExtUtils/MM_Unix.pm @@ -1801,7 +1801,7 @@ usually solves this kind of problem. $self->{INST_SCRIPT} ||= $self->catdir($self->curdir,'blib','script'); # The user who requests an installation directory explicitly - # should not have to tell us a architecture installation directory + # should not have to tell us an architecture installation directory # as well. We look if a directory exists that is named after the # architecture. If not we take it as a sign that it should be the # same as the requested installation directory. Otherwise we take diff --git a/lib/File/Temp.pm b/lib/File/Temp.pm index 97b2895f12..0df1af4941 100644 --- a/lib/File/Temp.pm +++ b/lib/File/Temp.pm @@ -736,7 +736,7 @@ sub _is_verysafe { # Split directory into components - assume no file my ($volume, $directories, undef) = File::Spec->splitpath( $path, 1); - # Slightly less efficient than having a a function in File::Spec + # Slightly less efficient than having a function in File::Spec # to chop off the end of a directory or even a function that # can handle ../ in a directory tree # Sometimes splitdir() returns a blank at the end diff --git a/lib/Getopt/Long.pm b/lib/Getopt/Long.pm index 957c272549..6f3d18e847 100644 --- a/lib/Getopt/Long.pm +++ b/lib/Getopt/Long.pm @@ -1193,7 +1193,7 @@ STDERR, and return a false result. Getopt::Long supports two useful variants of simple options: I<negatable> options and I<incremental> options. -A negatable option is specified with a exclamation mark C<!> after the +A negatable option is specified with an exclamation mark C<!> after the option name: my $verbose = ''; # option variable with default value (false) diff --git a/lib/I18N/LangTags/List.pm b/lib/I18N/LangTags/List.pm index a143d4ce56..ca5ae42c09 100644 --- a/lib/I18N/LangTags/List.pm +++ b/lib/I18N/LangTags/List.pm @@ -1563,7 +1563,7 @@ Copyright (c) 2001 Sean M. Burke. All rights reserved. You can redistribute and/or modify this document under the same terms as Perl itself. -This document is provided in the the hope that it will be +This document is provided in the hope that it will be useful, but without any warranty; without even the implied warranty of accuracy, authoritativeness, completeness, merchantability, or fitness for a particular purpose. diff --git a/lib/Locale/Maketext.pod b/lib/Locale/Maketext.pod index 2983492a96..916fd34b19 100644 --- a/lib/Locale/Maketext.pod +++ b/lib/Locale/Maketext.pod @@ -888,7 +888,7 @@ but since you anticipate localizing this, you write: my $lh = ThisProject::I18N->get_handle(); # For the moment, assume that things are set up so # that we load class ThisProject::I18N::en - # and that that's the class that $lh belongs to. + # and that's the class that $lh belongs to. ... if(-e $filename) { go_process_file($filename) diff --git a/lib/Locale/Maketext/TPJ13.pod b/lib/Locale/Maketext/TPJ13.pod index 5c2f28cab4..dc01b64e7a 100644 --- a/lib/Locale/Maketext/TPJ13.pod +++ b/lib/Locale/Maketext/TPJ13.pod @@ -48,7 +48,7 @@ messages, like this: Your query matched 10 files in 4 directories. -So how hard could that be? You look at the code that produces +So how hard could that be? You look at the code that produces the first item, and it reads: printf("I scanned %g directories.", @@ -222,7 +222,7 @@ ending... The room begins to spin around you, slowly at first... But with I<all other> integer values, since "directory" is an inanimate noun, when preceded by a number and in the nominative or accusative cases (as it is here, just your luck!), it does stay plural, but it is -forced into the genitive case -- yet another another ending... And +forced into the genitive case -- yet another ending... And you never hear him get to the part about how you're going to run into similar (but maybe subtly different) problems with other Slavic languages like Polish, because the floor comes up to meet you, and you diff --git a/lib/Math/Complex.pm b/lib/Math/Complex.pm index 4634d0f404..19d30b062e 100644 --- a/lib/Math/Complex.pm +++ b/lib/Math/Complex.pm @@ -1561,7 +1561,7 @@ be called an extension, would it?). A I<new> operation possible on a complex number that is the identity for real numbers is called the I<conjugate>, and is noted -with an horizontal bar above the number, or C<~z> here. +with a horizontal bar above the number, or C<~z> here. z = a + bi ~z = a - bi @@ -1660,7 +1660,7 @@ I<arg>, I<abs>, I<log>, I<csc>, I<cot>, I<acsc>, I<acot>, I<csch>, I<coth>, I<acosech>, I<acotanh>, have aliases I<rho>, I<theta>, I<ln>, I<cosec>, I<cotan>, I<acosec>, I<acotan>, I<cosech>, I<cotanh>, I<acosech>, I<acotanh>, respectively. C<Re>, C<Im>, C<arg>, C<abs>, -C<rho>, and C<theta> can be used also also mutators. The C<cbrt> +C<rho>, and C<theta> can be used also as mutators. The C<cbrt> returns only one of the solutions: if you want all three, use the C<root> function. @@ -1836,7 +1836,7 @@ or Died at... For the C<csc>, C<cot>, C<asec>, C<acsc>, C<acot>, C<csch>, C<coth>, -C<asech>, C<acsch>, the argument cannot be C<0> (zero). For the the +C<asech>, C<acsch>, the argument cannot be C<0> (zero). For the logarithmic functions and the C<atanh>, C<acoth>, the argument cannot be C<1> (one). For the C<atanh>, C<acoth>, the argument cannot be C<-1> (minus one). For the C<atan>, C<acot>, the argument cannot be diff --git a/lib/Memoize/Expire.pm b/lib/Memoize/Expire.pm index 8bd5999077..b3ab10a69f 100644 --- a/lib/Memoize/Expire.pm +++ b/lib/Memoize/Expire.pm @@ -344,7 +344,7 @@ with a lifetime of ten seconds, and you store it at 12:00:00.998 on a certain day. Memoize will look at the clock and see 12:00:00. Then 9.01 seconds later, at 12:00:10.008 you try to read it back. Memoize will look at the clock and see 12:00:10 and conclude that the value -has expired. This will probably not occur if if you have +has expired. This will probably not occur if you have C<Time::HiRes> installed. =head1 AUTHOR diff --git a/lib/NEXT/README b/lib/NEXT/README index 471b2bb796..7202d00fde 100644 --- a/lib/NEXT/README +++ b/lib/NEXT/README @@ -25,7 +25,7 @@ DESCRIPTION the current class -- to look for a suitable method in other ancestors of C<$self> -- whereas C<$self->SUPER::m()> cannot. - An particularly interesting use of redispatch is in + A particularly interesting use of redispatch is in C<AUTOLOAD>'ed methods. If such a method determines that it is not able to handle a particular call, it may choose to redispatch that call, in the hope that some other C<AUTOLOAD> diff --git a/lib/Net/Config.eg b/lib/Net/Config.eg index 450acacd76..77dc1f138b 100644 --- a/lib/Net/Config.eg +++ b/lib/Net/Config.eg @@ -26,7 +26,7 @@ use strict; # your internet domain inet_domain => undef, - # If you have an ftp proxy firewall (not a http firewall) + # If you have an ftp proxy firewall (not an http firewall) # then set this to the name of the firewall ftp_firewall => undef, diff --git a/lib/Net/Config.pm b/lib/Net/Config.pm index 5a262fd0f8..23db846629 100644 --- a/lib/Net/Config.pm +++ b/lib/Net/Config.pm @@ -169,7 +169,7 @@ Your internet domain name =item ftp_firewall -If you have an FTP proxy firewall (B<NOT> a HTTP or SOCKS firewall) +If you have an FTP proxy firewall (B<NOT> an HTTP or SOCKS firewall) then this value should be set to the firewall hostname. If your firewall does not listen to port 21, then this value should be set to C<"hostname:port"> (eg C<"hostname:99">) diff --git a/lib/Net/FTP.pm b/lib/Net/FTP.pm index 531ff405bb..ffa21e16af 100644 --- a/lib/Net/FTP.pm +++ b/lib/Net/FTP.pm @@ -1247,17 +1247,17 @@ this if you really know what you're doing). =item new (HOST [,OPTIONS]) This is the constructor for a new Net::FTP object. C<HOST> is the -name of the remote host to which a FTP connection is required. +name of the remote host to which an FTP connection is required. C<OPTIONS> are passed in a hash like fashion, using key and value pairs. Possible options are: -B<Firewall> - The name of a machine which acts as a FTP firewall. This can be +B<Firewall> - The name of a machine which acts as an FTP firewall. This can be overridden by an environment variable C<FTP_FIREWALL>. If specified, and the given host cannot be directly connected to, then the connection is made to the firewall machine and the string C<@hostname> is appended to the login identifier. This kind of setup is also refered to -as a ftp proxy. +as an ftp proxy. B<FirewallType> - The type of firewall running on the machine indicated by B<Firewall>. This can be overridden by an environment variable @@ -1394,7 +1394,7 @@ a scalar context, returns a reference to a list. =item get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ) Get C<REMOTE_FILE> from the server and store locally. C<LOCAL_FILE> may be -a filename or a filehandle. If not specified the the file will be stored in +a filename or a filehandle. If not specified, the file will be stored in the current directory with the same leafname as the remote file. If C<WHERE> is given then the first C<WHERE> bytes of the file will @@ -1476,7 +1476,7 @@ reference to a C<Net::FTP::dataconn> based object. =item nlst ( [ DIR ] ) -Send a C<NLST> command to the server, with an optional parameter. +Send an C<NLST> command to the server, with an optional parameter. =item list ( [ DIR ] ) @@ -1517,7 +1517,7 @@ C<put_unique> and those that do not require data connections. =item port ( [ PORT ] ) Send a C<PORT> command to the server. If C<PORT> is specified then it is sent -to the server. If not the a listen socket is created and the correct information +to the server. If not, the a listen socket is created and the correct information sent to the server. =item pasv () @@ -1593,7 +1593,7 @@ be performed using these. Read C<SIZE> bytes of data from the server and place it into C<BUFFER>, also performing any <CRLF> translation necessary. C<TIMEOUT> is optional, if not -given the the timeout value from the command connection will be used. +given, the timeout value from the command connection will be used. Returns the number of bytes read before any <CRLF> translation. @@ -1601,7 +1601,7 @@ Returns the number of bytes read before any <CRLF> translation. Write C<SIZE> bytes of data from C<BUFFER> to the server, also performing any <CRLF> translation necessary. C<TIMEOUT> is optional, if not -given the the timeout value from the command connection will be used. +given, the timeout value from the command connection will be used. Returns the number of bytes written before any <CRLF> translation. diff --git a/lib/Net/NNTP.pm b/lib/Net/NNTP.pm index 56c97b3caf..53df6e01ea 100644 --- a/lib/Net/NNTP.pm +++ b/lib/Net/NNTP.pm @@ -1016,7 +1016,7 @@ the beginning of the test string just inside the open square bracket. The final operation uses the backslash character to -invalidate the special meaning of the a open square bracket C<[>, +invalidate the special meaning of an open square bracket C<[>, the asterisk, backslash or the question mark. Two backslashes in sequence will result in the evaluation of the backslash as a character with no special meaning. diff --git a/lib/Net/POP3.pm b/lib/Net/POP3.pm index fb919164ad..f23157ccca 100644 --- a/lib/Net/POP3.pm +++ b/lib/Net/POP3.pm @@ -417,7 +417,7 @@ Send the PASS command. Returns the number of messages in the mailbox. =item login ( [ USER [, PASS ]] ) -Send both the the USER and PASS commands. If C<PASS> is not given the +Send both the USER and PASS commands. If C<PASS> is not given the C<Net::POP3> uses C<Net::Netrc> to lookup the password using the host and username. If the username is not specified then the current user name will be used. diff --git a/lib/Net/README.libnet b/lib/Net/README.libnet index 59001acff1..fd115a21ba 100644 --- a/lib/Net/README.libnet +++ b/lib/Net/README.libnet @@ -55,7 +55,7 @@ CONFIGURE Normally when perl Makefile.PL is run it will run Configure which will ask some questions about your system. The results of these questions -will be stored in in a file called libnet.cfg which will be installed +will be stored in a file called libnet.cfg which will be installed alongside the other perl modules in this distribution. The Makefile.PL will run Configure in an interactive mode unless these exists a file called libnet.cfg in the build directory. diff --git a/lib/Net/SMTP.pm b/lib/Net/SMTP.pm index f2647b7ed8..ce5777db07 100644 --- a/lib/Net/SMTP.pm +++ b/lib/Net/SMTP.pm @@ -444,7 +444,7 @@ known as mailhost: =item new Net::SMTP [ HOST, ] [ OPTIONS ] This is the constructor for a new Net::SMTP object. C<HOST> is the -name of the remote host to which a SMTP connection is required. +name of the remote host to which an SMTP connection is required. If C<HOST> is not given, then the C<SMTP_Host> specified in C<Net::Config> will be used. diff --git a/lib/Net/libnetFAQ.pod b/lib/Net/libnetFAQ.pod index 4e2152aa76..1216ff7202 100644 --- a/lib/Net/libnetFAQ.pod +++ b/lib/Net/libnetFAQ.pod @@ -6,8 +6,8 @@ libnetFAQ - libnet Frequently Asked Questions =head2 Where to get this document -This document is distributed with the libnet disribution, and is also -avaliable on the libnet web page at +This document is distributed with the libnet distribution, and is also +available on the libnet web page at http://www.pobox.com/~gbarr/libnet/ @@ -20,7 +20,7 @@ gbarr@pobox.com. Copyright (c) 1997-1998 Graham Barr. All rights reserved. This document is free; you can redistribute it and/or modify it -under the terms of the Artistic Licence. +under the terms of the Artistic License. =head2 Disclaimer @@ -35,7 +35,7 @@ in respect of this information or its use. =head2 What is libnet ? libnet is a collection of perl5 modules which all related to network -programming. The majority of the modules avaliable provided the +programming. The majority of the modules available provided the client side of popular server-client protocols that are used in the internet community. @@ -55,7 +55,7 @@ these modules. =head2 What machines support libnet ? -libnet itself is an entirly perl-code distribution so it should work +libnet itself is an entirely perl-code distribution so it should work on any machine that perl runs on. However IO may not work with some machines and earlier releases of perl. But this should not be the case with perl version 5.004 or later. @@ -67,14 +67,14 @@ in http://www.cpan.org/modules/by-module/Net/ -The latest release and information is also avaliable on the libnet web page +The latest release and information is also available on the libnet web page at http://www.pobox.com/~gbarr/libnet/ =head1 Using Net::FTP -=head2 How do I download files from a FTP server ? +=head2 How do I download files from an FTP server ? An example taken from an article posted to comp.lang.perl.misc @@ -135,9 +135,9 @@ But this is not guaranteed to work. =head2 Can I do a reget operation like the ftp command ? -=head2 How do I get a directory listing from a FTP server ? +=head2 How do I get a directory listing from an FTP server ? -=head2 Changeing directory to "" does not fail ? +=head2 Changing directory to "" does not fail ? Passing an argument of "" to ->cwd() has the same affect of calling ->cwd() without any arguments. Turn on Debug (I<See below>) and you will see what is @@ -155,19 +155,19 @@ gives =head2 I am behind a SOCKS firewall, but the Firewall option does not work ? The Firewall option is only for support of one type of firewall. The type -supported is a ftp proxy. +supported is an ftp proxy. To use Net::FTP, or any other module in the libnet distribution, through a SOCKS firewall you must create a socks-ified perl executable by compiling perl with the socks library. -=head2 I am behind a FTP proxy firewall, but cannot access machines outside ? +=head2 I am behind an FTP proxy firewall, but cannot access machines outside ? -Net::FTP implements the most popular ftp proxy firewall approach. The sceme -implemented is that where you loginin to the firewall with C<user@hostname> +Net::FTP implements the most popular ftp proxy firewall approach. The scheme +implemented is that where you log in to the firewall with C<user@hostname> I have heard of one other type of firewall which requires a login to the -firewall with an accont, then a second login with C<user@hostname>. You can +firewall with an account, then a second login with C<user@hostname>. You can still use Net::FTP to traverse these firewalls, but a more manual approach must be taken, eg @@ -178,7 +178,7 @@ must be taken, eg =head2 My ftp proxy firewall does not listen on port 21 FTP servers usually listen on the same port number, port 21, as any other -FTP server. But there is no reason why thi has to be the case. +FTP server. But there is no reason why this has to be the case. If you pass a port number to Net::FTP then it assumes this is the port number of the final destination. By default Net::FTP will always try @@ -201,7 +201,7 @@ chmod command via the C<SITE> command. This can be done with =head2 I have seen scripts call a method message, but cannot find it documented ? Net::FTP, like several other packages in libnet, inherits from Net::Cmd, so -all the methods described in Net::Cmd are also avaliable on Net::FTP +all the methods described in Net::Cmd are also available on Net::FTP objects. =head2 Why does Net::FTP not implement mput and mget methods @@ -241,14 +241,14 @@ of this protocol. =head2 The verify method always returns true ? -Well it may seem thay way, but it does not. The verify method returns true -if the command suceeded. If you pass verify an address which the -server would normally have to forward to another machine the the command -will suceed with something like +Well it may seem that way, but it does not. The verify method returns true +if the command succeeded. If you pass verify an address which the +server would normally have to forward to another machine, the command +will succeed with something like 252 Couldn't verify <someone@there> but will attempt delivery anyway -This command will only fail if you pass it an address in a domain the +This command will fail only if you pass it an address in a domain the server directly delivers for, and that address does not exist. =head1 Debugging scripts @@ -259,7 +259,7 @@ Most of the libnet client classes allow options to be passed to the constructor, in most cases one option is called C<Debug>. Passing this option with a non-zero value will turn on a protocol trace, which will be sent to STDERR. This trace can be useful to see what commands -are being sent to the remote server and what responces are being +are being sent to the remote server and what responses are being received back. #!/your/path/to/perl @@ -287,14 +287,14 @@ this script would output something like Net::FTP=GLOB(0x8152974)>>> QUIT Net::FTP=GLOB(0x8152974)<<< 221 Goodbye. -The first few lines tell you the modules that Net::FTP uses and thier versions, -this is usefule data to me when a user reports a bug. The last seven lines +The first few lines tell you the modules that Net::FTP uses and their versions, +this is useful data to me when a user reports a bug. The last seven lines show the communication with the server. Each line has three parts. The first part is the object itself, this is useful for separating the output -if you are using mutiple objects. The second part is either C<<<<<> to +if you are using multiple objects. The second part is either C<<<<<> to show data coming from the server or C<>>>>> to show data going to the server. The remainder of the line is the command -being sent or responce being received. +being sent or response being received. =head1 AUTHOR AND COPYRIGHT diff --git a/lib/Pod/Checker.pm b/lib/Pod/Checker.pm index b1753b95a2..60d2fefd87 100644 --- a/lib/Pod/Checker.pm +++ b/lib/Pod/Checker.pm @@ -695,7 +695,7 @@ sub idx { =item C<$checker-E<gt>hyperlink()> Add (if argument specified) and retrieve the hyperlinks (as defined by -C<LE<lt>E<gt>>) of the current POD. They consist of an 2-item array: line +C<LE<lt>E<gt>>) of the current POD. They consist of a 2-item array: line number and C<Pod::Hyperlink> object. =back diff --git a/lib/Pod/Html.pm b/lib/Pod/Html.pm index 1e9cd568e8..69953617eb 100644 --- a/lib/Pod/Html.pm +++ b/lib/Pod/Html.pm @@ -1169,7 +1169,7 @@ sub process_cut { } # -# process_pod - process a pod pod tag, thus stop ignoring pod directives +# process_pod - process a pod tag, thus stop ignoring pod directives # until we see a corresponding cut. # sub process_pod { @@ -1574,7 +1574,7 @@ sub process_text1($$;$$){ warn "$0: $podfile: cannot resolve L<$opar> in paragraph $paragraph."; } - # now we have an URL or just plain code + # now we have a URL or just plain code $$rstr = $linktext . '>' . $$rstr; if( defined( $url ) ){ $res = "<A HREF=\"$url\">" . process_text1( $lev, $rstr ) . '</A>'; @@ -1692,7 +1692,7 @@ sub dosify { } # -# page_sect - make an URL from the text of a L<> +# page_sect - make a URL from the text of a L<> # sub page_sect($$) { my( $page, $section ) = @_; diff --git a/lib/Pod/InputObjects.pm b/lib/Pod/InputObjects.pm index 352373b9da..079a40bd5b 100644 --- a/lib/Pod/InputObjects.pm +++ b/lib/Pod/InputObjects.pm @@ -447,7 +447,7 @@ C<-line> keywords indicate the filename and line number corresponding to the beginning of the interior sequence. If the C<$ptree> argument is given, it must be the last argument, and it must be either string, or else an array-ref suitable for passing to B<Pod::ParseTree::new> (or -it may be a reference to an Pod::ParseTree object). +it may be a reference to a Pod::ParseTree object). =cut diff --git a/lib/Pod/LaTeX.pm b/lib/Pod/LaTeX.pm index c909d21f35..218714d2fd 100644 --- a/lib/Pod/LaTeX.pm +++ b/lib/Pod/LaTeX.pm @@ -370,7 +370,7 @@ In its simplest form this is simply: \end{document} -but can be more complicated if a index is required. +but can be more complicated if an index is required. Can be used to set or retrieve the current value. $add = $parser->AddPostamble(); diff --git a/lib/Pod/Man.pm b/lib/Pod/Man.pm index ffb35dc4c3..ab12eeb8e2 100644 --- a/lib/Pod/Man.pm +++ b/lib/Pod/Man.pm @@ -1292,7 +1292,7 @@ output). =item release Set the centered footer. By default, this is the version of Perl you run -Pod::Man under. Note that some system an macro sets assume that the +Pod::Man under. Note that some system macro sets assume that the centered footer will be a modification date and will prepend something like "Last modified: "; if this is the case, you may want to set C<release> to the last modified date and C<date> to the version number. diff --git a/lib/Pod/Parser.pm b/lib/Pod/Parser.pm index 6782519d96..85551faca8 100644 --- a/lib/Pod/Parser.pm +++ b/lib/Pod/Parser.pm @@ -151,7 +151,7 @@ to do more sophisticated tree-based parsing. See L<"TREE-BASED PARSING">. A I<parse-option> is simply a named option of B<Pod::Parser> with a value that corresponds to a certain specified behavior. These various -behaviors of B<Pod::Parser> may be enabled/disabled by setting or +behaviors of B<Pod::Parser> may be enabled/disabled by setting or unsetting one or more I<parse-options> using the B<parseopts()> method. The set of currently accepted parse-options is as follows: @@ -647,7 +647,7 @@ their functionality. This method is useful if you need to perform your own interpolation of interior sequences and can't rely upon B<interpolate> to expand -them in simple bottom-up order order. +them in simple bottom-up order. The parameter C<$text> is a string or block of text to be parsed for interior sequences; and the parameter C<$line_num> is the @@ -1588,7 +1588,7 @@ markup languages like HTML and XML) then you may need to take the tree-based approach. Rather than doing everything in one pass and calling the B<interpolate()> method to expand sequences into text, it may be desirable to instead create a parse-tree using the B<parse_text()> -method to return a tree-like structure which may contain an ordered list +method to return a tree-like structure which may contain an ordered list of children (each of which may be a text-string, or a similar tree-like structure). diff --git a/lib/Pod/Select.pm b/lib/Pod/Select.pm index e7c820f350..8310ea6c7c 100644 --- a/lib/Pod/Select.pm +++ b/lib/Pod/Select.pm @@ -181,7 +181,7 @@ Where I<cmd-expr> is intended to match the name of one or more POD commands, and I<text-expr> is intended to match the paragraph text for the command. If a range-regex is supposed to match a POD command, then the first character of the regex (the one after the initial '/') -absolutely I<must> be an single '=' character; it may not be anything +absolutely I<must> be a single '=' character; it may not be anything else (not even a regex meta-character) if it is supposed to match against the name of a POD command. diff --git a/lib/Test/Tutorial.pod b/lib/Test/Tutorial.pod index 38f1f70c56..fa1cd2b9dd 100644 --- a/lib/Test/Tutorial.pod +++ b/lib/Test/Tutorial.pod @@ -137,7 +137,7 @@ So now you'd see... =head2 Test the manual Simplest way to build up a decent testing suite is to just test what -the manual says it does. [3] Let's pull something out of of the +the manual says it does. [3] Let's pull something out of the Date::ICal SYNOPSIS and test that all it's bits work. #!/usr/bin/perl -w diff --git a/lib/Text/Balanced.pm b/lib/Text/Balanced.pm index f50e2f58d4..b9a33cb01f 100644 --- a/lib/Text/Balanced.pm +++ b/lib/Text/Balanced.pm @@ -1194,7 +1194,7 @@ pattern C<'\s*'> - optional whitespace - is used. If the delimiter set is also not specified, the set C</["'`]/> is used. If the text to be processed is not specified either, C<$_> is used. -In list context, C<extract_delimited> returns a array of three +In list context, C<extract_delimited> returns an array of three elements, the extracted substring (I<including the surrounding delimiters>), the remainder of the text, and the skipped prefix (if any). If a suitable delimited substring is not found, the first @@ -1429,7 +1429,7 @@ C<extract_tagged> returns the complete text up to the point of failure. If the string is "PARA", C<extract_tagged> returns only the first paragraph after the tag (up to the first line that is either empty or contains only whitespace characters). -If the string is "", the the default behaviour (i.e. failure) is reinstated. +If the string is "", the default behaviour (i.e. failure) is reinstated. For example, suppose the start tag "/para" introduces a paragraph, which then continues until the next "/endpara" tag or until another "/para" tag is @@ -1628,7 +1628,7 @@ the right delimiter of the first block of the operation, =item [7] the left delimiter of the second block of the operation -(that is, if it is a C<s>, C<tr>, or C<y>), +(that is, if it is an C<s>, C<tr>, or C<y>), =item [8] @@ -1746,7 +1746,7 @@ However, the matching position of the input variable would be set to which would cause the earlier " || die;\nexit;" to be skipped in any sequence of code fragment extractions. -To avoid this problem, when it encounters a here document whilst +To avoid this problem, when it encounters a here document while extracting from a modifiable string, C<extract_quotelike> silently rearranges the string to an equivalent piece of Perl: @@ -1786,7 +1786,7 @@ Omitting the third argument (prefix argument) implies optional whitespace at the Omitting the fourth argument (outermost delimiter brackets) indicates that the value of the second argument is to be used for the outermost delimiters. -Once the prefix an dthe outermost opening delimiter bracket have been +Once the prefix an the outermost opening delimiter bracket have been recognized, code blocks are extracted by stepping through the input text and trying the following alternatives in sequence: @@ -1873,7 +1873,7 @@ extracted substring removed from it. In all contexts C<extract_multiple> starts at the current C<pos> of the string, and sets that C<pos> appropriately after it matches. -Hence, the aim of of a call to C<extract_multiple> in a list context +Hence, the aim of a call to C<extract_multiple> in a list context is to split the processed string into as many non-overlapping fields as possible, by repeatedly applying each of the specified extractors to the remainder of the string. Thus C<extract_multiple> is @@ -1905,7 +1905,7 @@ is used. =item 3. -An number specifying the maximum number of fields to return. If this +A number specifying the maximum number of fields to return. If this argument is omitted (or C<undef>), split continues as long as possible. If the third argument is I<N>, then extraction continues until I<N> fields @@ -1956,7 +1956,7 @@ If none of the extractor subroutines succeeds, then one character is extracted from the start of the text and the extraction subroutines reapplied. Characters which are thus removed are accumulated and eventually become the next field (unless the fourth argument is true, in which -case they are disgarded). +case they are discarded). For example, the following extracts substrings that are valid Perl variables: diff --git a/lib/Unicode/UCD.pm b/lib/Unicode/UCD.pm index 0aaccd0c23..ff9cc8fc05 100644 --- a/lib/Unicode/UCD.pm +++ b/lib/Unicode/UCD.pm @@ -112,7 +112,7 @@ as defined by the Unicode standard: If no match is found, a reference to an empty hash is returned. -The C<block> property is the same as as returned by charinfo(). It is +The C<block> property is the same as returned by charinfo(). It is not defined in the Unicode Character Database proper (Chapter 4 of the Unicode 3.0 Standard, aka TUS3) but instead in an auxiliary database (Chapter 14 of TUS3). Similarly for the C<script> property. diff --git a/lib/bigint.pl b/lib/bigint.pl index 9a3d50d365..bd1d91f822 100644 --- a/lib/bigint.pl +++ b/lib/bigint.pl @@ -20,7 +20,7 @@ package bigint; # '+0' canonical zero value # ' -123 123 123' canonical value '-123123123' # '1 23 456 7890' canonical value '+1234567890' -# Output values always always in canonical form +# Output values always in canonical form # # Actual math is done in an internal format consisting of an array # whose first element is the sign (/^[+-]$/) and whose remaining diff --git a/lib/ftp.pl b/lib/ftp.pl index 3f0af1a8d7..0b9d7321d6 100644 --- a/lib/ftp.pl +++ b/lib/ftp.pl @@ -330,7 +330,7 @@ sub ftp'cwd # &ftp'dir( remote LIST options ) # Start a list goin with the given options. # Presuming that the remote deamon uses the ls command to generate the -# data to send back then then you can send it some extra options (eg: -lRa) +# data to send back then you can send it some extra options (eg: -lRa) # return 1 if sucessful and 0 on a failure sub ftp'dir_open { diff --git a/lib/overload.pm b/lib/overload.pm index 21a4b671ff..838c91fcee 100644 --- a/lib/overload.pm +++ b/lib/overload.pm @@ -298,7 +298,7 @@ if C<+=> is not overloaded. =back -B<Warning.> Due to the presense of assignment versions of operations, +B<Warning.> Due to the presence of assignment versions of operations, routines which may be called in assignment context may create self-referential structures. Currently Perl will not free self-referential structures until cycles are C<explicitly> broken. You may get problems @@ -852,7 +852,7 @@ C<$a = $b> values of $a and $b become I<indistinguishable>. On the other hand, anyone who has used algebraic notation knows the expressive power of the arithmetic metaphor. Overloading works hard to enable this metaphor while preserving the Perlian way as far as -possible. Since it is not not possible to freely mix two contradicting +possible. Since it is not possible to freely mix two contradicting metaphors, overloading allows the arithmetic way to write things I<as far as all the mutators are called via overloaded access only>. The way it is done is described in L<Copy Constructor>. @@ -969,7 +969,7 @@ TIEHASH() method is a scalar reference. Second, we create a new tied hash each time the hash syntax is used. This allows us not to worry about a possibility of a reference loop, -would would lead to a memory leak. +which would lead to a memory leak. Both these problems can be cured. Say, if we want to overload hash dereference on a reference to an object which is I<implemented> as a @@ -1135,7 +1135,7 @@ which outputs and one can inspect the value in debugger using all the possible methods. -Something is is still amiss: consider the loop variable $cnt of the +Something is still amiss: consider the loop variable $cnt of the script. It was a number, not an object. We cannot make this value of type C<symbolic>, since then the loop will not terminate. diff --git a/lib/perl5db.pl b/lib/perl5db.pl index 48ee09fe3e..5e01d53743 100644 --- a/lib/perl5db.pl +++ b/lib/perl5db.pl @@ -206,7 +206,7 @@ $header = "perl5db.pl version $VERSION"; # I<CreateTTY> bits control attempts to create a new TTY on events: # 1: on fork() 2: debugger is started inside debugger # 4: on startup -# c) Code to auto-create a new TTY window on OS/2 (currently one one +# c) Code to auto-create a new TTY window on OS/2 (currently one # extra window per session - need named pipes to have more...); # d) Simplified interface for custom createTTY functions (with a backward # compatibility hack); now returns the TTY name to use; return of '' diff --git a/lib/unicore/Unicode.html b/lib/unicore/Unicode.html index 7e6eb488af..f3484912ed 100644 --- a/lib/unicore/Unicode.html +++ b/lib/unicore/Unicode.html @@ -904,7 +904,7 @@ href="http://www.unicode.org/unicode/standard/versions/enumeratedversions.html#U <li>Corrected error in canonical decomposition for U+1FF4.</li> <li>Added compatibility decompositions to clarify collation tables. (U+2100, U+2101, U+2105, U+2106, U+1E9A)</li> - <li>A series of general category changes to assist the convergence of of + <li>A series of general category changes to assist the convergence of Unicode definition of identifier with ISO TR 10176: <ul> <li>So > Lo: U+0950, U+0AD0, U+0F00, U+0F88..U+0F8B</li> |