tangleR                package:relax                R Documentation

_f_u_n_c_t_i_o_n _t_o _t_a_n_g_l_e _a _f_i_l_e

_D_e_s_c_r_i_p_t_i_o_n:

     'tangleR' reads a file that is written according to the rules of
     the 'noweb' system and performs a specific kind of tangling. As a
     result a '.R'-file is generated.

_U_s_a_g_e:

     tangleR(in.file, out.file, expand.roots = NULL,
     expand.root.start = TRUE)

_A_r_g_u_m_e_n_t_s:

 in.file: name of input file 

out.file: name of output file; if missing the extension of the input
          file is turned to '.R' 

expand.roots: name(s) of root(s) to be expanded; if NULL all will be
          processed 

expand.root.start: if TRUE (default) root chunk "start" will be
          expanded 

_D_e_t_a_i_l_s:

     General remarks: A 'noweb' file consists of a mixture of text and
     code chunks. An '@' character (in column 1 of a line) indicates
     the beginning of a text chunk. '<<name of code chunk>>=' (starting
     at column 1 of a line) is a header line of a code chunk with a
     name defined by the text between '<<' and '>>='. A code chunk is
     finished by the beginning of the next text chunk. Within the code
     chunk you can use other code chunks by referencing them by name (
     for example by: '<<name of code chunk>>' ). In this way you can
     separate a big job in smaller ones.

     Special remarks: 'tangleR' expands code chunk 'start' if flag
     'expand.root.start' is TRUE. Code chunks will be surrounded by
     comment lines showing the number of the code chunk the code is
     coming from. If you want to use '<<' or '>>' in your code  it may
     be necessary to escape them by an '@'-sign. Then you have to type
     in: '@<<' or '@>>'.

_V_a_l_u_e:

     usually a file with R code is generated

_A_u_t_h_o_r(_s):

     Hans Peter Wolf

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.eecs.harvard.edu/~nr/noweb/intro.html>

_S_e_e _A_l_s_o:

     'weaveR'

_E_x_a_m_p_l_e_s:

     ## Not run: 
     ## This example cannot be run by examples() but should be work in an interactive R session
       tangleR("testfile.rev")
     ## End(Not run)
     "tangleR(\"testfile.rev\")"
     ## The function is currently defined as
     function(in.file,out.file,expand.roots=NULL,expand.root.start=TRUE){
     # german documentation of the code:
     # look for file webR.pdf, P. Wolf 050204
     ...
       }

