in reply to I'm confused because perl is confused with POD

As far as I understood the documentation, I should be able to inline POD everywhere outside here-documents.

What part of the documentation suggests that? It would need fixing, it seems.

To the best of my knowledge POD is only allowed between statements, not everywhere.

Update: perlsyn says

Perl has a mechanism for intermixing documentation with source code. While it’s expecting the beginning of a new statement, if the compiler encounters a line that begins with an equal sign and a word, like this

which pretty much confirms my knowledge

  • Comment on Re: I'm confused because perl is confused with POD

Replies are listed 'Best First'.
Re^2: I'm confused because perl is confused with POD
by afoken (Chancellor) on Jun 30, 2009 at 21:22 UTC

    Thanks! That was the documentation I searched for.

    Alexander

    --
    Today I will gladly share my knowledge and experience, for there are no sweeter words than "I told you so". ;-)