citEntry                package:utils                R Documentation

_W_r_i_t_i_n_g _P_a_c_k_a_g_e _C_I_T_A_T_I_O_N _F_i_l_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     The 'CITATION' file of R packages contains an annotated list of
     references that should be used for citing the packages.

_U_s_a_g_e:

     citEntry(entry, textVersion, header = NULL, footer = NULL, ...)
     citHeader(...)
     citFooter(...)
     readCitationFile(file)

_A_r_g_u_m_e_n_t_s:

   entry: a character string with a BibTeX entry type

textVersion: a character string with a text representation of the
          reference

  header: a character string with optional header text

  footer: a character string with optional footer text

    file: a file name

     ...: see details below

_D_e_t_a_i_l_s:

     The 'CITATION' file of an R package should be placed in the 'inst'
     subdirectory of the package source. The file is an R source file
     and may contain arbitrary R commands including conditionals and
     computations. The file is 'source()'ed by the R parser in a
     temporary environment and all resulting objects of class
     '"citation"' (the return value of 'citEntry') are collected.

     Typically the file will contain zero or more calls to 'citHeader',
     then one or more calls to 'citEntry', and  finally zero or more
     calls to  'citFooter'. 'citHeader' and 'citFooter' are simply
     wrappers to 'paste', and their '...' argument is passed on to
     'paste' as is.

_V_a_l_u_e:

     'citEntry' returns an object of class '"citation"',
     'readCitationFile' returns an object of class '"citationList"'.

_E_n_t_r_y _T_y_p_e_s:

     'citEntry' creates '"citation"' objects, which are modeled after
     BibTeX entries. The entry should be a valid BibTeX entry type,
     e.g.,

     _a_r_t_i_c_l_e: An article from a journal or magazine.

     _b_o_o_k: A book with an explicit publisher.

     _i_n_b_o_o_k: A part of a book, which may be a chapter (or section or
          whatever) and/or a range of pages.  

     _i_n_c_o_l_l_e_c_t_i_o_n: A part of a book having its own title.

     _i_n_p_r_o_c_e_e_d_i_n_g_s: An article in a conference proceedings.

     _m_a_n_u_a_l: Technical documentation like a software manual.

     _m_a_s_t_e_r_s_t_h_e_s_i_s: A Master's thesis.

     _m_i_s_c: Use this type when nothing else fits.

     _p_h_d_t_h_e_s_i_s: A PhD thesis.

     _p_r_o_c_e_e_d_i_n_g_s: The proceedings of a conference.

     _t_e_c_h_r_e_p_o_r_t: A report published by a school or other institution,
          usually numbered within a series.

     _u_n_p_u_b_l_i_s_h_e_d: A document having an author and title, but not
          formally published.

_E_n_t_r_y _F_i_e_l_d_s:

     The '...' argument of 'citEntry' can be any number of BibTeX
     fields, including

     _a_d_d_r_e_s_s: The address of the publisher or other type of
          institution.

     _a_u_t_h_o_r: The name(s) of the author(s), either  as a character
          string in the format described in the LaTeX book, or a
          'personList' object.

     _b_o_o_k_t_i_t_l_e: Title of a book, part of which is being cited.

     _c_h_a_p_t_e_r: A chapter (or section or whatever) number.

     _e_d_i_t_o_r: Name(s) of editor(s), same format as 'author'.

     _i_n_s_t_i_t_u_t_i_o_n: The publishing institution of a technical report.

     _j_o_u_r_n_a_l: A journal name.

     _n_o_t_e: Any additional information that can help the reader. The
          first word should be capitalized.

     _n_u_m_b_e_r: The number of a journal, magazine, technical report, or of
          a work in a series.

     _p_a_g_e_s: One or more page numbers or range of numbers.

     _p_u_b_l_i_s_h_e_r: The publisher's name.

     _s_c_h_o_o_l: The name of the school where a thesis was written.

     _s_e_r_i_e_s: The name of a series or set of books.

     _t_i_t_l_e: The work's title.

     _v_o_l_u_m_e: The volume of a journal or multi-volume book.

     _y_e_a_r: The year of publication.

_E_x_a_m_p_l_e_s:

     basecit <- system.file("CITATION", package="base")
     source(basecit, echo=TRUE)
     readCitationFile(basecit)

