summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorJohn Borwick <jhborwic@unity.ncsu.edu>2000-11-01 08:19:21 -0500
committerJarkko Hietaniemi <jhi@iki.fi>2000-11-01 18:34:55 +0000
commitb73a15ae73f7f71da9a3815a2de5baed524d5e64 (patch)
treef43c11216c2985ca75373148d493fbefd10e639e /pod
parentb7ee89cee3c5aae4c446f4045b031f8bf83c927e (diff)
downloadperl-b73a15ae73f7f71da9a3815a2de5baed524d5e64.tar.gz
Generalize the Camel wording.
Subject: Re: perlfaq style changes Message-ID: <Pine.GSO.4.21.0011011318270.7428-100000@eos00du.eos.ncsu.edu> p4raw-id: //depot/perl@7516
Diffstat (limited to 'pod')
-rw-r--r--pod/perlfaq3.pod3
-rw-r--r--pod/perlfaq8.pod17
-rw-r--r--pod/perlfaq9.pod2
3 files changed, 12 insertions, 10 deletions
diff --git a/pod/perlfaq3.pod b/pod/perlfaq3.pod
index 0400b2756e..1d06c2dc10 100644
--- a/pod/perlfaq3.pod
+++ b/pod/perlfaq3.pod
@@ -244,8 +244,7 @@ See the next question on ``How can I make my Perl program run faster?''
=head2 How can I make my Perl program run faster?
The best way to do this is to come up with a better algorithm. This
-can often make a dramatic difference. Chapter 8 in the Camel has some
-efficiency tips in it you might want to look at. Jon Bentley's book
+can often make a dramatic difference. Jon Bentley's book
``Programming Pearls'' (that's not a misspelling!) has some good tips
on optimization, too. Advice on benchmarking boils down to: benchmark
and profile to make sure you're optimizing the right part, look for
diff --git a/pod/perlfaq8.pod b/pod/perlfaq8.pod
index 0b0d1ecc0d..1f8a72bfdf 100644
--- a/pod/perlfaq8.pod
+++ b/pod/perlfaq8.pod
@@ -217,7 +217,7 @@ FAQ for that.)
There's an example of this in L<perlfunc/crypt>). First, you put the
terminal into "no echo" mode, then just read the password normally.
You may do this with an old-style ioctl() function, POSIX terminal
-control (see L<POSIX> and Chapter 7 of the Camel, 2nd ed.), or a call
+control (see L<POSIX> or its documentation the Camel Book), or a call
to the B<stty> program, with varying degrees of portability.
You can also do this for most systems using the Term::ReadKey module
@@ -389,7 +389,8 @@ Zombies are not an issue with C<system("prog &")>.
You don't actually "trap" a control character. Instead, that character
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 chapter 6 of the Camel.
+Signals are documented in L<perlipc/"Signals"> and the
+section on ``Signals'' in the Camel.
Be warned that very few C libraries are re-entrant. Therefore, if you
attempt to print() in a handler that got invoked during another stdio
@@ -414,7 +415,8 @@ However, because syscalls restart by default, you'll find that if
you're in a "slow" call, such as <FH>, read(), connect(), or
wait(), that the only way to terminate them is by "longjumping" out;
that is, by raising an exception. See the time-out handler for a
-blocking flock() in L<perlipc/"Signals"> or chapter 6 of the Camel, 2nd ed.
+blocking flock() in L<perlipc/"Signals"> or the section on ``Signals''
+in the Camel book.
=head2 How do I modify the shadow password file on a Unix system?
@@ -503,7 +505,8 @@ though, so if you use END blocks you should also use
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"> and chapter 6 of the Camel 2nd ed.
+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
exceptions.pl library (part of the standard perl distribution).
@@ -931,9 +934,9 @@ the current process group of your controlling terminal as follows:
=head2 How do I timeout a slow event?
Use the alarm() function, probably in conjunction with a signal
-handler, as documented in L<perlipc/"Signals"> and chapter 6 of the
-Camel. You may instead use the more flexible Sys::AlarmCall module
-available from CPAN.
+handler, as documented in L<perlipc/"Signals"> and the section on
+``Signals'' in the Camel. You may instead use the more flexible
+Sys::AlarmCall module available from CPAN.
=head2 How do I set CPU limits?
diff --git a/pod/perlfaq9.pod b/pod/perlfaq9.pod
index a977f95e8d..ddc577b01f 100644
--- a/pod/perlfaq9.pod
+++ b/pod/perlfaq9.pod
@@ -289,7 +289,7 @@ command and arguments as a list, which prevents shell globbing.
=head2 How do I parse a mail header?
For a quick-and-dirty solution, try this solution derived
-from page 222 of the 2nd edition of "Programming Perl":
+from L<perlfunc/split>:
$/ = '';
$header = <MSG>;