Re: [literate programming] How to mix POD with code? And how to fold this?

"Perl code + POD" != "Literate programming". It's a misconception common enough to gets its own mentioning in the Wikipedia page about literate programming.

POD just allows you to put documentation close to code - but normal comments allow you to do that as well. Literate programming is when documentation replaces (parts of) code, and defines the control flow; a preprocessor assembles bit and pieces of code found in documentation into a program. POD doesn't do that.

Comment on Re: [literate programming] How to mix POD with code? And how to fold this?

Replies are listed 'Best First'.
Re^2: [literate programming] How to mix POD with code? And how to fold this? by LanX (Saint) on May 04, 2010 at 14:32 UTC
sure, I read MJDs article on perl.com ... more than once. But ATM I don't need to go the full way, as I said POD more DRY and encapsulated. Cheers Rolf	[reply]