Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

perl docs -- I am so sick of...

by 7stud (Deacon)
on Apr 21, 2013 at 07:03 UTC ( #1029724=perlquestion: print w/replies, xml ) Need Help??
7stud has asked for the wisdom of the Perl Monks concerning the following question:

1) Not being able to quickly find the match operator docs. Whoever created the concept of "perl quote like operators" was daft. In the perl docs, there should be one page in the documents titled "Match operator: m//"; there should be another page in the documents titled "Substitution operator: s///"; etc. Grouping all those operators under one vague heading and another vague subheading was a terrible idea. I should be able to go to the match operator with one click on the google search results. Having to navigate to perlop>quote like operators>then scroll around looking for the match operator is ridiculous organization.

Replies are listed 'Best First'.
Re: perl docs -- I am so sick of...
by moritz (Cardinal) on Apr 21, 2013 at 07:16 UTC
Re: perl docs -- I am so sick of...
by LanX (Chancellor) on Apr 21, 2013 at 11:09 UTC
    see Re: Perldoc Keyword Search (update4)

    Usage:

    pd m Matches for m found in : /usr/share/perl/5.10/pod/perlop.pod

    opens all perldocs with searchpattern X<m> in pager, reveals two hits:

    1. hit in perlop
      ">>> X<m> <<<" in perlop Quote and Quote-like Operators While we usually think of quotes as literal values, in Perl the +y function as operators, providing various kinds of interpolating + and pattern matching capabilities. Perl provides customary quote ...

    2. hit in perlop

      ">>> X<m> <<<" in perlop m/PATTERN/msixpogc /PATTERN/msixpogc Searches a string for a pattern match, and in scalar co +ntext returns true if it succeeds, false if it fails. If no +string is specified via the "=~" or "!~" operator, the $_ stri +ng is searched. (The string specified with "=~" need not be +an lvalue--it may be the result of an expression evaluatio +n, but ...

    Cheers Rolf

    ( addicted to the Perl Programming Language)

Re: perl docs -- I am so sick of...
by CountZero (Bishop) on Apr 21, 2013 at 10:56 UTC
    Here is some cheese.

    CountZero

    A program should be light and agile, its subroutines connected like a string of pearls. The spirit and intent of the program should be retained throughout. There should be neither too little or too much, neither needless loops nor useless variables, neither lack of structure nor overwhelming rigidity." - The Tao of Programming, 4.1 - Geoffrey James

    My blog: Imperial Deltronics
Re: perl docs -- I am so sick of...
by Anonymous Monk on Apr 21, 2013 at 07:50 UTC
Re: perl docs -- I am so sick of...
by Anonymous Monk on Apr 21, 2013 at 10:52 UTC

    Have you checked using perldoc -o <file_type> -d <destination_file> ...
    .I use to have an old script written with this that works like 80% - 85% of the time browsing the pod files documentation for information and output as html.
    See below, the following might help:

Re: perl docs -- I am so sick of...
by Anonymous Monk on Apr 21, 2013 at 12:07 UTC
    I should be able to go to the match operator with one click on the IRSE search results

    really?

Re: perl docs -- I am so sick of...
by Anonymous Monk on Apr 22, 2013 at 08:59 UTC

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://1029724]
Approved by Corion
help
Chatterbox?
[LanX]: they?
[LanX]: click!
[choroba]: they
[LanX]: why do you think it's more than one person?
[Your Mother]: Because we are LEGION! Fix YOUR SIG SIG BLOCK!!!!
[Your Mother]: Forgot to sign in as my sockpuppet, how embarrassing!
[1nickt]: pryrt I am creating a Type to check valid user IDs, which must be a whole number greater than or equal to zero. I would like to disallow 1.0 but because of this behaviour, by the time it is checked by the constraint, it *is* an Int.
[LanX]: should this be considered? Re: Parsing .txt into arrays
[LanX]: and this Re^4: Hash user input
[pryrt]: LanX, I would vote "keep" if it were considered: it's not helpful, but it could be taken multiple ways, not all of which are offenseive...

How do I use this? | Other CB clients
Other Users?
Others meditating upon the Monastery: (15)
As of 2017-05-24 20:11 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?