From Friedrich.Leisch at tuwien.ac.at  Tue Jun 14 09:10:35 2005
From: Friedrich.Leisch at tuwien.ac.at (Friedrich.Leisch@tuwien.ac.at)
Date: Tue, 14 Jun 2005 09:10:35 +0200
Subject: [Rd] Citation for R
In-Reply-To: <6.2.1.2.1.20050614101736.02141e38@imaphost.wehi.edu.au>
References: <6.2.1.2.1.20050614101736.02141e38@imaphost.wehi.edu.au>
Message-ID: <17070.33515.194124.491028@galadriel.ci.tuwien.ac.at>

>>>>> On Tue, 14 Jun 2005 10:38:38 +1000,
>>>>> Gordon Smyth (GS) wrote:

  >> Note also that R does have a User Guide, i.e., while there is plenty of 
  >> excellent documentation,
  >> there is no single document which is a guide to the whole project.

  > Oops, I meant to write "R does not have a User Guide".

  > Just to explain this further, the citation() function asks me to cite a 
  > "Manual" with the title "R: A language and environment for statistical 
  > computing". Although R comes with excellent documentation, including at 
  > least 6 manuals on different aspects of the software, no manual or document 
  > with that title actually exists, as far as I know.

The Reference Index (all help Pages in one PDF document) has that name
("Reference Index" is actually the subtitle), and you can download it
from

	http://cran.r-project.org/manuals.html

(it's the 12MB guy at the end of the list of manuals). The ISBN rules
make it possible to cover both a software package and it's
corresponding reference manual by one single ISBN number if they are
bundled tightly and that's what we did for R. So as far as citations
go this should be as good a reference as any printed book. ISBN does not
require the item to be available for sale in printed form, electronic
publication is sufficient, see

	http://www.isbn-international.org/en/userman/chapter6.html

The only open question is how many ISBN number we need exactly for R
(every patch release, every minor release etc.). I had a short
discussion with the Austrian ISBN representative and he recommended
for a fast-changing work like R to consider it like a database or
encyclopedia (which is true for the help pages anyway), and be rather
pragmatic. Hence we assigned a new ISBN to version 2.0.0 and will do so
again for 3.0.0.

Best,

-- 
-------------------------------------------------------------------
                        Friedrich Leisch 
Institut f?r Statistik                     Tel: (+43 1) 58801 10715
Technische Universit?t Wien                Fax: (+43 1) 58801 10798
Wiedner Hauptstra?e 8-10/1071
A-1040 Wien, Austria             http://www.ci.tuwien.ac.at/~leisch



[Rd] Citation for R
Friedrich.Leisch@tuwien.ac.at