RdUtils                 package:base                 R Documentation

_U_t_i_l_i_t_i_e_s _f_o_r _P_r_o_c_e_s_s_i_n_g _R_d _F_i_l_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Utilities for converting files in R documentation (Rd) format to
     other formats or create indices from them, and for converting
     documentation in other formats to Rd format.

_U_s_a_g_e:

     R CMD Rdconv [options] file
     R CMD Rd2dvi [options] files
     R CMD Rd2txt [options] file
     R CMD Sd2Rd [options] file

_A_r_g_u_m_e_n_t_s:

    file: the path to a file to be processed.

   files: a list of file names specifying the R documentation sources
          to use, by either giving the paths to the files, or the path
          to a directory with the sources of a package.

 options: further options to control the processing, or for obtaining
          information about usage and version of the utility.

_D_e_t_a_i_l_s:

     'Rdconv' converts Rd format to other formats.  Currently, plain
     text, HTML, LaTeX, S version 3 (Sd), and S version 4 (.sgml)
     formats are supported.  It can also extract the examples for
     run-time testing.

     'Rd2dvi' and 'Rd2txt' are user-level programs for producing
     DVI/PDF output or pretty text output from Rd sources. 'Rd2dvi'
     will make use of environment variables 'R_PAPERSIZE' (set by 'R
     CMD', with a default set when R was installed) and 'xdvi' (the DVI
     previewer, default 'xdvi'), and 'R_PDFVIEWER' (the PDF previwer). 
     (Valid values for 'R_PAPERSIZE' are 'a4', 'letter', 'legal' and
     'executive'.)

     'Sd2Rd' converts S (version 3 or 4) documentation formats to Rd
     format.

     Use 'R CMD foo --help' to obtain usage information on utility
     'foo'.

_N_o_t_e:

     Conversion to S version 3/4 formats is rough: there are some '.Rd'
     constructs for which there is no natural analogue. They are
     intended as a starting point for hand-tuning.

_S_e_e _A_l_s_o:

     The chapter "Processing Rd format" in the "Writing R Extensions"
     manual.

