22
Iteration in Literate Programming (gracefulliberty.com)
submitted 3 months ago by to c/programming@programming.dev
7 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[–] 5 points 3 months ago* (last edited 2 months ago) (4 children)

I'm a bit confused here. I've used literate programming a lot, and used cweave and ctangle to create C and TeX sources from a single source file. Any iteration is done on the single original source, never on the intermediate C or TeX sources. Where does OP get into dissossiations between code source and document source?

  • permalink
  • fedilink
  • source
  • hideshow 4 child comments
    •
  • [–] 3 points 3 months ago (2 children)

    When you make changes to the comments or pseudo code to maintain the program, then you also need to do the same changes to the actual source code the compiler will use. As the human language comments need to be compiled to C by human, right? And this would end up thinking and maintaining the source code of two languages and hope they always align in their logic.

    I never did this approach and only get this from reading the blog post.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [–] 2 points 3 months ago

    The very idea of weave and tangle is that comment and code is (nearly) one. Just updating one makes no sense.

    TeX and MetaFont are written in such a system, and you can read the TeX'ed source like a book.

  • permalink
  • fedilink
  • source
  • parent
  • [–] 2 points 3 months ago

    The way I've used it is more that the text gives an explanation and a structure regardless of what the framework requires. It's not the exact algorithm per se but it could if it'd ver very complex for some reason. It ends up reading like a book with code snippets in it which turns out to run the application.

    I also generally edited the code directly and indirectly and then detangled or tangled such that the files were in sync.

  • permalink
  • fedilink
  • source
  • parent