Change 24686 by rgs@bloom on 2005/06/03 08:04:25
Subject: [PATCH] Quotes in pod/*.pod
From: Andy Lester <andy (AT) petdance (DOT) com>
Date: Thu, 2 Jun 2005 16:19:54 -0500
Message-ID: <20050602211954.GA22107 (AT) petdance (DOT) com>
Affected files
//depot/perl/Porting/pumpkin.pod#59 edit
//depot/perl/README.cygwin#36 edit
//depot/perl/README.hurd#6 edit
//depot/perl/README.mint#8 edit
//depot/perl/README.os390#24 edit
//depot/perl/README.vmesa#11 edit
//depot/perl/pod/perlfaq.pod#36 edit
//depot/perl/pod/perlfaq3.pod#85 edit
//depot/perl/pod/perlfaq4.pod#97 edit
//depot/perl/pod/perlfaq6.pod#49 edit
//depot/perl/pod/perlfaq7.pod#46 edit
//depot/perl/pod/perlfaq8.pod#45 edit
//depot/perl/pod/perlfaq9.pod#46 edit
//depot/perl/pod/perlgpl.pod#6 edit
//depot/perl/pod/perlhack.pod#86 edit
//depot/perl/pod/perlipc.pod#59 edit
//depot/perl/pod/perllocale.pod#38 edit
//depot/perl/pod/perlport.pod#152 edit
//depot/perl/pod/perlre.pod#90 edit
//depot/perl/pod/perlref.pod#27 edit
//depot/perl/pod/perlthrtut.pod#31 edit
Differences
//depot/perl/Porting/pumpkin.pod#59 (text)
Index: perl/Porting/pumpkin.pod
perl/Porting/pumpkin.pod#58~24508~Fri May 20 00:53:46 2005
perl/Porting/pumpkin.podFri Jun 3 01:04:25 2005
@@ -791,7 +791,7 @@
within eval or require. (Fixing these is non-trivial, unfortunately, but
they must be fixed eventually.)
-=head1 Common Gotcha's
+=head1 Common Gotchas
=over 4
//depot/perl/README.cygwin#36 (text)
Index: perl/README.cygwin
perl/README.cygwin#35~23962~Sat Feb 12 08:14:56 2005
perl/README.cygwinFri Jun 3 01:04:25 2005
@@ -64,8 +64,8 @@
WinNT with either the I<nteaor I<ntsecC<CYGWINsettings, directory
and file permissions may not be set correctly. Since the build process
-creates directories and files, to be safe you may want to run a `C<chmod
+w *>' on the entire Perl source tree.
+creates directories and files, to be safe you may want to run a
+C<chmod -R +w *on the entire Perl source tree.
Also, it is a well known WinNT "feature" that files created by a login
that is a member of the I<Administratorsgroup will be owned by the
@@ -231,7 +231,7 @@
=item * I<dlsym()>
I<ld2is needed to build dynamic libraries, but it does not exist
-when C<dlsym()checking occurs (it is not created until `C<make>' runs).
+when C<dlsym()checking occurs (it is not created until C<makeruns).
You will see the following message:
Checking whether your C<dlsym()needs a leading underscore
@@ -287,13 +287,13 @@
=head2 ld2 on Cygwin
-During `C<make>', I<ld2will be created and installed in your $installbin
+During C<make>, I<ld2will be created and installed in your $installbin
directory (where you said to put public executables). It does not
-wait until the `C<make install>' process to install the I<ld2script,
-this is because the remainder of the `C<make>' refers to I<ld2without
+wait until the C<make installprocess to install the I<ld2script,
+this is because the remainder of the C<makerefers to I<ld2without
fully specifying its path and does this from multiple subdirectories.
The assumption is that $installbin is in your current C<PATH>. If this
-is not the case `C<make>' will fail at some point. If this happens,
+is not the case C<makewill fail at some point. If this happens,
just manually copy I<ld2from the source directory to somewhere in
your C<PATH>.
@@ -306,7 +306,7 @@
cd t;./perl harness 2>&1 | tee /log.harness
The same tests are run both times, but more information is provided when
-running as `C<./perl harness>'.
+running as C<./perl harness>.
Test results vary depending on your host system and your Cygwin
configuration. If a test can pass in some Cygwin setup, it is always
@@ -506,10 +506,10 @@
make install 2>&1 | tee log.make-install
-NTE: If C<STDERRis redirected `C<make install>' will B<notprompt
+NTE: If C<STDERRis redirected C<make installwill B<notprompt
you to install I<perlinto F</usr/bin>.
-You may need to be I<Administratorto run `C<make install>'. If you
+You may need to be I<Administratorto run C<make install>. If you
are not, you must have write access to the directories in question.
Information on installing the Perl documentation in HTML format can be
//depot/perl/README.hurd#6 (text)
Index: perl/README.hurd
perl/README.hurd#5~15543~Tue Mar 26 19:11:55 2002
perl/README.hurdFri Jun 3 01:04:25 2005
@@ -10,19 +10,19 @@
If you want to use Perl on the Hurd, I recommend using the Debian
GNU/Hurd distribution ( see http://www.debian.org/ ), even if an
-official, stable release has not yet been made. The old `gnu-0.2'
+official, stable release has not yet been made. The old "gnu-0.2"
binary distribution will most certainly have additional problems.
=head2 Known Problems with Perl on Hurd
The Perl test suite may still report some errors on the Hurd. The
-`lib/anydbm' and `pragma/warnings' tests will almost certainly fail.
+"lib/anydbm" and "pragma/warnings" tests will almost certainly fail.
Both failures are not really specific to the Hurd, as indicated by the
test suite output.
The socket tests may fail if the network is not configured. You have
-to make `/hurd/pfinet' the translator for `/servers/socket/2', giving
-it the right arguments. Try `/hurd/pfinet ' for more
+to make "/hurd/pfinet" the translator for "/servers/socket/2", giving
+it the right arguments. Try "/hurd/pfinet " for more
information.
Here are the statistics for Perl 5.005_62 on my system:
@@ -39,8 +39,8 @@
However, since I am running a very recent Hurd snapshot, in which a lot of
bugs that were exposed by the Perl test suite have been fixed, you may
-encounter more failures. Likely candidates are: `op/stat', `lib/io_pipe',
-`lib/io_sock', `lib/io_udp' and `lib/time'.
+encounter more failures. Likely candidates are: "op/stat", "lib/io_pipe",
+"lib/io_sock", "lib/io_udp" and "lib/time".
In any way, if you're seeing failures beyond those mentioned in this
document, please consider upgrading to the latest Hurd before reporting
//depot/perl/README.mint#8 (text)
Index: perl/README.mint
perl/README.mint#7~18513~Sat Jan 18 10:07:01 2003
perl/README.mintFri Jun 3 01:04:25 2005
@@ -78,7 +78,7 @@
memory for cc1, 3 would reserve three fourths. You will have
to find out the value that suits to your system yourself.
-To find out the location of the program `cc1' simply type
+To find out the location of the program "cc1" simply type
`gcc cc1' at your shell prompt.
Now run make (maybe "make -k"). If you get a fatal signal 10
//depot/perl/README.os390#24 (text)
Index: perl/README.os390
perl/README.os390#23~15773~Sat Apr 6 11:25:47 2002
perl/README.os390Fri Jun 3 01:04:25 2005
@@ -90,7 +90,7 @@
_C89_CCMDE=1 is also a good idea for users of GNU make).
You might also want to have GNU groff for S/390 installed before
-running the `make install` step for Perl.
+running the "make install" step for Perl.
There is a syntax error in the /usr/include/sys/socket.h header file
that IBM supplies with USS V2R7, V2R8, and possibly V2R9. The problem with
@@ -220,9 +220,9 @@
=head2 Testing Anomalies with Perl on S/390
-The `make test` step runs a Perl Verification Procedure, usually before
+The "make test" step runs a Perl Verification Procedure, usually before
installation. You might encounter STDERR messages even during a successful
-run of `make test`. Here is a guide to some of the more commonly seen
+run of "make test". Here is a guide to some of the more commonly seen
anomalies:
=over 4
//depot/perl/README.vmesa#11 (text)
Index: perl/README.vmesa
perl/README.vmesa#10~17824~Tue Sep 3 13:02:36 2002
perl/README.vmesaFri Jun 3 01:04:25 2005
@@ -21,7 +21,7 @@
If you've downloaded the binary distribution, it needs to be
installed below /usr/local. Source code distributions have an
-automated `make install` step that means you do not need to extract
+automated "make install" step that means you do not need to extract
the source code below /usr/local (though that is where it will be
installed by default). You may need to worry about the networking
configuration files discussed in the last bullet below.
@@ -81,10 +81,10 @@
=head2 Testing Anomalies of Perl on VM/ESA
-The `make test` step runs a Perl Verification Procedure, usually before
+The "make test" step runs a Perl Verification Procedure, usually before
installation. As the 5.6.1 kit was being assembled
the following "failures" were known to appear on some machines
-during `make test` (mostly due to ASCII vs. EBCDIC conflicts),
+during "make test" (mostly due to ASCII vs. EBCDIC conflicts),
your results may differ:
[the list of failures being compiled]
//depot/perl/pod/perlfaq.pod#36 (text)
Index: perl/pod/perlfaq.pod
perl/pod/perlfaq.pod#35~24128~Thu Mar 31 23:19:27 2005
perl/pod/perlfaq.podFri Jun 3 01:04:25 2005
@@ -45,7 +45,7 @@
=head1 Author and Copyright Information
-Copyright (c) 1997-2003 Tom Christiansen, Nathan Torkington, and
+Copyright (c) 1997-2005 Tom Christiansen, Nathan Torkington, and
other contributors noted in the answers.
All rights reserved.
@@ -398,7 +398,7 @@
=item *
-Why is int() broken?
+Why is C<int()broken?
=item *
@@ -406,7 +406,7 @@
=item *
-Does Perl have a round() function? What about ceil() and floor()? Trig functions?
+Does Perl have a C<round()function? What about C<ceil()and C<floor()>? Trig functions?
=item *
@@ -550,7 +550,7 @@
=item *
-What is the difference between $array[1] and @array[1]?
+What is the difference between C<$array[1]and C<@array[1]>?
=item *
@@ -606,7 +606,7 @@
=item *
-Why does defined() return true on empty arrays and hashes?
+Why does C<defined()return true on empty arrays and hashes?
=item *
@@ -642,7 +642,7 @@
=item *
-How do I reset an each() operation part-way through?
+How do I reset an C<each()operation part-way through?
=item *
@@ -743,11 +743,11 @@
=item *
-How can I set up a footer format to be used with write()?
+How can I set up a footer format to be used with C<write()>?
=item *
-How can I write() into a string?
+How can I C<write()into a string?
=item *
@@ -767,7 +767,7 @@
=item *
-Is there a leak/bug in glob()?
+Is there a leak/bug in C<glob()>?
=item *
@@ -783,7 +783,7 @@
=item *
-Why can't I just open(FH, "E<gt>file.lock")?
+Why can't I just C<< open(FH, ">file.lock") >>?
=item *
@@ -831,7 +831,7 @@
=item *
-How do I dup() a filehandle in Perl?
+How do I C<dup()a filehandle in Perl?
=item *
@@ -843,7 +843,7 @@
=item *
-Why doesn't glob("") get all the files?
+Why doesn't C<glob("")get all the files?
=item *
@@ -862,7 +862,13 @@
=head2 L<perlfaq6>: Regular Expressions
-This section is surprisingly small because the rest of the FAQ is littered with answers involving regular expressions. For example, decoding a URL and checking whether something is a number are handled with regular expressions, but those answers are found elsewhere in this document (in L<perlfaq9>: ``How do I decode or create those %-encodings on the web'' and L<perlfaq4>: ``How do I determine whether a scalar is a number/whole/integer/float'', to be precise).
+This section is surprisingly small because the rest of the FAQ is
+littered with answers involving regular expressions. For example,
+decoding a URL and checking whether something is a number are handled
+with regular expressions, but those answers are found elsewhere in this
+document (in L<perlfaq9>: "How do I decode or create those %-encodings
+on the web" and L<perlfaq4>: "How do I determine whether a scalar is
+a number/whole/integer/float", to be precise).
=over 4
@@ -880,7 +886,7 @@
=item *
-I put a regular expression into $/ but it didn't work. What's wrong?
+I put a regular expression into C<$/but it didn't work. What's wrong?
=item *
@@ -936,7 +942,7 @@
=item *
-Why does using $&, $`, or $' slow my program down?
+Why does using C<$&>, C<$`>, or C<$'slow my program down?
=item *
@@ -1041,7 +1047,7 @@
=item *
-Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
+Why doesn't C<< my($foo) = <FILE>; >work right?
=item *
@@ -1049,7 +1055,7 @@
=item *
-What's the difference between calling a function as &foo and foo()?
+What's the difference between calling a function as C<&fooand C<foo()>?
=item *
@@ -1098,7 +1104,7 @@
=item *
-How come exec() doesn't return?
+How come C<exec()doesn't return?
=item *
@@ -1154,7 +1160,7 @@
=item *
-How can I sleep() or alarm() for under a second?
+How can I C<sleep()or C<alarm()for under a second?
=item *
@@ -1162,7 +1168,7 @@
=item *
-How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
+How can I do an C<atexit()or C<setjmp()>/C<longjmp()>? (Exception handling)
=item *
@@ -1174,7 +1180,7 @@
=item *
-Where do I get the include files to do ioctl() or syscall()?
+Where do I get the include files to do C<ioctl()or C<syscall()>?
=item *
@@ -1186,7 +1192,7 @@
=item *
-Why can't I get the output of a command with system()?
+Why can't I get the output of a command with C<system()>?
=item *
@@ -1194,7 +1200,7 @@
=item *
-Why doesn't open() return an error when a pipe open fails?
+Why doesn't C<open()return an error when a pipe open fails?
=item *
@@ -1226,7 +1232,9 @@
=item *
-I {changed directory, modified my environment} in a perl script. How come the change disappeared when I exited the script? How do I get my changes to be visible?
+I {changed directory, modified my environment} in a perl script. How come
+the change disappeared when I exited the script? How do I get my changes
+to be visible?
=item *
@@ -1258,7 +1266,7 @@
=item *
-How do I make a system() exit on control-C?
+How do I make a C<system()exit on control-C?
=item *
@@ -1286,11 +1294,11 @@
=item *
-How do I add a directory to my include path (@INC) at runtime?
+How do I add a directory to my include path (C<@INC>) at runtime?
=item *
-What is socket.ph and where do I get it?
+What is F<socket.phand where do I get it?
=back
@@ -1351,7 +1359,7 @@
=item *
-How do I edit my .htpasswd and .htgroup files with Perl?
+How do I edit my F<.htpasswdand F<.htgroupfiles with Perl?
=item *
//depot/perl/pod/perlfaq3.pod#85 (text)
Index: perl/pod/perlfaq3.pod
perl/pod/perlfaq3.pod#84~24684~Fri Jun 3 00:58:10 2005
perl/pod/perlfaq3.podFri Jun 3 01:04:25 2005
@@ -31,7 +31,7 @@
=head2 How can I use Perl interactively?
The typical approach uses the Perl debugger, described in the
-perldebug(1) manpage, on an ``empty'' program, like this:
+perldebug(1) manpage, on an "empty" program, like this:
perl -de 42
@@ -481,8 +481,8 @@
and profile to make sure you're optimizing the right part, look for
better algorithms instead of microtuning your code, and when all else
fails consider just buying faster hardware. You will probably want to
-read the answer to the earlier question ``How do I profile my Perl
-programs?'' if you haven't done so already.
+read the answer to the earlier question "How do I profile my Perl
+programs?" if you haven't done so already.
A different approach is to autoload seldom-used Perl code. See the
AutoSplit and AutoLoader modules in the standard distribution for
@@ -696,19 +696,10 @@
See .
-A non-free, commercial product, ``The Velocity Engine for Perl'',
-(http://www.binevolve.com/ or )
-might also be worth looking at. It will allow you to increase the
-performance of your Perl programs, running programs up to 25 times
-faster than normal CGI Perl when running in persistent Perl mode or 4
-to 5 times faster without any modification to your existing CGI
-programs. Fully functional evaluation copies are available from the
-web site.
-
=head2 How can I hide the source for my Perl program?
Delete it. :-) Seriously, there are a number of (mostly
-unsatisfactory) solutions with varying levels of ``security''.
+unsatisfactory) solutions with varying levels of "security".
First of all, however, you I<can'ttake away read permission, because
the source code has to be readable in order to be compiled and
@@ -743,9 +734,9 @@
If you're concerned about people profiting from your code, then the
bottom line is that nothing but a restrictive license will give you
legal security. License your software and pepper it with threatening
-statements like ``This is unpublished proprietary software of XYZ Corp.
+statements like "This is unpublished proprietary software of XYZ Corp.
Your access to it does not give you permission to use it blah blah
-blah.'' We are not lawyers, of course, so you should see a lawyer if
+blah." We are not lawyers, of course, so you should see a lawyer if
you want to be sure your license's wording will stand up in court.
=head2 How can I compile my Perl program into byte code or C?
@@ -802,7 +793,7 @@
extproc perl -S -your_switches
as the first line in C<*.cmdfile (C<-Sdue to a bug in cmd.exe's
-`extproc' handling). For DS one should first invent a corresponding
+"extproc" handling). For DS one should first invent a corresponding
batch file and codify it in C<ALTERNATE_SHEBANG(see the
F<dosish.hfile in the source distribution for more information).
@@ -900,9 +891,9 @@
For modules, get the CGI or LWP modules from CPAN. For textbooks,
see the two especially dedicated to web stuff in the question on
-books. For problems and questions related to the web, like ``Why
-do I get 500 Errors'' or ``Why doesn't it run from the browser right
-when it runs fine on the command line'', see the troubleshooting
+books. For problems and questions related to the web, like "Why
+do I get 500 Errors" or "Why doesn't it run from the browser right
+when it runs fine on the command line", see the troubleshooting
guides and references in L<perlfaq9or in the CGI MetaFAQ:
//depot/perl/pod/perlfaq4.pod#97 (text)
Index: perl/pod/perlfaq4.pod
perl/pod/perlfaq4.pod#96~24684~Fri Jun 3 00:58:10 2005
perl/pod/perlfaq4.podFri Jun 3 01:04:25 2005
@@ -349,16 +349,16 @@
(despite appearances caused by bugs in your programs :-). see the
F<randomarticle in the "Far More Than You Ever Wanted To Know"
collection in , courtesy of
-Tom Phoenix, talks more about this. John von Neumann said, ``Anyone
+Tom Phoenix, talks more about this. John von Neumann said, "Anyone
who attempts to generate random numbers by deterministic means is, of
-course, living in a state of sin.''
+course, living in a state of sin."
If you want numbers that are more random than C<randwith C<srand>
provides, you should also check out the Math::TrulyRandom module from
CPAN. It uses the imperfections in your system's timer to generate
random numbers, but this takes quite a while. If you want a better
pseudorandom generator than comes with your operating system, look at
-``Numerical Recipes in C'' at http://www.nr.com/ .
+"Numerical Recipes in C" at http://www.nr.com/ .
=head2 How do I get a random number between X and Y?
@@ -532,8 +532,8 @@
That doesn't mean that Perl can't be used to create non-Y2K compliant
programs. It can. But so can your pencil. It's the fault of the user,
-not the language. At the risk of inflaming the NRA: ``Perl doesn't
-break Y2K, people do.'' See for
+not the language. At the risk of inflaming the NRA: "Perl doesn't
+break Y2K, people do." See for
a longer exposition.
=head1 Data: Strings
@@ -553,7 +553,7 @@
=head2 How do I unescape a string?
-It depends just what you mean by ``escape''. URL escapes are dealt
+It depends just what you mean by "escape". URL escapes are dealt
with in L<perlfaq9>. Shell escapes with the backslash (C<\>)
character are removed with
@@ -2037,7 +2037,7 @@
wrapper function for more convenient access. This function takes
a string and returns the number it found, or C<undeffor input that
isn't a C float. The C<is_numericfunction is a front end to C<getnum>
-if you just want to say, ``Is this a float?''
+if you just want to say, "Is this a float?"
sub getnum {
use PSIX qw(strtod);
//depot/perl/pod/perlfaq6.pod#49 (text)
Index: perl/pod/perlfaq6.pod
perl/pod/perlfaq6.pod#48~24684~Fri Jun 3 00:58:10 2005
perl/pod/perlfaq6.podFri Jun 3 01:04:25 2005
@@ -8,9 +8,9 @@
littered with answers involving regular expressions. For example,
decoding a URL and checking whether something is a number are handled
with regular expressions, but those answers are found elsewhere in
-this document (in L<perlfaq9>: ``How do I decode or create those %-encodings
-on the web'' and L<perlfaq4>: ``How do I determine whether a scalar is
-a number/whole/integer/float'', to be precise).
+this document (in L<perlfaq9>: "How do I decode or create those %-encodings
+on the web" and L<perlfaq4>: "How do I determine whether a scalar is
+a number/whole/integer/float", to be precise).
=head2 How can I hope to use regular expressions without creating illegible and unmaintainable code?
@@ -509,8 +509,8 @@
print "$count $line";
}
-If you want these output in a sorted order, see L<perlfaq4>: ``How do I
-sort a hash (optionally by value instead of key)?''.
+If you want these output in a sorted order, see L<perlfaq4>: "How do I
+sort a hash (optionally by value instead of key)?".
=head2 How can I do approximate matching?
@@ -794,7 +794,7 @@
Here are a few ways, all painful, to deal with it:
- $martian =~ s/([A-Z][A-Z])/ $1 /g; # Make sure adjacent ``martian''
+ $martian =~ s/([A-Z][A-Z])/ $1 /g; # Make sure adjacent "martian"
# bytes are no longer adjacent.
print "found GX!\n" if $martian =~ /GX/;
//depot/perl/pod/perlfaq7.pod#46 (text)
Index: perl/pod/perlfaq7.pod
perl/pod/perlfaq7.pod#45~24685~Fri Jun 3 00:59:48 2005
perl/pod/perlfaq7.podFri Jun 3 01:04:25 2005
@@ -296,7 +296,7 @@
objects. See L<perlsub/"Pass by Reference"for this particular
question, and L<perlreffor information on references.
-See ``Passing Regexes'', below, for information on passing regular
+See "Passing Regexes", below, for information on passing regular
expressions.
=over 4
//depot/perl/pod/perlfaq8.pod#45 (text)
Index: perl/pod/perlfaq8.pod
perl/pod/perlfaq8.pod#44~24684~Fri Jun 3 00:58:10 2005
perl/pod/perlfaq8.podFri Jun 3 01:04:25 2005
@@ -276,8 +276,8 @@
If you expect characters to get to your device when you print() them,
you'll want to autoflush that filehandle. You can use select()
and the C<$|variable to control autoflushing (see L<perlvar/$E<verbar>>
-and L<perlfunc/select>, or L<perlfaq5>, ``How do I flush/unbuffer an
-output filehandle? Why must I do this?''):
+and L<perlfunc/select>, or L<perlfaq5>, "How do I flush/unbuffer an
+output filehandle? Why must I do this?"):
$oldh = select(DEV);
$| = 1;
@@ -411,7 +411,7 @@
generates a signal which is sent to your terminal's currently
foregrounded process group, which you then trap in your process.
Signals are documented in L<perlipc/"Signals"and the
-section on ``Signals'' in the Camel.
+section on "Signals" in the Camel.
You can set the values of the %SIG hash to be the functions you want
to handle the signal. After perl catches the signal, it looks in %SIG
@@ -527,7 +527,7 @@
Perl's exception-handling mechanism is its eval() operator. You can
use eval() as setjmp and die() as longjmp. For details of this, see
the section on signals, especially the time-out handler for a blocking
-flock() in L<perlipc/"Signals"or the section on ``Signals'' in
+flock() in L<perlipc/"Signals"or the section on "Signals" in
the Camel Book.
If exception handling is all you're interested in, try the
@@ -1017,7 +1017,7 @@
Use the alarm() function, probably in conjunction with a signal
handler, as documented in L<perlipc/"Signals"and the section on
-``Signals'' in the Camel. You may instead use the more flexible
+"Signals" in the Camel. You may instead use the more flexible
Sys::AlarmCall module available from CPAN.
The alarm() function is not implemented on all versions of Windows.
@@ -1177,8 +1177,8 @@
get a new F<perlbinary with your extension linked in.
See L<ExtUtils::MakeMakerfor more details on building extensions.
-See also the next question, ``What's the difference between require
-and use?''.
+See also the next question, "What's the difference between require
+and use?".
=head2 What's the difference between require and use?
//depot/perl/pod/perlfaq9.pod#46 (text)
Index: perl/pod/perlfaq9.pod
perl/pod/perlfaq9.pod#45~24684~Fri Jun 3 00:58:10 2005
perl/pod/perlfaq9.podFri Jun 3 01:04:25 2005
@@ -322,7 +322,7 @@
consistent interface to these files, regardless of how they're
stored. Databases may be text, dbm, Berkeley DB or any database with
a DBI compatible driver. HTTPD::UserAdmin supports files used by the
-`Basic' and `Digest' authentication schemes. Here's an example:
+"Basic" and "Digest" authentication schemes. Here's an example:
use HTTPD::UserAdmin ();
HTTPD::UserAdmin
@@ -439,7 +439,7 @@
(personal ID number). Record the address and PIN (best that it be a
random one) for later processing. In the mail you send, ask them to
include the PIN in their reply. But if it bounces, or the message is
-included via a ``vacation'' script, it'll be there anyway. So it's
+included via a "vacation" script, it'll be there anyway. So it's
best to ask them to mail back a slight alteration of the PIN, such as
with the characters reversed, one added or subtracted to each digit, etc.
//depot/perl/pod/perlgpl.pod#6 (text)
Index: perl/pod/perlgpl.pod
perl/pod/perlgpl.pod#5~20680~Wed Aug 13 10:11:38 2003
perl/pod/perlgpl.podFri Jun 3 01:04:25 2005
@@ -352,13 +352,13 @@
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) 19yy name of author
- Gnomovision comes with ABSLUTELY N WARRANTY; for details type `show w'.
+ Gnomovision comes with ABSLUTELY N WARRANTY; for details type "show w".
This is free software, and you are welcome to redistribute it
- under certain conditions; type `show c' for details.
+ under certain conditions; type "show c" for details.
-The hypothetical commands `show w' and `show c' should show the appropriate
+The hypothetical commands "show w" and "show c" should show the appropriate
parts of the General Public License. course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
+be called something other than "show w" and "show c"; they could even be
mouse-clicks or menu items suits your program.
You should also get your employer (if you work as a programmer) or your
@@ -366,7 +366,7 @@
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
- `Gnomovision' (which makes passes at compilers) written by James Hacker.
+ "Gnomovision" (which makes passes at compilers) written by James Hacker.
<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
//depot/perl/pod/perlhack.pod#86 (text)
Index: perl/pod/perlhack.pod
perl/pod/perlhack.pod#85~24381~Tue May 3 15:10:45 2005
perl/pod/perlhack.podFri Jun 3 01:04:25 2005
@@ -34,12 +34,12 @@
this group of porters presides Larry Wall. He has the final word
in what does and does not change in the Perl language. Various
-releases of Perl are shepherded by a ``pumpking'', a porter
-responsible for gathering patches, deciding on a patch-by-patch
+releases of Perl are shepherded by a "pumpking", a porter
+responsible for gathering patches, deciding on a patch-by-patch,
feature-by-feature basis what will and will not go into the release.
For instance, Gurusamy Sarathy was the pumpking for the 5.6 release of
Perl, and Jarkko Hietaniemi was the pumpking for the 5.8 release, and
-Hugo van der Sanden and Rafael Garcia-Suarez share the pumpking for
+Hugo van der Sanden and Rafael Garcia-Suarez share the pumpking crown for
the 5.10 release.
In addition, various people are pumpkings for different things. For
@@ -130,7 +130,7 @@
or would it be broadly useful? Sometimes, instead of adding a feature
with a tight focus, the porters might decide to wait until someone
implements the more generalized feature. For instance, instead of
-implementing a ``delayed evaluation'' feature, the porters are waiting
+implementing a "delayed evaluation" feature, the porters are waiting
for a macro system that would permit delayed evaluation and much more.
=item Does it potentially introduce new bugs?
@@ -179,8 +179,8 @@
=item Is there another way to do it?
-Larry said ``Although the Perl Slogan is I<There's More Than Way
-to Do It>, I hesitate to make 10 ways to do something''. This is a
+Larry said "Although the Perl Slogan is I<There's More Than Way
+to Do It>, I hesitate to make 10 ways to do something". This is a
tricky heuristic to navigate, though man's essential addition is
another man's pointless cruft.
@@ -194,16 +194,16 @@
Working code is always preferred to pie-in-the-sky ideas. A patch to
add a feature stands a much higher chance of making it to the language
than does a random feature request, no matter how fervently argued the
-request might be. This ties into ``Will it be useful?'', as the fact
+request might be. This ties into "Will it be useful?", as the fact
that someone took the time to make the patch demonstrates a strong
desire for the feature.
=back
-If you're on the list, you might hear the word ``core'' bandied
-around. It refers to the standard distribution. ``Hacking on the
-core'' means you're changing the C source code to the Perl
-interpreter. ``A core module'' is one that ships with Perl.
+If you're on the list, you might hear the word "core" bandied
+around. It refers to the standard distribution. "Hacking on the
+core" means you're changing the C source code to the Perl
+interpreter. "A core module" is one that ships with Perl.
=head2 Keeping in sync
@@ -254,7 +254,7 @@
=item rsync'ing the source tree
Presuming you are in the directory where your perl source resides
-and you have rsync installed and available, you can `upgrade' to
+and you have rsync installed and available, you can "upgrade" to
the bleadperl using:
# rsync -avz .
@@ -805,7 +805,7 @@
C<yyparse>, the parser, lives in F<perly.c>, although you're better off
reading the original YACC input in F<perly.y>. (Yes, Virginia, there
B<isa YACC grammar for Perl!) The job of the parser is to take your
-code and `understand' it, splitting it into sentences, deciding which
+code and "understand" it, splitting it into sentences, deciding which
operands go with which operators and so on.
The parser is nobly assisted by the lexer, which chunks up your input
@@ -859,7 +859,7 @@
execution if required.
The actual functions called are known as PP code, and they're spread
-between four files: F<pp_hot.ccontains the `hot' code, which is most
+between four files: F<pp_hot.ccontains the "hot" code, which is most
often used and highly optimized, F<pp_sys.ccontains all the
system-specific functions, F<pp_ctl.ccontains the functions which
implement control structures (C<if>, C<whileand the like) and F<pp.c>
@@ -1254,10 +1254,10 @@
fed certain things by the tokeniser, which generally end up in upper
case. Here, C<ADDP>, is provided when the tokeniser sees C<+in your
code. C<ASSIGNPis provided when C<=is used for assigning. These are
-`terminal symbols', because you can't get any simpler than them.
+"terminal symbols", because you can't get any simpler than them.
The grammar, lines one and three of the snippet above, tells you how to
-build up more complex forms. These complex forms, `non-terminal symbols'
+build up more complex forms. These complex forms, "non-terminal symbols"
are generally placed in lower case. C<termhere is a non-terminal
symbol, representing a single expression.
@@ -1286,8 +1286,8 @@
C<newBINP>, a function in F<op.c>, is the op type. It's an addition
operator, so we want the type to be C<ADDP>. We could specify this
directly, but it's right there as the second token in the input, so we
-use C<$2>. The second parameter is the op's flags: 0 means `nothing
-special'. Then the things to add: the left and right hand side of our
+use C<$2>. The second parameter is the op's flags: 0 means "nothing
+special". Then the things to add: the left and right hand side of our
expression, in scalar context.
=head2 Stacks
@@ -1335,14 +1335,14 @@
=item Mark stack
-I say `your portion of the stack' above because PP code doesn't
+I say "your portion of the stack" above because PP code doesn't
necessarily get the whole stack to itself: if your function calls
another function, you'll only want to expose the arguments aimed for the
called function, and not (necessarily) let it get at your own data. The
-way we do this is to have a `virtual' bottom-of-stack, exposed to each
+way we do this is to have a "virtual" bottom-of-stack, exposed to each
function. The mark stack keeps bookmarks to locations in the argument
stack usable by each function. For instance, when dealing with a tied
-variable, (internally, something with `P' magic) Perl has to call
+variable, (internally, something with "P" magic) Perl has to call
methods for accesses to the tied variables. However, we need to separate
the arguments exposed to the method to the argument exposed to the
original function - the store or fetch or whatever it may be. Here's how
//depot/perl/pod/perlipc.pod#59 (text)
Index: perl/pod/perlipc.pod
perl/pod/perlipc.pod#58~23642~Mon Dec 13 01:54:23 2004
perl/pod/perlipc.podFri Jun 3 01:04:25 2005
@@ -307,8 +307,8 @@
which will just restart. That means you have to C<dieto longjump(3) out
of the handler. Even this is a little cavalier for the true paranoiac,
who avoids C<diein a handler because the system I<isout to get you.
-The pragmatic approach was to say ``I know the risks, but prefer the
-convenience'', and to do anything you wanted in your signal handler,
+The pragmatic approach was to say "I know the risks, but prefer the
+convenience", and to do anything you wanted in your signal handler,
and be prepared to clean up core dumps now and again.
In Perl 5.7.3 and later to avoid these problems signals are
//depot/perl/pod/perllocale.pod#38 (text)
Index: perl/pod/perllocale.pod
perl/pod/perllocale.pod#37~24090~Mon Mar 28 23:01:11 2005
perl/pod/perllocale.podFri Jun 3 01:04:25 2005
@@ -293,7 +293,7 @@
the full list of relevant environment variables and L<USING LCALES>
for their effects in Perl. Effects in other programs are
easily deducible. For example, the variable LC_CLLATE may well affect
-your B<sortprogram (or whatever the program that arranges `records'
+your B<sortprogram (or whatever the program that arranges "records"
alphabetically in your system is called).
You can test out changing these variables temporarily, and if the
//depot/perl/pod/perlport.pod#152 (text)
Index: perl/pod/perlport.pod
perl/pod/perlport.pod#151~24593~Fri May 27 00:44:07 2005
perl/pod/perlport.podFri Jun 3 01:04:25 2005
@@ -658,9 +658,9 @@
Do not assume anything about the ordering of the characters.
The lowercase letters may come before or after the uppercase letters;
-the lowercase and uppercase may be interlaced so that both `a' and `A'
-come before `b'; the accented and other international characters may
-be interlaced so that E<aumlcomes before `b'.
+the lowercase and uppercase may be interlaced so that both "a" and "A"
+come before "b"; the accented and other international characters may
+be interlaced so that E<aumlcomes before "b".
=head2 Internationalisation
//depot/perl/pod/perlre.pod#90 (text)
Index: perl/pod/perlre.pod
perl/pod/perlre.pod#89~24624~Mon May 30 01:11:30 2005
perl/pod/perlre.podFri Jun 3 01:04:25 2005
@@ -223,12 +223,12 @@
=item [1]
-A GNU extension equivalent to C<[ \t]>, `all horizontal whitespace'.
+A GNU extension equivalent to C<[ \t]>, "all horizontal whitespace".
=item [2]
Not exactly equivalent to C<\ssince the C<[[:space:]]includes
-also the (very rare) `vertical tabulator', "\ck", chr(11).
+also the (very rare) "vertical tabulator", "\ck", chr(11).
=item [3]
@@ -252,7 +252,7 @@
alpha IsAlpha
alnum IsAlnum
ascii IsASCII
- blankIsSpace
+ blank IsSpace
cntrl IsCntrl
digit IsDigit \d
graph IsGraph
@@ -269,7 +269,7 @@
If the C<utf8pragma is not used but the C<localepragma is, the
classes correlate with the usual isalpha(3) interface (except for
-`word' and `blank').
+"word" and "blank").
The assumedly non-obviously named classes are:
//depot/perl/pod/perlref.pod#27 (text)
Index: perl/pod/perlref.pod
perl/pod/perlref.pod#26~19637~Thu May 29 11:47:40 2003
perl/pod/perlref.podFri Jun 3 01:04:25 2005
@@ -591,13 +591,13 @@
accustomed to using nested subroutines in other programming languages with
their own private variables, you'll have to work at it a bit in Perl. The
intuitive coding of this type of thing incurs mysterious warnings about
-``will not stay shared''. For example, this won't work:
+"will not stay shared". For example, this won't work:
sub outer {
my $x = $_[0] + 35;
sub inner { return $x * 19 } # WRNG
return $x + inner();
- }
+ }
A work-around is the following:
@@ -605,7 +605,7 @@
my $x = $_[0] + 35;
local *inner = sub { return $x * 19 };
return $x + inner();
- }
+ }
Now inner() can only be called from within outer(), because of the
temporary assignments of the closure (anonymous subroutine). But when
//depot/perl/pod/perlthrtut.pod#31 (text)
Index: perl/pod/perlthrtut.pod
perl/pod/perlthrtut.pod#30~23496~Fri Nov 12 12:47:19 2004
perl/pod/perlthrtut.podFri Jun 3 01:04:25 2005
@@ -52,8 +52,8 @@
=head2 Boss/Worker
-The boss/worker model usually has one `boss' thread and one or more
-`worker' threads. The boss thread gathers or generates tasks that need
+The boss/worker model usually has one "boss" thread and one or more
+"worker" threads. The boss thread gathers or generates tasks that need
to be done, then parcels those tasks out to the appropriate worker
thread.
End of Patch.