http://qs321.pair.com?node_id=579487


in reply to Re: POD L<> and relative links?
in thread POD L<> and relative links?

Understand the =begin =end =for and friend, just seems like using the L<> would be a little cleaner. For example, I could put the link inline of the paragraph I'm writing in, without having a new paragraph and it would work, wherever you're viewing the POD.

Pity I can't just say in L<>, "hey this is a relative URL, and it doesn't have to turn into anything - just trust me". Seems like that's within Perl culture of Do What I Mean.

I usually make two sets of docs - one that comes with the distribution, and anything that goes on the support site.

 

-justin simoni
skazat me

Replies are listed 'Best First'.
Re^3: POD L<> and relative links?
by Joost (Canon) on Oct 20, 2006 at 00:03 UTC
    The thing is, you're writing POD, not HTML. POD does not really have a concept of relative links, it just has "links". The pod translator has to figure out how to link stuff, and it can do that by making (relative) urls for HTML, creating hyperlinks in for info files or just displaying the raw text. Full URLs in links are useful because they will work more or less anywhere, independent of the location of the POD or generated file. Relative links depend on the eventual location of the generated file, which is not known in general. Ofcourse, you can always write your own pod2html tranlator if you do know.

    "What should it profit a man, if he should win a flame war, yet lose his cool?"
[reply]

      I'm beginning to understand you're view :) Thanks for being patient with me.

      It's a pity though, since I do generate HTML documents from the POD that's scattered all through the program, and distribute this documentation with the program itself.

      Oh well. The, "Make your own translator" doesn't seem too big of a challenge as brian points out (Rolls up sleeves...)

       

      -justin simoni
      skazat me

[reply]

In Section Seekers of Perl Wisdom