Re: Unknown tags in documentation

it's documented in perlpod

> When reading documentation on metacpan.org, I frequently see stuff like this:

Documentation on metacpan.org is usually HTML not raw POD, you must walk detours to see that.

Cheers Rolf
_{(addicted to the Perl Programming Language :)

Wikisyntax for the Monastery}

Comment on Re: Unknown tags in documentation Select or Download Code

Replies are listed 'Best First'.
Re^2: Unknown tags in documentation by NERDVANA (Priest) on Dec 10, 2021 at 21:07 UTC
The code snippets show perl comments, not pod. Maybe the answer here is that some authors get so used to pod formatting that they include it in their regular comments as well, or maybe in comments within the POD code blocks as an accidental side effect of search/replace?	[reply]
Re^3: Unknown tags in documentation by LanX (Saint) on Dec 10, 2021 at 22:16 UTC
Good point, I intuitively assumed the OP added the # on his own. But - as so often - it would be best if he gave us a link to where he "frequently saw stuff like" that. Better than us speculating... BTW: another option could be that the author is post processing the comments to generate POD and/or other docs. The examples given look a lot like API docs, like the ones shown in IDE pop-ups. But that's aforementioned speculation and I doubt this is "frequently seen" ... Cheers Rolf _{(addicted to the Perl Programming Language :) Wikisyntax for the Monastery}	[reply]