[eterevsky]

I tried reading some literate code, and I have troubles understanding it, compared to well structured normal code with moderate amount of comments.

Sometimes when you are writing an article it may make sense to write LP-like snippets of code like

    int my_function() {
      // Initialize variables
      return 0;
    }

but you don't really need to invent the whole "literate programming" concept to do this and you don't need to write all of your code like that.