Hello,
I think that a possibility to add a label without associating it to
actual text is missing from the Pod language (unless I missed something).
Indeed labels are either associated with =item or =head*. I think that
it is unfortunate, as one may want to use a reference name different from
the output text. This happens, for example in perlfunc.pod where there
is
=item open FILEHANDLE,EXPR
=item open FILEHANDLE,MODE,EXPR
=item open FILEHANDLE,MODE,EXPR,LIST
...
It would be nice to be able to have a label called open which would not
need to appear in the output. It even appears to me to be a kind of
limitation/inconsistency of the language because it may force to write
suboptimal documents for the sake of being able to do references.
It could be along
=anchor open
if it is a Command Paragraph, or A<open> if it is a formatting command.
Then it would be translated to <a name="..."></a> in html, <anchor ..>
in docbook, \label{..} in LaTeX, @anchor{..} in texinfo...
Note: I am not sure this is the place to ask for changes in Pod, but it
seems to be a good place for that.
--
Pat
