Re: Pod::Html's cross referencing of C<> links

On 05/20/2011 03:16 PM, Ricardo Signes wrote:
> * Marc Green<[email protected]>  [2011-05-20T16:24:21]
>> links. More specifically, I understand how it resolves L<>  links, but I am
>> confused as to why you resolve C<>  "links". From reading the source, I
>> gather that C<>  "links" are resolved by searching pod documents for =item
>> directives, and storing their text in a global hash.
>
> Marc is referring to comments like this:
>
> my %Pages = ();                 # associative array used to find the location
>                                  #   of pages referenced by L<>  links.
> my %Items = ();                 # associative array used to find the location
>                                  #   of =item directives referenced by C<>
>                                  #   links
>
> ...
>
> # scan_items - scans the pod specified by $pod for =item directives.  we
> #  will use this information later on in resolving C<>  links.
>
> &c.
>

My guess is that it's just plain wrong, so no wonder it's confusing. 
Perhaps it's reflecting an early design, or perhaps it's just a typo, 
and L was meant instead of C.  L<> can link to =items provided they are 
of a type that permits that.  Currently, the only ones that are are ones 
that are in what html calls definition lists, at least in Pod::Html.