summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorApocalypse <perl@0ne.us>2011-02-15 18:38:04 -0700
committerFather Chrysostomos <sprout@cpan.org>2011-02-15 20:25:25 -0800
commit96090e4f0acf1d24051c680595b4740bd24cb69a (patch)
tree2018450c5cbec81deb0268f3d899e03534c797b9 /pod
parentc05760c68edc298aadab73da2781ba0fe1cf24b6 (diff)
downloadperl-96090e4f0acf1d24051c680595b4740bd24cb69a.tar.gz
Fix bad pod links found by Test::Pod::LinkCheck
Diffstat (limited to 'pod')
-rw-r--r--pod/perldata.pod4
-rw-r--r--pod/perldebguts.pod2
-rw-r--r--pod/perldebug.pod2
-rw-r--r--pod/perldiag.pod2
-rw-r--r--pod/perlembed.pod4
-rw-r--r--pod/perlfaq7.pod3
-rw-r--r--pod/perlfaq8.pod2
-rw-r--r--pod/perlform.pod2
-rw-r--r--pod/perlfunc.pod21
-rw-r--r--pod/perlglossary.pod11
-rw-r--r--pod/perlinterp.pod2
-rw-r--r--pod/perllocale.pod2
-rw-r--r--pod/perlmod.pod2
-rw-r--r--pod/perlobj.pod2
-rw-r--r--pod/perlperf.pod4
-rw-r--r--pod/perlport.pod2
-rw-r--r--pod/perlre.pod4
-rw-r--r--pod/perlreapi.pod2
-rw-r--r--pod/perlrun.pod4
-rw-r--r--pod/perlsub.pod2
-rw-r--r--pod/perltodo.pod2
-rw-r--r--pod/perlvar.pod2
-rw-r--r--pod/perlvms.pod6
23 files changed, 45 insertions, 44 deletions
diff --git a/pod/perldata.pod b/pod/perldata.pod
index 03191b54e1..1b1cbf4564 100644
--- a/pod/perldata.pod
+++ b/pod/perldata.pod
@@ -862,8 +862,8 @@ C<use strict 'refs'> forbids such practice.
Another way to create anonymous filehandles is with the Symbol
module or with the IO::Handle module and its ilk. These modules
have the advantage of not hiding different types of the same name
-during the local(). See the bottom of L<perlfunc/open()> for an
-example.
+during the local(). See the bottom of L<perlfunc/"open FILEHANDLE">
+for an example.
=head1 SEE ALSO
diff --git a/pod/perldebguts.pod b/pod/perldebguts.pod
index d6bffb1410..e5970a3e54 100644
--- a/pod/perldebguts.pod
+++ b/pod/perldebguts.pod
@@ -151,7 +151,7 @@ after the debugger completes its own initialization.)
After the rc file is read, the debugger reads the PERLDB_OPTS
environment variable and uses it to set debugger options. The
contents of this variable are treated as if they were the argument
-of an C<o ...> debugger command (q.v. in L<perldebug/Options>).
+of an C<o ...> debugger command (q.v. in L<perldebug/"Configurable Options">).
=head3 Debugger Internal Variables
diff --git a/pod/perldebug.pod b/pod/perldebug.pod
index 07aa302709..8fbb2312ad 100644
--- a/pod/perldebug.pod
+++ b/pod/perldebug.pod
@@ -654,7 +654,7 @@ X<debugger option, dieLevel>
Level of verbosity. By default, the debugger leaves your exceptions
and warnings alone, because altering them can break correctly running
programs. It will attempt to print a message when uncaught INT, BUS, or
-SEGV signals arrive. (But see the mention of signals in L<BUGS> below.)
+SEGV signals arrive. (But see the mention of signals in L</BUGS> below.)
To disable this default safe mode, set these values to something higher
than 0. At a level of 1, you get backtraces upon receiving any kind
diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 7a3b962451..087f90682a 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -2413,7 +2413,7 @@ an undefined value for the length. See L<perlfunc/pack>.
=item Lexing code attempted to stuff non-Latin-1 character into Latin-1 input
(F) An extension is attempting to insert text into the current parse
-(using L<lex_stuff_pvn_flags|perlapi/lex_stuff_pvn_flags> or similar), but tried to insert a character
+(using L<lex_stuff_pvn|perlapi/lex_stuff_pvn> or similar), but tried to insert a character
that couldn't be part of the current input. This is an inherent pitfall
of the stuffing mechanism, and one of the reasons to avoid it. Where it
is necessary to stuff, stuffing only plain ASCII is recommended.
diff --git a/pod/perlembed.pod b/pod/perlembed.pod
index 1144e43386..8edff17542 100644
--- a/pod/perlembed.pod
+++ b/pod/perlembed.pod
@@ -1109,8 +1109,8 @@ you will have to write the explicit full form
Perl_warn(aTHX_ "%d bottles of beer on the wall", bottlecount);
-(See L<perlguts/Background and PERL_IMPLICIT_CONTEXT for the explanation
-of the C<aTHX_>.> ) Hiding the short forms is very useful for avoiding
+(See L<perlguts/"Background and PERL_IMPLICIT_CONTEXT"> for the explanation
+of the C<aTHX_>. ) Hiding the short forms is very useful for avoiding
all sorts of nasty (C preprocessor or otherwise) conflicts with other
software packages (Perl defines about 2400 APIs with these short names,
take or leave few hundred, so there certainly is room for conflict.)
diff --git a/pod/perlfaq7.pod b/pod/perlfaq7.pod
index 983825b904..5d7a1e896e 100644
--- a/pod/perlfaq7.pod
+++ b/pod/perlfaq7.pod
@@ -633,8 +633,7 @@ Why do you want to do that? :-)
If you want to override a predefined function, such as open(),
then you'll have to import the new definition from a different
-module. See L<perlsub/"Overriding Built-in Functions">. There's
-also an example in L<perltoot/"Class::Template">.
+module. See L<perlsub/"Overriding Built-in Functions">.
If you want to overload a Perl operator, such as C<+> or C<**>,
then you'll want to use the C<use overload> pragma, documented
diff --git a/pod/perlfaq8.pod b/pod/perlfaq8.pod
index 99af392875..0e9fcc5bfd 100644
--- a/pod/perlfaq8.pod
+++ b/pod/perlfaq8.pod
@@ -933,7 +933,7 @@ approach will suffice:
=head2 How can I write expect in Perl?
-Once upon a time, there was a library called L<chat2.pl> (part of the
+Once upon a time, there was a library called F<chat2.pl> (part of the
standard perl distribution), which never really got finished. If you
find it somewhere, I<don't use it>. These days, your best bet is to
look at the Expect module available from CPAN, which also requires two
diff --git a/pod/perlform.pod b/pod/perlform.pod
index df0f0a174d..6a6a83ae3a 100644
--- a/pod/perlform.pod
+++ b/pod/perlform.pod
@@ -393,7 +393,7 @@ by checking $FORMAT_LINES_LEFT before each write() and print the footer
yourself if necessary.
Here's another strategy: Open a pipe to yourself, using C<open(MYSELF, "|-")>
-(see L<perlfunc/open()>) and always write() to MYSELF instead of STDOUT.
+(see L<perlfunc/"open FILEHANDLE">) and always write() to MYSELF instead of STDOUT.
Have your child process massage its STDIN to rearrange headers and footers
however you like. Not very convenient, but doable.
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 2047dd6047..3ed689ed94 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -1271,7 +1271,7 @@ C<die> raises an exception. Inside an C<eval> the error message is stuffed
into C<$@> and the C<eval> is terminated with the undefined value.
If the exception is outside of all enclosing C<eval>s, then the uncaught
exception prints LIST to C<STDERR> and exits with a non-zero value. If you
-need to exit the process with a specific exit code, see L<exit>.
+need to exit the process with a specific exit code, see L</exit>.
Equivalent examples:
@@ -1355,7 +1355,7 @@ You can arrange for a callback to be run just before the C<die>
does its deed, by setting the C<$SIG{__DIE__}> hook. The associated
handler is called with the error text and can change the error
message, if it sees fit, by calling C<die> again. See
-L<perlvar/$SIG{expr}> for details on setting C<%SIG> entries, and
+L<perlvar/%SIG> for details on setting C<%SIG> entries, and
L<"eval BLOCK"> for some examples. Although this feature was
to be run only right before your program was to exit, this is not
currently so: the C<$SIG{__DIE__}> hook is currently called
@@ -1401,9 +1401,9 @@ is just like
eval `cat stat.pl`;
except that it's more efficient and concise, keeps track of the current
-filename for error messages, searches the @INC directories, and updates
-C<%INC> if the file is found. See L<perlvar/Predefined Names> for these
-variables. It also differs in that code evaluated with C<do FILENAME>
+filename for error messages, searches the C<@INC> directories, and updates
+C<%INC> if the file is found. See L<perlvar/@INC> and L<perlvar/%INC> for
+these variables. It also differs in that code evaluated with C<do FILENAME>
cannot see lexicals in the enclosing scope; C<eval STRING> does. It's the
same, however, in that it does reparse the file every time you call it,
so you probably don't want to do this inside a loop.
@@ -2775,7 +2775,8 @@ respectively.
=item Otherwise, If EXPR has the UTF8 flag set
If the current package has a subroutine named C<ToLower>, it will be used to
-change the case (See L<perlunicode/User-Defined Case Mappings>.)
+change the case
+(See L<perlunicode/"User-Defined Case Mappings (for serious hackers only)">.)
Otherwise Unicode semantics are used for the case change.
=item Otherwise, if C<use locale> is in effect
@@ -3302,7 +3303,8 @@ replace dash (C<'-'>) with the command.
See L<perlipc/"Using open() for IPC"> for more examples of this.
(You are not allowed to C<open> to a command that pipes both in I<and>
out, but see L<IPC::Open2>, L<IPC::Open3>, and
-L<perlipc/"Bidirectional Communication"> for alternatives.)
+L<perlipc/"Bidirectional Communication with Another Process"> for
+alternatives.)
In the form of pipe opens taking three or more arguments, if LIST is specified
(extra arguments after the command name) then LIST becomes arguments
@@ -4342,7 +4344,8 @@ unless you are very careful. In addition, note that Perl's pipes use
IO buffering, so you may need to set C<$|> to flush your WRITEHANDLE
after each command, depending on the application.
-See L<IPC::Open2>, L<IPC::Open3>, and L<perlipc/"Bidirectional Communication">
+See L<IPC::Open2>, L<IPC::Open3>, and
+L<perlipc/"Bidirectional Communication with Another Process">
for examples of such things.
On systems that support a close-on-exec flag on files, that flag is set
@@ -7030,7 +7033,7 @@ The behavior is undefined if LENGTH is greater than the length of the
file.
The position in the file of FILEHANDLE is left unchanged. You may want to
-call L<seek> before writing to the file.
+call L<seek|/"seek FILEHANDLE,POSITION,WHENCE"> before writing to the file.
=item uc EXPR
X<uc> X<uppercase> X<toupper>
diff --git a/pod/perlglossary.pod b/pod/perlglossary.pod
index c4fb406b00..3a573c375b 100644
--- a/pod/perlglossary.pod
+++ b/pod/perlglossary.pod
@@ -241,7 +241,7 @@ the numbered variables (C<$1>, C<$2>, etc.) continue to refer to these
same values, as long as the pattern was the last successful match of
the current dynamic scope. C<\g{-1}> can be used to refer to a group by
relative rather than absolute position; and groups can be also be named, and
-referred to later by name rather than number. See L<perlre/Capture Buffers>.
+referred to later by name rather than number. See L<perlre/"Capture groups">.
=item backtracking
@@ -894,7 +894,7 @@ will be called a "binary-only" distribution.
=item (to be) dropped modules
-When Perl 5 was first released (see L<perlhistory>), several modules were
+When Perl 5 was first released (see L<perlhist>), several modules were
included, which have now fallen out of common use. It has been suggested
that these modules should be removed, since the distribution became rather
large, and the common criterion for new module additions is now limited to
@@ -2985,9 +2985,8 @@ L</argument> must be the last switch in a cluster.
A program technique that lets you evaluate an L</expression> and then,
based on the value of the expression, do a multiway branch to the
appropriate piece of code for that value. Also called a "case
-structure", named after the similar Pascal construct. Most switch
-statements in Perl are spelled C<for>. See L<perlsyn/Basic BLOCKs and
-Switch Statements>.
+structure", named after the similar Pascal construct. See
+L<perlsyn/"Switch statements">.
=item symbol
@@ -3155,7 +3154,7 @@ to build special tools. Perl is sort of a machine shop.
To turn one string representation into another by mapping each
character of the source string to its corresponding character in the
result string. See
-L<perlop/trE<sol>SEARCHLISTE<sol>REPLACEMENTLISTE<sol>cds>.
+L<perlop/trE<sol>SEARCHLISTE<sol>REPLACEMENTLISTE<sol>cdsr>.
=item trigger
diff --git a/pod/perlinterp.pod b/pod/perlinterp.pod
index 5d16e8b3bc..74a5e4eb96 100644
--- a/pod/perlinterp.pod
+++ b/pod/perlinterp.pod
@@ -696,7 +696,7 @@ stack implements the C equivalent of, for example:
...
}
-See L<perlguts/Localising Changes> for how to use the save stack.
+See L<perlguts/"Localizing Changes"> for how to use the save stack.
=head1 MILLIONS OF MACROS
diff --git a/pod/perllocale.pod b/pod/perllocale.pod
index 0bec4236e5..45385e84dd 100644
--- a/pod/perllocale.pod
+++ b/pod/perllocale.pod
@@ -866,7 +866,7 @@ using GNU libc and you can ignore C<LANGUAGE>.
However, in the case you are using C<LANGUAGE>: it affects the
language of informational, warning, and error messages output by
commands (in other words, it's like C<LC_MESSAGES>) but it has higher
-priority than L<LC_ALL>. Moreover, it's not a single value but
+priority than C<LC_ALL>. Moreover, it's not a single value but
instead a "path" (":"-separated list) of I<languages> (not locales).
See the GNU C<gettext> library documentation for more information.
diff --git a/pod/perlmod.pod b/pod/perlmod.pod
index 1a166a8f58..5266f199df 100644
--- a/pod/perlmod.pod
+++ b/pod/perlmod.pod
@@ -66,7 +66,7 @@ main, but we decided it was more useful for package writers to be able
to use leading underscore to indicate private variables and method names.
However, variables and functions named with a single C<_>, such as
$_ and C<sub _>, are still forced into the package C<main>. See also
-L<perlvar/"Technical Note on the Syntax of Variable Names">.
+L<perlvar/"The Syntax of Variable Names">.
C<eval>ed strings are compiled in the package in which the eval() was
compiled. (Assignments to C<$SIG{}>, however, assume the signal
diff --git a/pod/perlobj.pod b/pod/perlobj.pod
index fdecd84a68..850225f64a 100644
--- a/pod/perlobj.pod
+++ b/pod/perlobj.pod
@@ -576,7 +576,7 @@ destructed. Plain refs are only garbage-collected if the destruct level
is greater than 0. You can test the higher levels of global destruction
by setting the PERL_DESTRUCT_LEVEL environment variable, presuming
C<-DDEBUGGING> was enabled during perl build time.
-See L<perlhack/PERL_DESTRUCT_LEVEL> for more information.
+See L<perlhacktips/PERL_DESTRUCT_LEVEL> for more information.
A more complete garbage collection strategy will be implemented
at a future date.
diff --git a/pod/perlperf.pod b/pod/perlperf.pod
index a934271088..cac6eee665 100644
--- a/pod/perlperf.pod
+++ b/pod/perlperf.pod
@@ -567,7 +567,7 @@ to execute, C<if ( $debug ) { > and C<my $message = shift;>, for example. The
differences in the actual times recorded might be in the algorithm used
internally, or it could be due to system resource limitations or contention.
-See also the L<DBIx::Profiler> which will profile database queries running
+See also the L<DBIx::Profile> which will profile database queries running
under the C<DBIx::*> namespace.
=head2 Devel::NYTProf
@@ -1137,7 +1137,7 @@ deserve further attention.
Apache::DProf
Apache::SmallProf
Benchmark
- DBIx::Profiler
+ DBIx::Profile
Devel::AutoProfiler
Devel::DProf
Devel::DProfLB
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 97a2a2dd0b..9b34ef2b3d 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -1145,7 +1145,7 @@ Also see:
=item *
-F<README.vms> (installed as L<README_vms>), L<perlvms>
+F<README.vms> (installed as F<README_vms>), L<perlvms>
=item *
diff --git a/pod/perlre.pod b/pod/perlre.pod
index 0175fbe023..56e42f8088 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -1840,12 +1840,12 @@ match takes a long time to finish.
A powerful tool for optimizing such beasts is what is known as an
"independent group",
-which does not backtrack (see L<C<< (?>pattern) >>>). Note also that
+which does not backtrack (see L</C<< (?>pattern) >>>). Note also that
zero-length look-ahead/look-behind assertions will not backtrack to make
the tail match, since they are in "logical" context: only
whether they match is considered relevant. For an example
where side-effects of look-ahead I<might> have influenced the
-following match, see L<C<< (?>pattern) >>>.
+following match, see L</C<< (?>pattern) >>>.
=head2 Version 8 Regular Expressions
X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
diff --git a/pod/perlreapi.pod b/pod/perlreapi.pod
index dfe7af52ad..7028650549 100644
--- a/pod/perlreapi.pod
+++ b/pod/perlreapi.pod
@@ -131,7 +131,7 @@ Additional flags:
Set if C<use locale> is in effect. If present in C<< rx->extflags >>
C<split> will use the locale dependent definition of whitespace under
when RXf_SKIPWHITE or RXf_WHITE are in effect. Under ASCII whitespace
-is defined as per L<isSPACE|perlapi/ISSPACE>, and by the internal
+is defined as per L<isSPACE|perlapi/isSPACE>, and by the internal
macros C<is_utf8_space> under UTF-8 and C<isSPACE_LC> under C<use
locale>.
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index 473205a789..9165dca922 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -927,7 +927,7 @@ will treat the #! line as the first line.
Thus a warning on the 2nd line of the program (which is on the 100th
line in the file) will be reported as line 2, and not as line 100.
This can be overridden by using the #line directive.
-(See L<perlsyn/"Plain-Old-Comments-(Not!)">)
+(See L<perlsyn/"Plain Old Comments (Not!)">)
If a directory name is specified, Perl will switch to that directory
before running the program. The B<-x> switch controls only the
@@ -1211,7 +1211,7 @@ X<PERL_DESTRUCT_LEVEL>
Relevant only if your perl executable was built with B<-DDEBUGGING>,
this controls the behavior of global destruction of objects and other
-references. See L<perlhack/PERL_DESTRUCT_LEVEL> for more information.
+references. See L<perlhacktips/PERL_DESTRUCT_LEVEL> for more information.
=item PERL_DL_NONLAZY
X<PERL_DL_NONLAZY>
diff --git a/pod/perlsub.pod b/pod/perlsub.pod
index cfa4ad4183..ece4f159ca 100644
--- a/pod/perlsub.pod
+++ b/pod/perlsub.pod
@@ -351,7 +351,7 @@ it. Similarly, in the conditional
the scope of $answer extends from its declaration through the rest
of that conditional, including any C<elsif> and C<else> clauses,
-but not beyond it. See L<perlsyn/"Simple statements"> for information
+but not beyond it. See L<perlsyn/"Simple Statements"> for information
on the scope of variables in statements with modifiers.
The C<foreach> loop defaults to scoping its index variable dynamically
diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index ba10a480df..de0e373b46 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -28,7 +28,7 @@ programming languages offer you 1 line of immortality?
=head2 Migrate t/ from custom TAP generation
Many tests below F<t/> still generate TAP by "hand", rather than using library
-functions. As explained in L<perlhack/Writing a test>, tests in F<t/> are
+functions. As explained in L<perlhack/TESTING>, tests in F<t/> are
written in a particular way to test that more complex constructions actually
work before using them routinely. Hence they don't use C<Test::More>, but
instead there is an intentionally simpler library, F<t/test.pl>. However,
diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index 53295f0c9a..39bab245bb 100644
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -1691,7 +1691,7 @@ A format contains C<formline()> calls that put their result into
C<$^A>. After calling its format, C<write()> prints out the contents
of C<$^A> and empties. So you never really see the contents of C<$^A>
unless you call C<formline()> yourself and then look at it. See
-L<perlform> and L<perlfunc/formline()>.
+L<perlform> and L<perlfunc/"formline PICTURE,LIST">.
=item HANDLE->format_formfeed(EXPR)
diff --git a/pod/perlvms.pod b/pod/perlvms.pod
index fe2b5d825c..7e96c06b05 100644
--- a/pod/perlvms.pod
+++ b/pod/perlvms.pod
@@ -848,10 +848,10 @@ Therefore, the "system time" elements will always be 0, since
there is no difference between "user time" and "system" time
under VMS, and the time accumulated by a subprocess may or may
not appear separately in the "child time" field, depending on
-whether L<times> keeps track of subprocesses separately. Note
+whether C<times()> keeps track of subprocesses separately. Note
especially that the VAXCRTL (at least) keeps track only of
-subprocesses spawned using L<fork> and L<exec>; it will not
-accumulate the times of subprocesses spawned via pipes, L<system>,
+subprocesses spawned using C<fork()> and C<exec()>; it will not
+accumulate the times of subprocesses spawned via pipes, C<system()>,
or backticks.
=item unlink LIST