Re^2: Unknown tags in documentation

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?

Comment on Re^2: Unknown tags in documentation

Replies are listed 'Best First'.
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]

Replies are listed 'Best First'.

Re^3: Unknown tags in documentation
by LanX (Saint) on Dec 10, 2021 at 22:16 UTC

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]