[Rd] Flat documentation?
Wed Dec 11 03:53:02 2002
>>>>> "duncan" == Duncan Murdoch <firstname.lastname@example.org> writes:
duncan> I don't know how much these flat files should participate
duncan> in the overall R help system. The more they show up like
duncan> regular help topics the better, but that's going to impose
duncan> constraints on what goes in them. For example,
duncan> cross-references or entries in the contents or index
duncan> listings would be nice, but would need markup of some
I'm not sure how indexing might go.
One thought would be to do similar to the bioconductor Sweave files,
but completely in the opposite direction.
DHT (dumb help text) files could be put into an appropriate directory,
and then we could have a DHT.browser() function that would cat out,
using a pager, a copy of the file, or without prompting, give a list
of packages and topics for each package covered by DHT files.
Then, you'd stick 2 lines of formatting at the topic, ala the SWeave
vignettes, for indexing and referencing stuff.
I'd call it illiterate statistical programming, just to complete the
notion that they are complete opposites from the vignettes.
On re-reading the above, I think I need more sleep and less stress;
this isn't one of my better ideas...
A.J. Rossini Rsrch. Asst. Prof. of Biostatistics
U. of Washington Biostatistics email@example.com
FHCRC/SCHARP/HIV Vaccine Trials Net firstname.lastname@example.org
-------------- http://software.biostat.washington.edu/ ----------------
FHCRC: M: 206-667-7025 (fax=4812)|Voicemail is pretty sketchy/use Email
UW: Th: 206-543-1044 (fax=3286)|Change last 4 digits of phone to FAX
(my tuesday/wednesday/friday locations are completely unpredictable.)