| 54635 |
ripley |
1 |
% File src/library/tools/man/Rdiff.Rd
|
|
|
2 |
% Part of the R package, http://www.R-project.org
|
| 62386 |
ripley |
3 |
% Copyright 2010-13 R Core Team
|
| 54635 |
ripley |
4 |
% Distributed under GPL 2 or later
|
|
|
5 |
|
| 47761 |
ripley |
6 |
\name{Rdiff}
|
| 56186 |
murdoch |
7 |
\alias{Rdiff}
|
| 50080 |
murdoch |
8 |
\title{Difference R Output Files}
|
| 47761 |
ripley |
9 |
\description{
|
|
|
10 |
Given two \R output files, compute differences ignoring headers,
|
| 56350 |
murdoch |
11 |
footers and some other differences.
|
| 47761 |
ripley |
12 |
}
|
|
|
13 |
\usage{
|
| 62172 |
hornik |
14 |
Rdiff(from, to, useDiff = FALSE, forEx = FALSE,
|
|
|
15 |
nullPointers = TRUE, Log = FALSE)
|
| 47761 |
ripley |
16 |
}
|
|
|
17 |
\arguments{
|
|
|
18 |
\item{from, to}{filepaths to be compared}
|
| 50468 |
ripley |
19 |
\item{useDiff}{should \command{diff} always be used to compare
|
|
|
20 |
results?}
|
|
|
21 |
\item{forEx}{logical: extra pruning for \file{-Ex.Rout} files to
|
|
|
22 |
exclude the header.}
|
| 57257 |
ripley |
23 |
\item{nullPointers}{logical: should the displayed addresses of
|
| 61433 |
ripley |
24 |
pointers be set to \code{0x00000000} before comparison?}
|
| 57257 |
ripley |
25 |
\item{Log}{logical: should the returned value include a log of
|
|
|
26 |
differences found?}
|
| 47761 |
ripley |
27 |
}
|
|
|
28 |
\details{
|
| 62407 |
ripley |
29 |
|
| 57257 |
ripley |
30 |
The \R startup banner and any timing information from \command{R CMD
|
| 62386 |
ripley |
31 |
BATCH} are removed from both files, together with lines about
|
|
|
32 |
loading packages. UTF-8 fancy quotes (see \code{\link{sQuote}}) and
|
|
|
33 |
on Windows, Windows' so-called \sQuote{smart quotes}, are mapped to
|
|
|
34 |
a simple quote. Addresses of environments, compiled bytecode and
|
|
|
35 |
other exotic types expressed as hex addresses
|
|
|
36 |
(e.g. \code{<environment: 0x12345678>}) are mapped to
|
|
|
37 |
\code{0x00000000}. The files are then compared line-by-line. If
|
|
|
38 |
there are the same number of lines and \code{useDiff} is false, a
|
| 62407 |
ripley |
39 |
simple \command{diff -b} -like display of differences is printed
|
|
|
40 |
(which ignores trailing spaces and differences in numbers of
|
|
|
41 |
consecutive spaces), otherwise \command{diff -bw} is called on the
|
|
|
42 |
edited files. (This tries to ignore all differences in whitespace:
|
|
|
43 |
note that flag \option{-w} is not required by POSIX but is supported
|
|
|
44 |
by GNU, Solaris and FreeBSD versions.)
|
| 56951 |
ripley |
45 |
|
| 62386 |
ripley |
46 |
This can compare uncompressed PDF files, ignoring differences in
|
|
|
47 |
creation and modification dates.
|
| 47761 |
ripley |
48 |
}
|
|
|
49 |
\value{
|
| 54626 |
ripley |
50 |
If \code{Log} is true, a list with components \code{status} (see
|
|
|
51 |
below) and \code{out}, a character vector of descriptions of
|
|
|
52 |
differences, possibly of zero length.
|
|
|
53 |
|
|
|
54 |
Otherwise, a status indicator, \code{0L} if and only if no differences
|
|
|
55 |
were found.
|
| 47761 |
ripley |
56 |
}
|
|
|
57 |
|
|
|
58 |
\seealso{
|
|
|
59 |
The shell script run as \command{R CMD Rdiff}.
|
|
|
60 |
}
|
|
|
61 |
|
|
|
62 |
\keyword{utilities}
|
|
|
63 |
|
The R Project SVN
R