drieux, et al -- Hey, is this the sort of thing that should be on the beginners list because it isn't CGI-specific? Do we redirect threads over to the other list as appropriate?
...and then drieux said... % % % On Monday, June 10, 2002, at 05:42 , John Brooking wrote: % % >Well, I confess that I sometimes use POD directives to % >write a long comment (more than about 1/2 dozen ... % ... % b) you may want to think in terms of learning to 'write pod' % it really is a lot simpler in most respects than writing % either man pages or raw html Definitely! Any [other] hints for how to learn it and what's the structure? Believe it or not, The Camel Book only mentions Pod::Text for converting pod to ascii, but I don't have any pod yet... % % c) play with h2xs - it will give you the basic framework for % both a 'perl module' as well as the preliminary POD ! OK; I'll do that, too. Wait a minnit... I don't have a C .h file, so how will this help me? % % One thing I would strongly advocate against - % % running 'code with major chunks of stuff commented out' % % It's fine to do that while sorting out which way to go, as % strictly 'test code' when doing things like CGI development, Agreed; that's how I'm keeping track of where I want to go as I'm hacking out the functionality of a script, but once all of the pieces are written the big chunk has been whittled down to nothing and the problem is solved :-) It seems to me that I could turn that into pod structure as well, which is another reason I'm keen to learn how to write the stuff. % but when you get to that 'lock the source code tree down' - % check in the code you want, and DO NOT have chunkage of dead % code floating around - it WILL BITE YOU - someone will zone *grin* It sure will. % out why this 'ugly' little '=cut' is there... and suddenly % you are off in a new morass chasing code you forgot you % left bloated around. Been there, though not yet in perl (enough other screwups, but not this one!). TIA & HAND :-D -- David T-G * It's easier to fight for one's principles (play) [EMAIL PROTECTED] * than to live up to them. -- fortune cookie (work) [EMAIL PROTECTED] http://www.justpickone.org/davidtg/ Shpx gur Pbzzhavpngvbaf Qrprapl Npg!
msg05308/pgp00000.pgp
Description: PGP signature