Freimuth,Robert wrote:
> Hi all,
> 
> I'm trying to use POD to document my application.  I have about 5
> different doc files, and I'd like to create links between them when
> they are translated from POD to HTML.  For example, in doc file 1 I'd
> like to say '...using the foo function, as described in <DOC FILE
> 2>...', and have the link open doc file 2.  I read the POD
> documentation, specifically the section on creating links with
> L<...>, but the only examples I can find link to man pages.  I
> couldn't find anything that described creating absolute or relative
> links to other files. 
> 
> I tried a couple of different things, just to see what happened.  I
> specified the base name only, the complete filename, and the full
> path for DOC FILE 2 within the L<...> construct, but I keep getting
> the following error: 
> 
> C:\perl\app1\docs\pod\pod2html_txt.pl: app1_example.pod: cannot
> resolve L<C:\perl\app1\docs\pod\License.html> in paragraph 4. at
> C:/ActivePerl/lib/Pod/Html.pm line 1562.
> 
> In this case, app1_example.pod contains
> 'L<C:\perl\app1\docs\pod\License.html>' and the License.html file is
> in the same directory as app1_example.pod.  (The pod2html_txt.pl
> program simply calls pod2html for me.)

You need to add --htmlroot=. and --podpath=. to your pod2html call.

If the file you want to link to is License.pod, then create your link as
L<License>

If you need to link to an external html file that isn't derived from a .pod
file, you have two choices:

   Absolute link:

      L<http://host/path/to/file.html>

   Relative link:

      =for html <A href="file.html">Text</A>

-- 
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
<http://learn.perl.org/> <http://learn.perl.org/first-response>


Reply via email to