The R Project SVN R

Rev

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

Rev 68948 Rev 71102
Line 1... Line 1...
1 
% File src/library/utils/man/debugger.Rd
 1 
% File src/library/utils/man/debugger.Rd
2 
% Part of the R package, https://www.R-project.org
 2 
% Part of the R package, https://www.R-project.org
3 
% Copyright 1995-2014 R Core Team
 3 
% Copyright 1995-2016 R Core Team
4 
% Distributed under GPL 2 or later
 4 
% Distributed under GPL 2 or later
5 
 
 5 
 
6 
\name{debugger}
 6 
\name{debugger}
7 
\alias{debugger}
 7 
\alias{debugger}
8 
\alias{dump.frames}
 8 
\alias{dump.frames}
Line 10... Line 10...
10 
\description{
 10 
\description{
11 
  Functions to dump the evaluation environments (frames) and to examine
 11 
  Functions to dump the evaluation environments (frames) and to examine
12 
  dumped frames.
 12 
  dumped frames.
13 
}
 13 
}
14 
\usage{
 14 
\usage{
15 
dump.frames(dumpto = "last.dump", to.file = FALSE)
 15 
dump.frames(dumpto = "last.dump", to.file = FALSE,
- 
 
 16 
            include.GlobalEnv = FALSE)
16 
debugger(dump = last.dump)
 17 
debugger(dump = last.dump)
17 
}
 18 
}
18 
\arguments{
 19 
\arguments{
19 
  \item{dumpto}{a character string. The name of the object or file to
 20 
  \item{dumpto}{a character string. The name of the object or file to
20 
    dump to.}
 21 
    dump to.}
21 
  \item{to.file}{logical. Should the dump be to an \R object or to a
 22 
  \item{to.file}{logical.  Should the dump be to an \R object or to a
22 
    file?}
 23 
    file?}
- 
 
 24 
  \item{include.GlobalEnv}{logical indicating if a \emph{copy} of the
- 
 
 25 
    \code{\link{.GlobalEnv}} environment should be included in addition
- 
 
 26 
    to the \code{\link{sys.frames}()}.  Will be particularly useful when
- 
 
 27 
    used in a batch job.}
23 
  \item{dump}{An \R dump object created by \code{dump.frames}.}
 28 
  \item{dump}{an \R dump object created by \code{dump.frames}.}
24 
}
 29 
}
25 
\details{
 30 
\details{
26 
  To use post-mortem debugging, set the option \code{error} to be a call
 31 
  To use post-mortem debugging, set the option \code{error} to be a call
27 
  to \code{dump.frames}.  By default this dumps to an \R object
 32 
  to \code{dump.frames}.  By default this dumps to an \R object
28 
  \code{last.dump} in the workspace, but it can be set to dump to a
 33 
  \code{last.dump} in the workspace, but it can be set to dump to a
Line 66... Line 71...
66 
  Wadsworth & Brooks/Cole.
 71 
  Wadsworth & Brooks/Cole.
67 
}
 72 
}
68 
\seealso{
 73 
\seealso{
69 
  \code{\link{browser}} for the actions available at the \code{Browse}
 74 
  \code{\link{browser}} for the actions available at the \code{Browse}
70 
  prompt.
 75 
  prompt.
71
76 
 
72 
  \code{\link{options}} for setting \code{error} options;
 77 
  \code{\link{options}} for setting \code{error} options;
73 
  \code{\link{recover}} is an interactive debugger working similarly to
 78 
  \code{\link{recover}} is an interactive debugger working similarly to
74 
  \code{debugger} but directly after the error occurs.
 79 
  \code{debugger} but directly after the error occurs.
75 
}
 80 
}
76 
\examples{
 81 
\examples{