Beefy Boxes and Bandwidth Generously Provided by pair Networks DiBona
more useful options
 
PerlMonks  

So whats new about pod and X<>-tag? How to check current development?

by LanX (Abbot)
on Feb 02, 2012 at 16:53 UTC ( #951485=perlquestion: print w/ replies, xml ) Need Help??
LanX has asked for the wisdom of the Perl Monks concerning the following question:

Hi

2 1/2 years ago we where talking about perldoc not support searching for keywords identified by the X<...> tag.

see [perldoc] keyword search

Whats the appropriate way to check if anything happened meanwhile or action is still needed?

Parsing the newest perldelta on cpan or perldoc.org?

(BTW this has nothing todo with the unsupported perldoc -X option and pod.idx ?).

Any insights?

To have an idea what I'm talking about (and as a workaround) please try this to find all documentation regarding qr

> grep -B2 -A5 -h 'X<qr>' /usr/share/perl/5.10/pod/*.pod =head2 Quote and Quote-like Operators X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>> X<escape sequence> X<escape> While we usually think of quotes as literal values, in Perl they function as operators, providing various kinds of interpolating and -- =item qr/STRING/msixpo X<qr> X</i> X</m> X</o> X</s> X</x> X</p> This operator quotes (and possibly compiles) its I<STRING> as a regula +r expression. I<STRING> is interpolated the same way as I<PATTERN> in C<m/PATTERN/>. If "'" is used as the delimiter, no interpolation is done. Returns a Perl value which may be used instead of the -- =item Quote and Quote-like Operators X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>> X<escape sequence> X<escape> =item Regexp Quote-Like Operators X<operator, regexp> qr/STRING/msixpo X<qr> X</i> X</m> X</o> X</s> X</x> X</p>, m/PATTERN/msixpogc X<m> X<operator, match> X<regexp, options> X<regexp +> X<regex, options> X<regex> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X +</c>, /PATTERN/msixpogc, ?PATTERN? X<?>, s/PATTERN/REPLACEMENT/msixpogce X<substitute> X<substitution> X<replace> X<regexp, replace> X<regexp, substitute> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c> X</e>
The hits are in perlop and perltoc

Cheers Rolf

Comment on So whats new about pod and X<>-tag? How to check current development?
Select or Download Code
Re: So whats new about pod and X<>-tag? How to check current development?
by Anonymous Monk on Feb 02, 2012 at 17:03 UTC
        Well I was looking for a command-line solution, which could also work within the debugger...

        And after investigating Pod::Man I discovered that the X-tags (and more) ARE actually (almost correctly) exported to man's *roff- format.

        lanx@nc10-ubuntu:/tmp$ grep 'X<qr>' perlop.pod X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>> X<qr> X</i> X</m> X</o> X</s> X</x> X</p>

        lanx@nc10-ubuntu:/tmp$ grep 'Xref' perlop.man |grep qr .IX Xref "operator, quote operator, quote-like q qq qx qw m qr s tr ' +'' "" """" ` `` << escape sequence escape" .IX Xref "qr i m o s x p"

        So it's more a question about finding an appropriate viewer/pager to be able to jump into the correct line.

        Identifying the file is no big deal...

        Cheers Rolf

Re: So whats new about pod and X<>-tag? How to check current development?
by JavaFan (Canon) on Feb 02, 2012 at 17:57 UTC
    Whats the appropriate way to check if anything happened meanwhile or action is still needed?
    $ git clone git://perl5.git.perl.org/perl.git perl
    Alternatively, download the monthly development releases.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://951485]
Approved by Old_Gray_Bear
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others surveying the Monastery: (8)
As of 2014-04-17 08:28 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    April first is:







    Results (441 votes), past polls