Beefy Boxes and Bandwidth Generously Provided by pair Networks
Problems? Is your data what you think it is?
 
PerlMonks  

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

loris


"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?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others lurking in the Monastery: (20)
As of 2014-07-11 16:01 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    When choosing user names for websites, I prefer to use:








    Results (231 votes), past polls