From: Ronald J. Kimball Date: Thu, 21 Aug 2003 17:09:17 +0000 (-0400) Subject: Re: pod cleanup X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=ffc145e8a18a4c952027b6b4c853bd908c48f521;p=p5sagit%2Fp5-mst-13.2.git Re: pod cleanup Message-ID: <20030821210917.GB164965@linguist.thayer.dartmouth.edu> (the pod part) p4raw-id: //depot/perl@20813 --- diff --git a/pod/perl5005delta.pod b/pod/perl5005delta.pod index 58d0c79..91d9a82 100644 --- a/pod/perl5005delta.pod +++ b/pod/perl5005delta.pod @@ -492,7 +492,7 @@ In previous versions, this would print "hello", but it now prints "g'bye". If C<$/> is a reference to an integer, or a scalar that holds an integer, <> will read in records instead of lines. For more info, see -L. +L>. =head1 Supported Platforms diff --git a/pod/perlfaq4.pod b/pod/perlfaq4.pod index 5e10a11..1be7333 100644 --- a/pod/perlfaq4.pod +++ b/pod/perlfaq4.pod @@ -359,7 +359,7 @@ The localtime function returns the day of the week. Without an argument localtime uses the current time. $day_of_year = (localtime)[7]; - + The POSIX module can also format a date as the day of the year or week of the year. @@ -369,7 +369,7 @@ week of the year. To get the day of year for any date, use the Time::Local module to get a time in epoch seconds for the argument to localtime. - + use POSIX qw/strftime/; use Time::Local; my $week_of_year = strftime "%W", @@ -380,7 +380,7 @@ The Date::Calc module provides two functions for to calculate these. use Date::Calc; my $day_of_year = Day_of_Year( 1987, 12, 18 ); my $week_of_year = Week_of_Year( 1987, 12, 18 ); - + =head2 How do I find the current century or millennium? Use the following simple functions: diff --git a/pod/perlhack.pod b/pod/perlhack.pod index f91334c..3214b33 100644 --- a/pod/perlhack.pod +++ b/pod/perlhack.pod @@ -1329,6 +1329,8 @@ but you have to say print Perl_sv_2pv_nolen(sv) +=back + You may find it helpful to have a "macro dictionary", which you can produce by saying C. Even then, F won't recursively apply those macros for you. @@ -1341,8 +1343,6 @@ included in the debugging information. Using F version 3.1, this means configuring with C<-Doptimize=-g3>. Other compilers might use a different switch (if they support debugging macros at all). -=back - =head2 Dumping Perl Data Structures One way to get around this macro hell is to use the dumping functions in diff --git a/pod/perlipc.pod b/pod/perlipc.pod index a75ccb5..5f8af22 100644 --- a/pod/perlipc.pod +++ b/pod/perlipc.pod @@ -288,7 +288,7 @@ to find out whether anyone (or anything) has accidentally removed our fifo. sleep 2; # to avoid dup signals } -=head2 Deferred Signals (Safe signals) +=head2 Deferred Signals (Safe Signals) In Perls before Perl 5.7.3 by installing Perl code to deal with signals, you were exposing yourself to danger from two things. First, diff --git a/pod/perlpacktut.pod b/pod/perlpacktut.pod index 80c784b..a88b945 100644 --- a/pod/perlpacktut.pod +++ b/pod/perlpacktut.pod @@ -664,7 +664,7 @@ simply (Note that the template C would only have packed C<$str[0]> in full length.) - + To pack dates stored as triplets ( day, month, year ) in an array C<@dates> into a sequence of byte, byte, short integer we can write