From: Tom Christiansen Date: Tue, 11 Aug 1998 10:58:07 +0000 (-0500) Subject: Fix most of the bad L<> links of X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b687b08b628449b317ff558f31d9d716ace045de;p=p5sagit%2Fp5-mst-13.2.git Fix most of the bad L<> links of Subject: bad L<> links Reply-to: tchrist@perl.com To: perlbug@jhereg.perl.com Message-Id: <199808111658.KAA00484@jhereg.perl.com> The ones not fixed may require darker Pod::HTML magic, for example the perlguts.html#tags should work fine, IMHO. p4raw-id: //depot/cfgperl@2437 --- diff --git a/pod/perl5005delta.pod b/pod/perl5005delta.pod index 23bf0f3..62787f5 100644 --- a/pod/perl5005delta.pod +++ b/pod/perl5005delta.pod @@ -85,7 +85,7 @@ begin with C be referenced with a C prefix. The bare function names without the C prefix are supported with macros, but this support may cease in a future release. -See L. +See L. =item Enabling threads has source compatibility issues @@ -100,7 +100,7 @@ directly accessing perl globals as C. The API call is backward compatible with existing perls and provides source compatibility with threading is enabled. -See L. +See L<"C Source Compatibility"> for more information. =back diff --git a/pod/perlcall.pod b/pod/perlcall.pod index e3e02de..8771be8 100644 --- a/pod/perlcall.pod +++ b/pod/perlcall.pod @@ -72,7 +72,7 @@ Each of the functions will now be discussed in turn. =over 5 -=item B +=item perl_call_sv I takes two parameters, the first, C, is an SV*. This allows you to specify the Perl subroutine to be called either as a @@ -80,7 +80,7 @@ C string (which has first been converted to an SV) or a reference to a subroutine. The section, I, shows how you can make use of I. -=item B +=item perl_call_pv The function, I, is similar to I except it expects its first parameter to be a C char* which identifies the Perl @@ -88,7 +88,7 @@ subroutine you want to call, e.g., C. If the subroutine you want to call is in another package, just include the package name in the string, e.g., C<"pkg::fred">. -=item B +=item perl_call_method The function I is used to call a method from a Perl class. The parameter C corresponds to the name of the method @@ -99,7 +99,7 @@ object (for a virtual method). See L for more information on static and virtual methods and L for an example of using I. -=item B +=item perl_call_argv I calls the Perl subroutine specified by the C string stored in the C parameter. It also takes the usual C diff --git a/pod/perldata.pod b/pod/perldata.pod index 8f700f6..9e41c2c 100644 --- a/pod/perldata.pod +++ b/pod/perldata.pod @@ -253,7 +253,7 @@ literals are subject to backslash and variable substitution; single-quoted strings are not (except for "C<\'>" and "C<\\>"). The usual Unix backslash rules apply for making characters such as newline, tab, etc., as well as some more exotic forms. See -L for a list. +L for a list. Octal or hex representations in string literals (e.g. '0xffff') are not automatically converted to their integer representation. The hex() and diff --git a/pod/perldiag.pod b/pod/perldiag.pod index 29ed897..50552cf 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -1428,7 +1428,7 @@ architecture. On a 32-bit architecture the largest octal literal is (S) A warning peculiar to VMS. Perl keeps track of the number of times you've called C and C, to determine whether the current call to C should affect the current -script or a subprocess (see L). Somehow, this count +script or a subprocess (see L). Somehow, this count has become scrambled, so Perl is making a guess and treating this C as a request to terminate the Perl script and execute the specified command. diff --git a/pod/perlfaq5.pod b/pod/perlfaq5.pod index 015c9b4..3e1103b 100644 --- a/pod/perlfaq5.pod +++ b/pod/perlfaq5.pod @@ -289,8 +289,8 @@ pair to make it easy to sort the hash in insertion order. } For passing filehandles to functions, the easiest way is to -prefer them with a star, as in func(*STDIN). See L for details. +prefer them with a star, as in func(*STDIN). +See L for details. If you want to create many, anonymous handles, you should check out the Symbol, FileHandle, or IO::Handle (etc.) modules. Here's the equivalent diff --git a/pod/perlfaq7.pod b/pod/perlfaq7.pod index cb7f3c0..07a6570 100644 --- a/pod/perlfaq7.pod +++ b/pod/perlfaq7.pod @@ -594,7 +594,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. There's -also an example in L. +also an example in L. If you want to overload a Perl operator, such as C<+> or C<**>, then you'll want to use the C pragma, documented diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 557d418..e8546be 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -1592,7 +1592,7 @@ is left as an exercise to the reader. The C function can do this more portably on systems purporting POSIX compliance. See also the C module from your nearest CPAN site; -details on CPAN can be found on L. +details on CPAN can be found on L. =item getlogin @@ -2526,7 +2526,7 @@ them, and automatically close whenever and however you leave that scope: $first; # Or here. } -See L for some details about mixing reading and writing. +See L for some details about mixing reading and writing. =item opendir DIRHANDLE,EXPR @@ -3410,7 +3410,7 @@ busy multitasking system. For delays of finer granularity than one second, you may use Perl's C interface to access setitimer(2) if your system supports it, -or else see L above. +or else see L above. See also the POSIX module's C function. @@ -4221,7 +4221,7 @@ Unlike C, the C function will not use or require a module for you--you need to do that explicitly yourself. See L or the F module for interesting C implementations. -For further details see L, L. +For further details see L, L<"tied VARIABLE">. =item tied VARIABLE diff --git a/pod/perlguts.pod b/pod/perlguts.pod index 38d7569..4ccc6c6 100644 --- a/pod/perlguts.pod +++ b/pod/perlguts.pod @@ -1025,13 +1025,13 @@ There is a way to achieve a similar task from C via Perl API: create a I, and arrange for some changes to be automatically undone at the end of it, either explicit, or via a non-local exit (via die()). A I-like construct is created by a pair of -C/C macros (see L). Such a construct may be created specially for some -important localized task, or an existing one (like boundaries of -enclosing Perl subroutine/block, or an existing pair for freeing TMPs) -may be used. (In the second case the overhead of additional -localization must be almost negligible.) Note that any XSUB is -automatically enclosed in an C/C pair. +C/C macros (see L). +Such a construct may be created specially for some important localized +task, or an existing one (like boundaries of enclosing Perl +subroutine/block, or an existing pair for freeing TMPs) may be +used. (In the second case the overhead of additional localization must +be almost negligible.) Note that any XSUB is automatically enclosed in +an C/C pair. Inside such a I the following service is available: diff --git a/pod/perllocale.pod b/pod/perllocale.pod index ba93f18..dba15fe 100644 --- a/pod/perllocale.pod +++ b/pod/perllocale.pod @@ -330,7 +330,7 @@ Second, if using the listed commands you see something B (prefix matches do not count and case usually counts) like "En_US" without the quotes, then you should be okay because you are using a locale name that should be installed and available in your system. -In this case, see L. +In this case, see L. =head2 Permanently fixing your locale configuration @@ -349,7 +349,7 @@ rules for matching locale names are a bit vague because standardization is weak in this area. See again the L about general rules. -=head2 Permanently fixing system locale configuration +=head2 Fixing system locale configuration Contact a system administrator (preferably your own) and report the exact error message you get, and ask them to read this same documentation you @@ -855,7 +855,7 @@ always in force, even if the program environment suggested otherwise (see L). By default, Perl still behaves this way for backward compatibility. If you want a Perl application to pay attention to locale information, you B use the S> -pragma (see L) to instruct it to do so. +pragma (see L) to instruct it to do so. Versions of Perl from 5.002 to 5.003 did use the C information if available; that is, C<\w> did understand what diff --git a/pod/perlobj.pod b/pod/perlobj.pod index f10fbdf..182e3ee 100644 --- a/pod/perlobj.pod +++ b/pod/perlobj.pod @@ -84,7 +84,7 @@ that wish to call methods in the class as part of the construction: } If you care about inheritance (and you should; see -L), +L), then you want to use the two-arg form of bless so that your constructors may be inherited: diff --git a/pod/perlport.pod b/pod/perlport.pod index 918827c..06c993b 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -822,7 +822,7 @@ an effect on what happens with some perl functions (such as C, C, C, C, C, C, C, C), as well as bit-fiddling with ASCII constants using operators like C<^>, C<&> and C<|>, not to mention dealing with socket interfaces to ASCII computers -(see L<"NEWLINES">). +(see L). Fortunately, most web servers for the mainframe will correctly translate the C<\n> in the following statement to its ASCII equivalent (note that diff --git a/pod/perlsub.pod b/pod/perlsub.pod index 957b3d8..95fbb6b 100644 --- a/pod/perlsub.pod +++ b/pod/perlsub.pod @@ -199,7 +199,7 @@ pre-defined things are C, C, C, and C--plus all t functions mentioned in L. The 5.005 release adds C to this list. -=head2 Private Variables via C +=head2 Private Variables via my() Synopsis: diff --git a/pod/perlvar.pod b/pod/perlvar.pod index fb27bfb..b9b0ce6 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -845,12 +845,16 @@ specified, and the value is the location of the file actually found. The C command uses this array to determine whether a given file has already been included. -=item %ENV $ENV{expr} +=item %ENV + +=item $ENV{expr} The hash %ENV contains your current environment. Setting a value in C changes the environment for child processes. -=item %SIG $SIG{expr} +=item %SIG + +=item $SIG{expr} The hash %SIG is used to set signal handlers for various signals. Example: