develooper Front page | perl.perl6.users | Postings from January 2019

Re: POD: linking to a module

Thread Previous | Thread Next
Ralph Mellor
January 16, 2019 21:41
Re: POD: linking to a module
Message ID:
Hi JJ,
Wouldn't it be useful if Vadim commented on an appropriate GH issue?
If so, which would that be? ? ? ?
Somewhere else?


On Mon, Jan 14, 2019 at 1:07 AM Vadim Belman <> wrote:

>> Not to mention different module versions, on top of what you wrote.
>> Ok, I would think about it. One thing comes to my mind: in Synopsis 26 (
>> there is a mention of =config
>> directive. It can be used to define where the links must point to.
>> Something like:
>> =config github:/user/module/tree/master/docs
> I'm not sure =config is implemented right now, my money is on NYI. And
> still there's the problem that pod6 or pod-embedded-in-Perl6 is not
> rendered anywhere, I think, not even in Dumping
> someone in a page full of Pod6 source code is LTA. I mean, you can as well
> create a link to actual, rendered documents that you have generated
> somewhere.
> I know it is not implemented, but it might be at some point. So, perhaps
> it makes sense to think out a possible solution?
> As to the format issue – I for myself solved it for now by generating both
> .md and .html and writing a script which patches source PODs to point links
> at the right version tag on github. Perhaps, this will be the best approach
> for a couple of years to come.
> Best regards,
> Vadim Belman

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About