<?xml version="1.0" encoding="windows-1252"?>
<node id="252508" title="Re: Re: POD in 5 minutes" created="2003-04-23 06:37:38" updated="2005-07-19 21:59:32">
<type id="11">
note</type>
<author id="132236">
Juerd</author>
<data>
<field name="doctext">
&lt;p&gt;&lt;blockquote&gt;&lt;em&gt;
One comment: there is one section I woudl like to see expanded: links. I know it always takes me a while to figure out how to link to somewhere else in the file, outside of the file, what I am allowed to link to etc... and half of the time I get it wrong.
&lt;/em&gt;&lt;/blockquote&gt;&lt;/p&gt;

&lt;p&gt;
pod2html would break every promise I make, so here's my practical guide to linking in pod:
&lt;/p&gt;
&lt;p&gt;
&lt;ul&gt;
&lt;li&gt;Linking to URLs: Just put the URL in there and make sure it's followed by whitespace to avoid having too much interpunction in the link itself.
&lt;li&gt;Linking to e-mail addresses: Why? Want spam or something? Just put the address in there and it'll probably get linked - and harvested.
&lt;li&gt;Linking within the same document: pod2html will try to do this automatically.
&lt;li&gt;Linking to other documents: &lt;code&gt;L&lt;perlfoo&gt;&lt;/code&gt;
&lt;/ul&gt;
&lt;/p&gt;
&lt;p&gt;
I use explicit links only in SEE ALSO.
&lt;/p&gt;
&lt;p&gt;
But I think only TorgoX really knows what is and what is not allowed.
&lt;/p&gt;
&lt;/p&gt;
&lt;p&gt;&lt;font color="#800000"&gt;&lt;pre&gt;
Juerd
- &lt;a href="http://juerd.nl/" target="_blank"&gt;&lt;font color="#800000"&gt;http://juerd.nl/&lt;/font&gt;&lt;/a&gt;
- &lt;a href="mailto:spamcollector_perlmonks@juerd.nl" target="_blank"&gt;&lt;font color="#800000"&gt;spamcollector_perlmonks@juerd.nl&lt;/font&gt;&lt;/a&gt; (do not use).
&lt;/pre&gt;&lt;/font&gt;&lt;/p&gt;</field>
<field name="root_node">
252477</field>
<field name="parent_node">
252506</field>
</data>
</node>
