Re: Notebooks, packages, cells, and literate programming
- To: mathgroup at smc.vnet.net
- Subject: [mg64240] Re: Notebooks, packages, cells, and literate programming
- From: "Mark Adler" <madler at alumni.caltech.edu>
- Date: Tue, 7 Feb 2006 03:36:26 -0500 (EST)
- References: <ds4hr2$61t$1@smc.vnet.net>
- Sender: owner-wri-mathgroup at wolfram.com
David, Thank you for the long and thoughtful response. David Park wrote: > I think the short answer to your question is no, there is not a way of > splitting a Module, Block or With between cells. Darn. That's what I thought. > I would not put many test cases and documentation of the use of a routine > into the package notebook. If you do a lot of this, the package notebook > will end up being quite long and cluttered. Generally, the package notebook > is not seen by the user and, in any case, is not a convenient source of > usage information. Actually what I'm requesting is not for the user. It's for me! I need that stuff so that when I go back and look at the notebook, I'll know what in the heck I was thinking. The usage of the package is actually very simple, and adequately documented in the ::usage string. Anyway, the best I can figure to satisfy my needs is to simply provide a broken-up example of the procedures in action in individual expressions in the notebook, with interspersed documentation, and then at the end of the notebook, all of those combined into a form suitable for a package. That introduces the possibility of errors in copy and paste, and no automatic way to check for equivalency, but oh well. It's better than nothing. Thank you again for your help. mark