On Tue, Feb 22, 2000 at 11:20:05AM -0800, Larry Wall wrote:
> Brad Appleton writes:
> : On Tue, Feb 22, 2000 at 11:30:25AM -0700, Tom Christiansen wrote:
> : > I see that the new C<< ... >> syntax isn't documented in perlpod
> : > yet. Maybe it's not even implemented in the various parsers
> : > and translators.
> :
> : I've been waiting to hear whether or not its supposed to go into 5.6.
>
> Let's push this one through. We're finding it very useful on the Camel III
> already. Thanks!
Okay - I just finished uploading the official (non-beta) version
of PodParser-1.093 to CPAN. I also placed a copy of it at:
ftp://ftp.enteract.com/users/bradapp/src/libs/Perl/PodParser-1.093.tar.gz
As I mentioned, this implements the C<< ... >> syntax in Pod::Parser,
where pod2text and pod2man will be able to instantly benefit from
it. Until pod2html uses Pod::Parser, this behavior would have to be
implemented in pod2html by hand (this of course is also true for any
other pod2xxx that doesn't use Pod::Parser or one of its derivatives).
Here again (after my signature) is the patch for perlpod.pod. Let me
know if you need anything else!!!
--
Brad Appleton <[EMAIL PROTECTED]> http://www.enteract.com/~bradapp/
"And miles to go before I sleep." -- Robert Frost
*** perlpod.pod.orig Thu Feb 3 16:10:32 2000
--- perlpod.pod Sat Feb 5 17:58:57 2000
***************
*** 188,193 ****
--- 188,228 ----
E<html> Some non-numeric HTML entity, such
as E<Agrave>
+ Most of the time, you will only need a single set of angle brackets to
+ delimit the beginning and end of interior sequences. However, sometimes
+ you will want to put a right angle bracket (or greater-than sign '>')
+ inside of a sequence. This is particularly common when using a sequence
+ to provide a different font-type for a snippet of code. As with all
+ things in Perl, there is more than one way to do it. One way is to
+ simply escape the closing bracket using an C<E> sequence:
+
+ C<$a E<lt>=E<gt> $b>
+
+ This will produce: "C<$a E<lt>=E<gt> $b>"
+
+ A more readable, and perhaps more "plain" way is to use an alternate set of
+ delimiters that doesn't require a ">" to be escaped. As of perl5.5.641,
+ doubled angle brackets ("<<" and ">>") may be used I<if and only if there
+ is whitespace immediately following the opening delimiter and immediately
+ preceding the closing delimiter!> For example, the following will do the
+ trick:
+
+ C<< $a <=> $b >>
+
+ In fact, you can use as many repeated angle-brackets as you like so
+ long as you have the same number of them in the opening and closing
+ delimiters, and make sure that whitespace immediately follows the last
+ '<' of the opening delimiter, and immediately precedes the first '>' of
+ the closing delimiter. So the following will also work:
+
+ C<<< $a <=> $b >>>
+ C<<<< $a <=> $b >>>>
+
+ This is currently supported by pod2text (Pod::Text), pod2man (Pod::Man),
+ and any other pod2xxx and Pod::Xxxx translator that uses Pod::Parser
+ 1.093 or later.
+
+
=head2 The Intent
That's it. The intent is simplicity, not power. I wanted paragraphs
