The R Project SVN R

Rev

Rev 9463 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 9463 Rev 10443
Line 9... Line 9...
9 
\usage{
 9 
\usage{
10 
dump.frames(dumpto = "last.dump", to.file = FALSE)
 10 
dump.frames(dumpto = "last.dump", to.file = FALSE)
11 
debugger(dump = last.dump)
 11 
debugger(dump = last.dump)
12 
}
 12 
}
13 
\arguments{
 13 
\arguments{
14 
 \item{dumpto}{a character string. The name of the object or file to dump to.}
 14 
  \item{dumpto}{a character string. The name of the object or file to
- 
 
 15 
    dump to.}
15 
 \item{to.file}{logical. Should the dump be to an \R object or to a file?}
 16 
  \item{to.file}{logical. Should the dump be to an \R object or to a
- 
 
 17 
    file?}
16 
 \item{dump}{An \R dump object created by \code{dump.frames}}
 18 
  \item{dump}{An \R dump object created by \code{dump.frames}.}
17 
}
 19 
}
18 
\details{
 20 
\details{
19 
  To use post-mortem debugging, set the option \code{error} to be a call
 21 
  To use post-mortem debugging, set the option \code{error} to be a call
20 
  to \code{dump.frames}.  By default this dumps to an \R object
 22 
  to \code{dump.frames}.  By default this dumps to an \R object
21 
  \code{"last.dump"} in the workspace, but it can be set to dump to a
 23 
  \code{"last.dump"} in the workspace, but it can be set to dump to a
Line 39... Line 41...
39 
\value{
 41 
\value{
40 
  None.
 42 
  None.
41 
}
 43 
}
42 
\author{B. D. Ripley}
 44 
\author{B. D. Ripley}
43 
\note{
 45 
\note{
44 
  Functions such as \code{\link{sys.parent}} and \code{\link{environment}}
 46 
  Functions such as \code{\link{sys.parent}} and
45 
  applied to closures will not work correctly inside \code{debugger}.
 47 
  \code{\link{environment}} applied to closures will not work correctly
- 
 
 48 
  inside \code{debugger}.
46 
 
 49 
 
47 
  Of course post-mortem debugging will not work if \R is too damaged to
 50 
  Of course post-mortem debugging will not work if \R is too damaged to
48 
  produce and save the dump, for example if it has run out of workspace.
 51 
  produce and save the dump, for example if it has run out of workspace.
49 
 
 52 
}
50 
\seealso{
 53 
\seealso{
51 
  \code{\link{options}} for setting \code{error} options.
 54 
  \code{\link{options}} for setting \code{error} options.
52 
}
 55 
}
53 
 
 - 
 
54 
\examples{
 56 
\examples{
55 
\dontrun{
 57 
\dontrun{
56 
options(error=quote(dump.frames("testdump", TRUE)))
 58 
options(error=quote(dump.frames("testdump", TRUE)))
57 
 
 59 
 
58 
f <- function() {
 60 
f <- function() {