MathGroup Archive 2006

[Date Index] [Thread Index] [Author Index]

Search the Archive

Re: Notebooks, packages, cells, and literate programming

  • To: mathgroup at
  • Subject: [mg64240] Re: Notebooks, packages, cells, and literate programming
  • From: "Mark Adler" <madler at>
  • Date: Tue, 7 Feb 2006 03:36:26 -0500 (EST)
  • References: <ds4hr2$61t$>
  • Sender: owner-wri-mathgroup at


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.


  • Prev by Date: Re: creating packages of my own.
  • Next by Date: Re: MeijerG evaluates an imaginary part, which does not exist
  • Previous by thread: RE: Notebooks, packages, cells, and literate programming
  • Next by thread: Re: Re: Notebooks, packages, cells, and literate programming