At 21:13 Uhr -0700 06.10.2002, Richard Cook wrote:
>I have the POD reader "Shuck" 1.6.2 (the one included with MacPerl
>5.6.1r1). This is the latest, no? Who gets the Shuck bug reports?
>
>Ronald J Kimball wrote:
>>
>> On Sun, Oct 06, 2002 at 08:52:21PM -0700, Richard Cook wrote:
>> > There seem to be 4? typo's in the `open FILEHANDLE' section of
>>`perlfunc.pod':
>> >
>> > # If MODE is < '<' > or nothing, the file is opened for input.
>> > # If MODE is < '' >>, the file is truncated and opened for
>> > ^^^^^^^
>> > # output, being created if necessary. If MODE is << '>' >>>,
>> > ^^^^^^^^^^
>> > # the file is opened for appending, again being created if
>> > # necessary. You can put a '+' in front of the < '' >> or
>> > ^^^^^^^
>> > # < '<' > to indicate that you want both read and write access
>> > # to the file; thus < '+<' > is almost always preferred for read/
>> > # write updates--the < '+' >> mode would clobber the file
>> > ^^^^^^^^
>>
>> This is a failure of your POD reader to properly parse the new syntax for
>> the C<> tag, which allows the use of multiple enclosing angle brackets,
>> e.g.:
>>
>> C<< '<' >>
>> C<< '>' >>
>> C<< '+<' >>
>>
>> Make sure you have the latest version of your POD reader. If so, report
>> this as a bug in your POD reader rather than in the documentation.
>>
>> Ronald
This is indeed a bug (or lack of support of multiple angle brackets
in formatting codes) in Shuck up to and including version 1.6.2.
Recently, I have released a preview version of Shuck 1.7.0, which
solves this bug and will be part of the MacPerl 5.6.1r2 distribution
(to be released really soon now ? ;-). Until then, you can download
Shuck 1.7.0 from my website at
http://usemacperl.esmartweb.com/index.html
Bugs in Shuck can be reported to the Shuck project pages on SourceForge.net
http://sourceforge.net/tracker/?group_id=22953&atid=376986
and/or to the MacPerl Porters list (<[EMAIL PROTECTED]>)
and/or to me directly (since I am currently the maintainer).
Regards,
Thomas.
