trunk/inst/doc/README

   1 To install:
   2
   3 $ cd ..
   4 $ R CMD INSTALL cran2deb
   5
   6 copy cran2deb/exec/cran2deb into somewhere in your executable path (e.g.,
   7 /usr/local/bin, $home/bin)
   8
   9
  10
  11 To configure:
  12
  13 1. You need a web server serving from say, /var/www/cran2deb/
  14
  15 Let ROOT be the value returned by running: cran2deb root
  16 Let SYS be the system you wish to build for (e.g., debian-amd64)
  17
  18 2. create /etc/cran2deb
  19    a. copy ROOT/etc/* into /etc/cran2deb/sys/SYS/
  20    b. /etc/cran2deb/archive should be a symlink pointing to /var/www/cran2deb/
  21
  22     $ ln -s /var/www/cran2deb/ /etc/cran2deb/archive
  23     $ mkdir /var/www/cran2deb/SYS
  24
  25    c. modify OTHERMIRROR of /etc/cran2deb/pbuilderrc.in to point to your webserver
  26
  27 3. cran2deb needs a persistent cache outside of R's control. therefore, create
  28     /var/cache/cran2deb, writable by whichever user(s) will run cran2deb.
  29 4. run: cran2deb update
  30 5. Try building a simple package: cran2deb build zoo
  31    (The result will be in /var/cache/cran2deb/results/SYS)
  32
  33
  34 $ cran2deb help
  35 will display a short summary of help for each cran2deb command.
  36
  37
  38 Concerning data/:
  39 This contains scripts necessary to recreate the database should you loose the
  40 database. It's a backup that can be versioned by SVN. There is a script called
  41 pull that, when run from the data directory will recreate all the files from
  42 the database EXCEPT for the licenses. The licenses cannot be recreated because
  43 licenses can be based on one-way hashes.  This process could certainly be
  44 improved.
  45