Add R_curErrorBuf to the experimental API.

git-svn-id: https://svn.r-project.org/R/trunk@89040 00db46b3-68df-0310-9c12-caf00c1e9a41

Author: luke

doc/manual/R-exts.texi

@@ -13593,10 +13593,10 @@ is modified it may suffice to call @code{Rf_shallow_duplicate}.
 @comment FIXME need a separate section on attributes
 At times it may be necessary to copy attributes from one object to
 another.  This can be done using @code{DUPLICATE_ATTRIB} or
-@code{SHALLOW_DUPLICATE_ATTRIB}
+@code{SHALLOW_DUPLICATE_ATTRIB}. 
 @apifun DUPLICATE_ATTRIB
 @apifun SHALLOW_DUPLICATE_ATTRIB
-@code{ANY_ATTRIB} checks whether there are any attributes and
+@code{ANY_ATTRIB} checks whether there are any attributes, and
 @code{CLEAR_ATTRIB} removes all attributes.
 @apifun ANY_ATTRIB
 @apifun CLEAR_ATTRIB
@@ -17050,7 +17050,7 @@ functions built on @code{R_ToplevelExec} are @code{R_tryEval} and
 @code{R_tryEvalSilent}.
 @example
 SEXP R_tryEval(SEXP e, SEXP env, int *ErrorOccurred);
-SEXP R_tryEvalSilent(SEXP e, SEXP env, int *ErrorOccurred)
+SEXP R_tryEvalSilent(SEXP e, SEXP env, int *ErrorOccurred);
 @end example
 @apifun R_tryEvalSilent
 @apifun R_tryEval
@@ -17064,6 +17064,14 @@ option. For example, finalizers are run in a separate top level
 context. The other functions mentioned in this section will usually be
 more appropriate choices.
 
+Currently, if these evaluations produce an error that is handled by the
+default handler, then the error message will be stored in a buffer that
+can be accessed with @code{R_curErrorBuf}.
+@example
+const char *R_curErrorBuf(void);
+@end example
+@eapifun R_curErrorBuf
+This design could change in the future.
 
 @node Allowing interrupts
 @section Allowing interrupts

src/library/tools/R/sotools.R

@@ -675,7 +675,6 @@ nonAPI <- c("chol_", "chol2inv_", "cg_", "ch_", "rg_",
 ## non-API, declared in Rinternals.h
             "SET_OBJECT", ## no longer used in an example in R-exts 
             "SET_S4_OBJECT", "UNSET_S4_OBJECT",
-            "R_curErrorBuf",
             "SETLENGTH", "SET_TRUELENGTH", "SETLEVELS",
             "SET_ENVFLAGS", "SET_FRAME", "SET_ENCLOS", "SET_HASHTAB",
             "SET_PRENV", "SET_PRVALUE", "SET_PRCODE", "STDVEC_DATAPTR",