On Apr 13, 2010, at 11:54 AM, Graham Barr wrote:

>> Should that not use the entire header for the location name? Something like 
>> #Yada_Yada_Operator_operator_yada_yada_operator?
> 
> no. The content of the X< > in not visible to the end user so using it to 
> generate the anchor would be confusing IMO

Makes sense to me.

>> Ah. Then this change needs to be made to Pod::Simple, too.
> 
> Pod::Simple currently generates an anchor of #Yada_Yada_Operator___
> 
> I think what needs to happen is that the spaces around the X<> need to be 
> removed, or maybe section_name_tidy just needs to remove trailing _'s

Yes, perhaps removing trailing whitespace as Jan suggested. I'll file a bug 
report.

>> pod-people, does it make sense to allow headers to be on more than one line, 
>> e.g.,
>> 
>>   =head2 Yada Yada Operator
>>   X<...> X<... operator> X<yada yada operator>
> 
> POD is paragraph based so that whole paragraph is the head2, I do not think 
> we could (or should) go changing that now.

Great.

Best,

David


Reply via email to