From: Gurusamy Sarathy Date: Tue, 22 Feb 2000 19:51:13 +0000 (+0000) Subject: describe C<< ... >> in perlpod.pod (from Brad Appleton) X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5455df32d1cbb1b01b3af0f9b4f432fefbd8efb7;p=p5sagit%2Fp5-mst-13.2.git describe C<< ... >> in perlpod.pod (from Brad Appleton) p4raw-id: //depot/perl@5210 --- diff --git a/pod/perlpod.pod b/pod/perlpod.pod index 731a0fb..0997c71 100644 --- a/pod/perlpod.pod +++ b/pod/perlpod.pod @@ -188,6 +188,41 @@ here and in commands: E Some non-numeric HTML entity, such as E +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 sequence: + + C<$a E=E $b> + +This will produce: "C<$a E=E $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.660, +doubled angle brackets ("<<" and ">>") may be used I 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