summaryrefslogtreecommitdiff
path: root/pod/perlhack.pod
diff options
context:
space:
mode:
authorRichard Möhn <richard.moehn@fu-berlin.de>2011-03-22 21:06:16 +0100
committerFather Chrysostomos <sprout@cpan.org>2011-03-24 14:06:19 -0700
commita8d15a22010d9a4d9ec485ed470d1bd0b961ac53 (patch)
treede0628601a1869fab87baa4c8110c72ebd2dae10 /pod/perlhack.pod
parent6f891a11b46dfd99bec1651588fb79891f455f3a (diff)
downloadperl-a8d15a22010d9a4d9ec485ed470d1bd0b961ac53.tar.gz
Fix spelling errors in pod/perlhack.pod
Diffstat (limited to 'pod/perlhack.pod')
-rw-r--r--pod/perlhack.pod52
1 files changed, 26 insertions, 26 deletions
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index dbcf6991c6..119554750a 100644
--- a/pod/perlhack.pod
+++ b/pod/perlhack.pod
@@ -75,12 +75,12 @@ Thank you!
=head1 BUG REPORTING
-If you want to report a bug in Perl you must use the F<perlbug> command
+If you want to report a bug in Perl, you must use the F<perlbug> command
line tool. This tool will ensure that your bug report includes all the
relevant system and configuration information.
To browse existing Perl bugs and patches, you can use the web interface
-at L<http://rt.perl.org>.
+at L<http://rt.perl.org/>.
Please check the archive of the perl5-porters list (see below) and/or
the bug tracking system before submitting a bug report. Often, you'll
@@ -139,7 +139,7 @@ You may access the repository over the web. This allows you to browse
the tree, see recent commits, subscribe to RSS feeds for the changes,
search for particular commits and more. You may access it at
L<http://perl5.git.perl.org/perl.git>. A mirror of the repository is
-found at L<http://github.com/mirrors/perl>
+found at L<http://github.com/mirrors/perl>.
=head2 Read access via rsync
@@ -153,7 +153,7 @@ tree for the bleadperl branch and all maintenance branches:
$ rsync -avz rsync://perl5.git.perl.org/perl-5.6.x .
$ rsync -avz rsync://perl5.git.perl.org/perl-5.005xx .
-(Add the C<--delete> option to remove leftover files)
+(Add the C<--delete> option to remove leftover files.)
To get a full list of the available sync points:
@@ -244,9 +244,9 @@ if your submission will consist of a series of commits.
The first line of the commit message should be a short description
without a period. It should be no longer than the subject line of an
-E-Mail, 50 characters being a good rule of thumb.
+email, 50 characters being a good rule of thumb.
-A lot of Git tools (Gitweb, GitHub, git log --pretty=oneline, ..) will
+A lot of Git tools (Gitweb, GitHub, git log --pretty=oneline, ...) will
only display the first line (cut off at 50 characters) when presenting
commit summaries.
@@ -377,7 +377,7 @@ extra paren, e.g. "if (a && (b = c)) ..."
=head3 Test suite
-If your patch changes code (rather than just changing documentation)
+If your patch changes code (rather than just changing documentation),
you should also include one or more test cases which illustrate the bug
you're fixing or validate the new functionality you're adding. In
general, you should update an existing test file rather than create a
@@ -468,7 +468,7 @@ Some core modules also live on CPAN and are maintained outside of the
Perl core. When the author updates the module, the updates are simply
copied into the core.
-Module in the F<cpan/> directory of the source tree are maintained
+Modules in the F<cpan/> directory of the source tree are maintained
outside of the Perl core. See that module's listing on documentation or
its listing on L<http://search.cpan.org/> for more information on
reporting bugs and submitting patches.
@@ -624,7 +624,7 @@ without further notice.
=head3 Is the implementation generic enough to be portable?
-The worst patches make use of a system-specific features. It's highly
+The worst patches make use of system-specific features. It's highly
unlikely that non-portable additions to the Perl language will be
accepted.
@@ -694,12 +694,12 @@ Since we don't know if require works, or even subroutines, use ad hoc
tests for these two. Step carefully to avoid using the feature being
tested.
-=item * F<t/cmd>, F<t/run> F<t/io>, and F<t/op>
+=item * F<t/cmd>, F<t/run>, F<t/io> and F<t/op>
Now that basic require() and subroutines are tested, you can use the
F<t/test.pl> library.
-You can also use certain libraries like Config conditionally , but be
+You can also use certain libraries like Config conditionally, but be
sure to skip the test gracefully if it's not there.
=item * Everything else
@@ -709,8 +709,8 @@ used. You can also use the full suite of core modules in the tests.
=back
-When you say "make test" Perl uses the F<t/TEST> program to run the
-test suite (except under Win32 where it uses F<t/harness> instead.) All
+When you say "make test", Perl uses the F<t/TEST> program to run the
+test suite (except under Win32 where it uses F<t/harness> instead). All
tests are run from the F<t/> directory, B<not> the directory which
contains the test. This causes some problems with the tests in F<lib/>,
so here's some opportunity for some patching.
@@ -766,7 +766,7 @@ F<testname.valgrind>.
=item * test.torture torturetest
-Run all the usual tests and some extra tests. As of Perl 5.8.0 the only
+Run all the usual tests and some extra tests. As of Perl 5.8.0, the only
extra tests are Abigail's JAPHs, F<t/japh/abigail.t>.
You can also run the torture test with F<t/harness> by giving
@@ -824,7 +824,7 @@ non-conflicting test scripts itself, and there is no standard interface
to C<make> utilities to interact with their job schedulers.
Note that currently some test scripts may fail when run in parallel (most
-notably C<ext/IO/t/io_dir.t>). If necessary run just the failing scripts
+notably C<ext/IO/t/io_dir.t>). If necessary, run just the failing scripts
again sequentially and see if the failures go away.
=item * test-notty test_notty
@@ -832,8 +832,8 @@ Sets PERL_SKIP_TTY_TEST to true before running normal test.
=head2 Running tests by hand
-You can run part of the test suite by hand by using one the following
-commands from the F<t/> directory :
+You can run part of the test suite by hand by using one of the following
+commands from the F<t/> directory:
./perl -I../lib TEST list-of-.t-files
@@ -841,18 +841,18 @@ or
./perl -I../lib harness list-of-.t-files
-(if you don't specify test scripts, the whole test suite will be run.)
+(If you don't specify test scripts, the whole test suite will be run.)
=head2 Using F<t/harness> for testing
-If you use C<harness> for testing you have several command line options
+If you use C<harness> for testing, you have several command line options
available to you. The arguments are as follows, and are in the order
that they must appear if used together.
harness -v -torture -re=pattern LIST OF FILES TO TEST
harness -v -torture -re LIST OF PATTERNS TO MATCH
-If C<LIST OF FILES TO TEST> is omitted the file list is obtained from
+If C<LIST OF FILES TO TEST> is omitted, the file list is obtained from
the manifest. The file list may include shell wildcards which will be
expanded out.
@@ -884,7 +884,7 @@ are obtained from the MANIFEST.
You can run an individual test by a command similar to
- ./perl -I../lib patho/to/foo.t
+ ./perl -I../lib path/to/foo.t
except that the harnesses set up some environment variables that may
affect the execution of the test:
@@ -893,13 +893,13 @@ affect the execution of the test:
=item * PERL_CORE=1
-indicates that we're running this test part of the perl core test
+indicates that we're running this test as part of the perl core test
suite. This is useful for modules that have a dual life on CPAN.
=item * PERL_DESTRUCT_LEVEL=2
is set to 2 if it isn't set already (see
-L<perlhacktips/PERL_DESTRUCT_LEVEL>)
+L<perlhacktips/PERL_DESTRUCT_LEVEL>).
=item * PERL
@@ -1014,14 +1014,14 @@ Perl development in general works.
The CPAN testers ( http://testers.cpan.org/ ) are a group of volunteers
who test CPAN modules on a variety of platforms.
-Perl Smokers (http://www.nntp.perl.org/group/perl.daily-build and
+Perl Smokers ( http://www.nntp.perl.org/group/perl.daily-build/ and
http://www.nntp.perl.org/group/perl.daily-build.reports/ )
automatically test Perl source releases on platforms with various
configurations.
Both efforts welcome volunteers. In order to get involved in smoke
testing of the perl itself visit
-L<http://search.cpan.org/dist/Test-Smoke>. In order to start smoke
+L<http://search.cpan.org/dist/Test-Smoke/>. In order to start smoke
testing CPAN modules visit
L<http://search.cpan.org/dist/CPANPLUS-YACSmoke/> or
L<http://search.cpan.org/dist/minismokebox/> or
@@ -1077,7 +1077,7 @@ with a few others here and there) begin with an epigramic inscription
that alludes, indirectly and metaphorically, to the material you're
about to read.
-Quotations are taken from writings of J.R.R Tolkien pertaining to his
+Quotations are taken from writings of J.R.R. Tolkien pertaining to his
Legendarium, almost always from I<The Lord of the Rings>. Chapters and
page numbers are given using the following editions: