[Date Index] [Thread Index] [Author Index]
Notebooks, packages, cells, and literate programming
So I have a notebook that documents a package, the latter being automatically saved from the initialization cells. (When that works anyway.) All well and good, especially since it permits a literate programming style, by which I mean detailed comments, example, illustrations, etc. as desired between and among the actual package cells. The comments (cmd-7 text) are visually distinctive and compact. The examples can be run by the user to see what the code fragment does, but is not part of the package. That all works unless I have a definition of, say, a block with many lines, then I cannot split those cells and have them work in the notebook. I'd like to intersperse comment and other sorts of illustrative cells in and among the lines of the block. I'd like to never use the horrible (* *) comments in the block. So is there a way to break up an expression among multiple cells in a notebook and have the cells still work (if executed in the proper order)? mark p.s. The answer is not "use smaller blocks". I want comments between individual lines of already small blocks.