Beefy Boxes and Bandwidth Generously Provided by pair Networks
good chemistry is complicated,
and a little bit messy -LW
 
PerlMonks  

Explaining source code

by szabgab (Priest)
on Dec 11, 2008 at 22:21 UTC ( [id://729790]=note: print w/replies, xml ) Need Help??


in reply to Deriving meaning from source code, some code is self documenting

I am not sure how close this is to what I wanted, but I'd like to a feature to Padre so when and expression is selected in a Perl document the user can bring up a pop-up explaining what that expression means.

I am mostly aiming at beginners or people with little experience who need to maintain funky code.

So if you plans have some overlap it would be great to see this added to Padre.

Replies are listed 'Best First'.
Re: Explaining source code
by submersible_toaster (Chaplain) on Dec 13, 2008 at 02:33 UTC

    Possibly, if the idioms you're looking to explain can be expressed by pulling apart sequences of PPI tokens, the scope would be just as broad.The Schwartzian Transform for example could be matched. Do you have some examples for be me think about?

    I keep meaning to take a deeper look at Padre, which appears to be moving a at great pace. Were Padre to have a POD panel alongside editor,fs tree, etc - macropod could be used there as already described


    I can't believe it's not psellchecked
      for a starter I'd like to be able to recognize and explain thing such as $_, $_[0], $a, but of course expanding bigger expressions would be also cool.

      What is $x ||= 42; ?

      Think about beginners, or people with little experience who are thrown in to maintain a nasty code base.

      Think about people for whom Perl is only a 3rd or 4th level tool that they hardly know, hardly use but want to fix some code.

      I am sure we'll work out the details on the Padre mailing list or IRC channel.

        Without meaning to be rude , what are the chances a perl beginner ever escapes from their editor of choice? I had a bash w/ Padre on ubuntu 8.04 this weekend and stopped at the instruction to 'remove all Wx 2.6 from your system' - Not likely!


        I can't believe it's not psellchecked

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://729790]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others meditating upon the Monastery: (6)
As of 2024-04-16 08:21 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found