3 ms·

Knuth's "Literate Programming"???? NO WAY!!! Not a chance!! I won't mention that one!!!! It appears that all the overt, happy, productive literate programmi

Knuth's "Literate Programming"???? NO WAY!!! Not a chance!! I won't mention that one!!!! It appears that all the overt, happy, productive literate programming people get banished to, to where, to, maybe, Antarctica, under one of the ice sheets, naw, the back side of the Moon!!! E.g., for a sample of just 1, the little piece of code I'm working on now, just had my favorite text editor KEDIT count, has (hush, secret) 387 lines of comments in a file of 840 lines. And one of my worst transgressions of solid, world-wide norms, I have no undefined technical terms or acronyms. And for this code, I have an external document on the architecture -- for that transgression, could be sent to Pluto???

WillAdams 2y ago
I wish that I was a better programmer, so could be a better advocate for this programming style. I wish that there were more standard tools for it --- it kills me that I couldn't find a nice .layout for doing Literate Programming in LyX w/ arbitrary programming languages. I'm just glad that my using this system lets me overcome hurdles/complexity beyond levels which previously posed insurmountable stumbling blocks --- at a previous job there was a typesetting back-end for phone book ads which I had written in LaTeX using a documented TeX file (.dtx) --- once a year or so they would sell a license to a new customer and I would have to update it to their needs, and every quarter or so there would be a bug report... being able to read through the code would quickly get me in a place where I could fix things and then move on to the next task. Current effort is at: https://github.com/WillAdams/gcodepreview https://github.com/WillAdams/gcodepreview At some point in time I need to look into if using Lua would allow some niceties such as per-file line # tracking...
metaed 2y ago
The answer to "where" is <news:comp.programming.literate> and <https://www.reddit.com/r/LitProg/ https://www.reddit.com/r/LitProg/>.

WillAdams 2y ago

I wish that I was a better programmer, so could be a better advocate for this programming style. I wish that there were more standard tools for it --- it kills me that I couldn't find a nice .layout for doing Literate Programming in LyX w/ arbitrary programming languages. I'm just glad that my using this system lets me overcome hurdles/complexity beyond levels which previously posed insurmountable stumbling blocks --- at a previous job there was a typesetting back-end for phone book ads which I had written in LaTeX using a documented TeX file (.dtx) --- once a year or so they would sell a license to a new customer and I would have to update it to their needs, and every quarter or so there would be a bug report... being able to read through the code would quickly get me in a place where I could fix things and then move on to the next task. Current effort is at: https://github.com/WillAdams/gcodepreview https://github.com/WillAdams/gcodepreview At some point in time I need to look into if using Lua would allow some niceties such as per-file line # tracking...

metaed 2y ago

The answer to "where" is <news:comp.programming.literate> and <https://www.reddit.com/r/LitProg/ https://www.reddit.com/r/LitProg/>.