[Rd] Flat documentation?
Fri Dec 13 00:54:03 2002
At 01:37 PM 12/12/2002 -0400, kjetil halvorsen wrote:
>Duncan Murdoch wrote:
> > Storage isn't a problem, I'm thinking of the user interface. I
> > normally write my functions in a text editor, then source them into R.
> > Other people use a workspace as the primary place to store functions.
> > Both methods should allow for easy addition of lightweight
> > documentation.
>When functions are stored in workspaces, and options keep.source=FALSE
>are used, it will not work to write the documentation as comments in the
>function. So attributes seems preferable, if one goes for
It occurs to me that this behaviour could be modified so that comments at
the beginning of a function are kept in any event (perhaps in an attribute).
It seems to me that there are lots of simple ways of implementing the ideas
that we've been discussing and that any one of them would probably be
reasonable and better than the current situation.
Department of Sociology