the the foo manpage

[Tom Christiansen <tchrist@jhereg.perl.com>]

From perlpod.pod:

    L<name>     A link (cross reference) to name
                    L<name>             manual page
                    L<name/ident>       item in manual page
                    L<name/"sec">       section in other manual page
                    L<"sec">            section in this manual page
                                        (the quotes are optional)
                    L</"sec">           ditto
                same as above but only 'text' is used for output.
                (Text can not contain the characters '/' and '|', 
                and should contain matched '<' or '>')
                    L<text|name>
                    L<text|name/ident>
                    L<text|name/"sec">
                    L<text|"sec">
                    L<text|/"sec">

As you know, an L<somepage> link in Pod translates into something with
a leading "the" when run through the pod2{man,text,html} translators.
While agree with your immediate collective retort that this may not
have been the best decision, so it remains.  The L<text|name> etc 
mechanism seems to be away to address this.   (Did all he translators
really pick this up yet?)

This means that the following podpages will end up containing duplicate
"the" instances when expanded.

--tom

pod/perl5005delta.pod:=head2 C<%!> is transparently tied to the L<Errno> module
pod/perlcompile.pod:This module is used by the L<perlcc> program, which compiles a module
pod/perlfaq7.pod:This is explained in more depth in the L<perlsyn>.  Briefly, there's
pod/perlfunc.pod:See the L</use> function, which C<no> is the opposite of.
pod/perllocale.pod:standardization is weak in this area.  See again the L<Finding
pod/perlmod.pod:any qualifications.  See L<Exporter> and the L<perlmodlib> for
lib/Benchmark.pm:FORMAT is the L<printf(3)>-style format specifier (without the
lib/Carp.pm:or by including the string C<MCarp=verbose> in the L<PERL5OPT>
lib/ExtUtils/MakeMaker.pm:all matching files via the L<Test::Harness> module with the C<-I>
lib/ExtUtils/MakeMaker.pm:Please see the L<ExtUtils::Mksymlists> documentation for more information
lib/Pod/Man.pm:    # L<manpage(section)> as we would to manpage(section) without the L<>;
lib/Test/Harness.pm:(By using the L<Test> module, you can write test scripts without
lib/Tie/Array.pm:are briefly defined below. See the L<perltie> section for more detailed
lib/Tie/Hash.pm:are briefly defined below. See the L<perltie> section for more detailed
lib/diagnostics.pm:The B<-verbose> flag first prints out the L<perldiag> introduction before
lib/overload.pm:provide any usual overloaded operators, instead it provides the L<Last
lib/IO/Socket/INET.pm:in the AF_INET domain. It is built upon the L<IO::Socket> interface and
lib/IO/Socket/UNIX.pm:in the AF_UNIX domain. It is built upon the L<IO::Socket> interface and
lib/IO/Socket.pm:is built upon the L<IO::Handle> interface and inherits all the methods defined
lib/Safe.pm:This is almost identical to exporting variables using the L<Exporter(3)>
lib/ops.pm:See the L<Opcode> module for information about opcodes, optags, opmasks

---

[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index][Thread Index][Top&Search][Original]

---