an 'anchor' command is missing from Pod

[email protected] (Patrice Dumas)
Newsgroups perl.pod-people
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.