Re: Pod::Html's cross referencing of C links
* Marc Green pongu...@gmail.com [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. -- rjbs
Re: Pod::Html's cross referencing of C links
On 05/20/2011 03:16 PM, Ricardo Signes wrote: * Marc Greenpongu...@gmail.com [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.
Re: Pod::Html's cross referencing of C links
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. I do not think it would be a typo for it is repeated in several cases (unless it was a typo in a find/replace all, I suppose). Whatever the reason, could you rephrase your last sentence? I feel that it will shed some light on something I am not grasping, but currently it is rather difficult to understand.