Re: [MacPerl-Porters] shuck duplicating output

On Thu, Nov 29, 2001 at 04:41:10PM -0500, Scott R. Godin wrote:
> should Shuck be producing things like this: 
> 
> Dig into a bunch of modules to see how they're written. I'd suggest 
> starting with in the Text::Tabs|Text::Tabs manpage, since it's in the 
> standard library and is nice and simple, and then looking at something 
> like in the Time::Zone|Time::Zone manpage, in the File::Copy|File::Copy 
> manpage and then some of the Mail::* modules if you're planning on 
> writing object oriented code.
> 
> from pod code like this:
> 
> Dig into a bunch of modules to see how they're written. I'd suggest
> starting with L<Text::Tabs|Text::Tabs>, since it's in the standard
> library and is nice and simple, and then looking at something like
> L<Time::Zone|Time::Zone>, L<File::Copy|File::Copy> and then some of the
> C<Mail::*> modules if you're planning on writing object oriented code.
> 
> I'm still unsure why they are listed in there that way, with the | 
> separating two copies of the same thing.

Because the specification for L<> is so stupid.  L<foo> renders as "the foo
manpage"; L<foo|foo> renders as "foo".  At least, that's how it's supposed
to work.  Shuck apparently doesn't understand the L<text|name> case.

(In the new POD specification L<foo> will render as "foo".)

Ronald