The R Project SVN R

Rev

Rev 62172 | Rev 62407 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 62172 Rev 62386
Line 1... Line 1...
1
% File src/library/tools/man/Rdiff.Rd
1
% File src/library/tools/man/Rdiff.Rd
2
% Part of the R package, http://www.R-project.org
2
% Part of the R package, http://www.R-project.org
3
% Copyright 2010-11 R Core Team
3
% Copyright 2010-13 R Core Team
4
% Distributed under GPL 2 or later
4
% Distributed under GPL 2 or later
5
 
5
 
6
\name{Rdiff}
6
\name{Rdiff}
7
\alias{Rdiff}
7
\alias{Rdiff}
8
\title{Difference R Output Files}
8
\title{Difference R Output Files}
Line 25... Line 25...
25
  \item{Log}{logical: should the returned value include a log of
25
  \item{Log}{logical: should the returned value include a log of
26
    differences found?}
26
    differences found?}
27
}
27
}
28
\details{
28
\details{
29
  The \R startup banner and any timing information from \command{R CMD
29
  The \R startup banner and any timing information from \command{R CMD
30
    BATCH} are removed from both files, together with lines about loading
30
    BATCH} are removed from both files, together with lines about
31
  packages.  UTF-8 fancy quotes (see \code{\link{sQuote}}) and on
31
  loading packages.  UTF-8 fancy quotes (see \code{\link{sQuote}}) and
32
  Windows, Windows' so-called \sQuote{smart quotes} are mapped to a
32
  on Windows, Windows' so-called \sQuote{smart quotes}, are mapped to
33
  simple quote.  Addresses of environments, compiled bytecode and other
33
  a simple quote.  Addresses of environments, compiled bytecode and
34
  exotic types expressed as hex addresses (e.g. \code{<environment:
34
  other exotic types expressed as hex addresses
35
    0x12345678>}) are mapped to \code{0x00000000}.  The files are then
35
  (e.g. \code{<environment: 0x12345678>}) are mapped to
36
  compared line-by-line.  If there are the same number of lines and
36
  \code{0x00000000}.  The files are then compared line-by-line.  If
37
  \code{useDiff} is false, a simple \command{diff}-like display of
37
  there are the same number of lines and \code{useDiff} is false, a
-
 
38
  simple \command{diff}-like display of differences is printed (which
-
 
39
  ignores differences in consecutive spaces), otherwise \command{diff
-
 
40
    -bw} is called on the edited files.  (This tries to ignore all
38
  differences is printed, otherwise \command{diff -bw} is called on the
41
  differences in whitespace: note that flag \option{-w} is not
-
 
42
  required by POSIX but is supported by GNU, Solaris and FreeBSD
39
  edited files.
43
  versions.)
40
 
44
 
41
  As from \R 2.14.0 this can compare uncompressed PDF files, ignoring
45
  This can compare uncompressed PDF files, ignoring differences in
42
  differences in creation and modification dates.
46
  creation and modification dates.
43
}
47
}
44
\value{
48
\value{
45
  If \code{Log} is true, a list with components \code{status} (see
49
  If \code{Log} is true, a list with components \code{status} (see
46
  below) and \code{out}, a character vector of descriptions of
50
  below) and \code{out}, a character vector of descriptions of
47
  differences, possibly of zero length.
51
  differences, possibly of zero length.