Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot
 
PerlMonks  

Re^4: Deriving meaning from source code, some code is self documenting

by Mutant (Priest)
on Dec 09, 2008 at 17:40 UTC ( #729217=note: print w/replies, xml ) Need Help??


in reply to Re^3: Deriving meaning from source code, some code is self documenting
in thread Deriving meaning from source code, some code is self documenting

True, but you might be able to get *something* from the variable names. e.g.
sub foo { my ($needle, @haystack) = @_; ... }
Having those available might be useful (of course you can read the source as well, but you might want to see that from a different module).
  • Comment on Re^4: Deriving meaning from source code, some code is self documenting
  • Download Code

Replies are listed 'Best First'.
Re^5: Deriving meaning from source code, some code is self documenting
by DStaal (Chaplain) on Dec 09, 2008 at 18:00 UTC

    Might. It's on the slope of diminishing returns, though. (And the numbers of different ways to get variables out of the arg array is huge.)

    Parent classes and dependencies are machine-document able, fairly easily. They are conceptually similar. And documenting them for a human is usually copy-paste-format in my experience. Trying to automatically document functions may be useful, but it wouldn't be something I'd want to run with the dependency tree. (Which I would want to run on every module I've ever written: It'd make my life simpler.) Functions I'd rather do by hand, usually.

    (I guess I'm looking at this as a way to document my code, not code someone else has written that I want to use.)

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://729217]
help
Chatterbox?
and !@monks...

How do I use this? | Other CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (3)
As of 2016-12-04 03:08 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    On a regular basis, I'm most likely to spy upon:













    Results (61 votes). Check out past polls.