From Friedrich.Leisch@ci.tuwien.ac.at  Thu Jan 21 15:28:14 1999
From: Friedrich.Leisch@ci.tuwien.ac.at (Friedrich Leisch)
Date: Thu, 21 Jan 1999 16:28:14 +0100 (CET)
Subject: Rd files
In-Reply-To: <99Jan21.103020est.13453@mailgate.bank-banque-canada.ca>
References: <99Jan20.160839est.13457@mailgate.bank-banque-canada.ca>
 <13990.63406.547337.590199@galadriel.ci.tuwien.ac.at>
 <99Jan21.103020est.13453@mailgate.bank-banque-canada.ca>
Message-ID: <13991.18318.406913.164469@galadriel.ci.tuwien.ac.at>

>>>>> On Thu, 21 Jan 1999 10:07:48 -0500,
>>>>> Paul Gilbert (PG) wrote:

PG> Friedrich
PG> Thanks for the clarifications and update.

>> I'm currently starting (the long announced, but now it's real)
>> re-write of Rdconv by making it module-oriented and using Text::Delim
>> as extraction engine (as suggested by Doug quite some time ago).

PG> So I guess I should wait to do my conversion.

Well, the Rd syntax should NOT change (maybe some additional features)
... so unless something doesn't work as expected the user shouldn't
notice too much of a difference ...


PG> - Must there be separate .Rd files for each function or can they be c=
ombined

PG> into one large file?

>> Yes, currently the idea is to have one Rd file per html/help file. I
>> never thought about it though ... do many people want to be able to
>> have all documentation in one big file?

PG> I don't really care too much about this, I just wanted to make sure I=
 understand
PG> it. However,  it may not be too difficult allow a large .Rd file and =
have the
PG> build decompose it using the /name{..}. I currently keep many functio=
ns in one
PG> file along with their documentation separated by /*   */. I separate =
this into
PG> the .R and .Rd files with an awk script. So the question for me is wh=
ether I
PG> have to separate the .Rd file further or is the R build going to do i=
t. I guess
PG> I would prefer that the R build do it, as I think others may use it t=
his way
PG> too, but I think I can do it fairly easily.

I'll put it on my Rd wish list ... but don't hold your breath waiting
for it.

.f

--=20
-------------------------------------------------------------------
                        Friedrich  Leisch=20
Institut f=FCr Statistik                     Tel: (+43 1) 58801 10715
Technische Universit=E4t Wien                Fax: (+43 1) 58801 10798
Wiedner Hauptstra=DFe 8-10/1071      Friedrich.Leisch@ci.tuwien.ac.at
A-1040 Wien, Austria             http://www.ci.tuwien.ac.at/~leisch
     PGP public key http://www.ci.tuwien.ac.at/~leisch/pgp.key
-------------------------------------------------------------------

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
r-devel mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html
Send "info", "help", or "[un]subscribe"
(in the "body", not the subject !)  To: r-devel-request@stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._


Rd files
Friedrich Leisch