Re: Pod POD pod poD pOd or P.O.D.

Ricardo SIGNES <[email protected]> writes:

> I am not clear on whether this paragraph says or means much:
>
>   Throughout this document, "Pod" has been the preferred spelling for
>   the name of the documentation format. One may also use "POD" or
>   "pod". For the documentation that is (typically) in the Pod format,
>   you may use "pod", or "Pod", or "POD". Understanding these
>   distinctions is useful; but obsessing over how to spell them,
>   usually is not.
>
> So: the format is POD, Pod or pod, but a document is the pod, Pod, or
> POD?

I have always referred to it as POD, and all of my POD utilities and all
of their documentation have always done so as well.  I apparently never
noticed that bit.

> Is it trying to say that all three are always acceptable and not to
> worry about it?

That would be my preference.  Other parts of Perl documentation (such as
perlsyn) use Pod, POD, and pod interchangeably right now.

-- 
Russ Allbery ([email protected])             <http://www.eyrie.org/~eagle/>