Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

Re: Creating not so plain documentation

by loris (Hermit)
on Jan 09, 2007 at 09:38 UTC ( #593685=note: print w/replies, xml ) Need Help??

in reply to Creating not so plain documentation

Hello punkish,

I am not sure that this will really address any of your concerns and it is a completely different approach, but have you had a look at literate programming? I am no expert, but Literate Programming, simply put, allows the programmer to order code and comments in a way that makes most sense to him or her (rather than to the interpreter or compiler), and to print the resulting program out very prettily. Unfortunately there has not been much development in this area since the early 90s, which was when I discovered and tinkered around with it, although I did find this slightly more recent article, which contains an example using Perl.

HTH or is at least of interest


"It took Loris ten minutes to eat a satsuma . . . twenty minutes to get from one end of his branch to the other . . . and an hour to scratch his bottom. But Slow Loris didn't care. He had a secret . . ." (from "Slow Loris" by Alexis Deacon)
  • Comment on Re: Creating not so plain documentation

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://593685]
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others lurking in the Monastery: (5)
As of 2018-04-27 00:02 GMT
Find Nodes?
    Voting Booth?