Documenting how to use a Pbsfile is most often used to help the user find out which targets are defined and how to invokethe PBS command line utility (pbs).
The output is filtered through pod2text for your convenience.

Extracting the POD:

pbs --pbsfile_pod
pbs --pp

Pbsfile pod start withB=for PBS followed by a =head tag. It ends when PBS either finds:

a =head tag of a higher level

=for PBS STOP is found.

You can interleave Pbsfile documentation and structural documentation if you so wish.