From ripley@stats.ox.ac.uk  Wed Dec 11 08:55:03 2002
From: ripley@stats.ox.ac.uk (ripley@stats.ox.ac.uk)
Date: Wed Dec 11 08:55:03 2002
Subject: [Rd] Flat documentation?
In-Reply-To: <b5vcvu0tp8ab3r1o9r9m9c1rqv4rke2llp@4ax.com>
Message-ID: <Pine.LNX.4.31.0212110750500.23961-100000@gannet.stats>

On Tue, 10 Dec 2002, Duncan Murdoch wrote:

> Putting together documentation in Rd format is a bit of a pain.  In
> fact, one of my colleagues has chosen to use S-PLUS instead of R
> partly because it's easier to document the stuff he's written.  (In
> S-PLUS plain text files can be used to document your code.  At least
> they could in fairly recent versions; I don't have the current one
> installed.)

That was only so on Windows, and I *think* not true on S-PLUS 6 on Windows
either.

[...]

> Are there existing schemes that help in this?  If not, would it be
> worth putting one together?

Only for something very simple: put a text file up in a pager as we
do for info files.  That should be doable cross-platform easily.

Brian

-- 
Brian D. Ripley,                  ripley@stats.ox.ac.uk
Professor of Applied Statistics,  http://www.stats.ox.ac.uk/~ripley/
University of Oxford,             Tel:  +44 1865 272861 (self)
1 South Parks Road,                     +44 1865 272860 (secr)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595



[Rd] Flat documentation?
ripley@stats.ox.ac.uk