Beefy Boxes and Bandwidth Generously Provided by pair Networks
Think about Loose Coupling
 
PerlMonks  

Re: Debug code out of production systems

by PodMaster (Abbot)
on Jan 24, 2004 at 22:54 UTC ( #323885=note: print w/ replies, xml ) Need Help??


in reply to Debug code out of production systems

Why stake claim to all =begin UPPERCASE? I don't like that. You should pick 1 and stick with it (=begin begin sounds good).

MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
** The third rule of perl club is a statement of fact: pod is sexy.


Comment on Re: Debug code out of production systems
Re: Re: Debug code out of production systems
by liz (Monsignor) on Jan 24, 2004 at 23:12 UTC
    Why stake claim to all =begin UPPERCASE?

    Hmmm... good question. To my knowledge there are no pod parsers that use uppercase names. I want to prevent a pod parser by accident adding debug code to the documentation of a module.

    Uppercase letters stand out. So in that sense you could say I'm staking this claim, but only visually!

    Please note that you can use uppercase names for your own pod parsers. You just can't activate it with begin then, because you'll most likely get compile errors because your documentation inside that =begin section will most likely not be intended to be executed.

    You should pick 1 and stick with it (=begin begin sounds good).

    As a developer, I want to be free in the choosing of my names. You might want to use DEBUGGING for real debug code, and VERBOSE for just making your script a bit more verbose than usual. Or FOO for some temporary stuff.

    You should note that the =debug sections are parsed for all modules once "begin" is loaded. Activating DEBUGGING will activate all of the =begin DEBUGGING pod sections of all modules. So I'm actually thinking of adding some namespace support for it, e.g:

    perl -MBEGIN=forks::TRACE myscriptusingforks.pl
    would only activate the =begin sections inside the forks.pm module, whereas:
    perl -MBEGIN=TRACE myscriptusingforks.pl
    currently activates all modules that have a =begin TRACE pod section.

    Liz

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (4)
As of 2014-10-21 00:50 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    For retirement, I am banking on:










    Results (94 votes), past polls