diff options
-rw-r--r-- | ChangeLog | 7 | ||||
-rw-r--r-- | doc/dejagnu.texi | 26 |
2 files changed, 24 insertions, 9 deletions
@@ -1,3 +1,10 @@ +2022-11-30 Jacob Bachmeyer <jcb@gnu.org> + + * doc/dejagnu.texi (C unit testing API): Document use of "DG_" + prefix in dejagnu.h and "DG__" for internal symbols. + (C++ unit testing API): Likewise. Also declare namespace + "DejaGnu" reserved for future expansion. + 2022-11-29 Jacob Bachmeyer <jcb@gnu.org> * Makefile.in: Regenerate. diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi index 03f7aa9..c162646 100644 --- a/doc/dejagnu.texi +++ b/doc/dejagnu.texi @@ -2554,11 +2554,14 @@ recognized and interpreted by DejaGnu, appears in the log. @cindex C unit testing API The C API is provided in the @file{dejagnu.h} header file. This -header provides a self-contained implementation. For convenience, the -@code{totals()} function can be called at the end of the unit test -program to output summary totals. DejaGnu counts the test results -independently and will operate correctly even if @code{totals()} is -never invoked. +header provides a self-contained implementation and reserves names +prefixed with @code{DG_} for future extensions and names prefixed with +@code{DG__} (two underscores) for internal use. + +For convenience, the @code{totals()} function can be called at the end +of the unit test program to output summary totals. DejaGnu counts the +test results independently and will operate correctly even if +@code{totals()} is never invoked. All of the functions that take a @code{msg} parameter use a C @code{char *} that is the message to be displayed. All of the @@ -2646,10 +2649,15 @@ independently. @cindex C++ unit testing API The C++ API is also provided in the @file{dejagnu.h} header file. -This header provides a self-contained implementation. For -convenience, the @code{totals()} method outputs summary totals to be -used at the end of unit test program. DejaGnu does not depend on this -summary and counts the test results independently. +This header provides a self-contained implementation and reserves +names prefixed with @code{DG_} for future extensions and names +prefixed with @code{DG__} (two underscores) for internal use. In C++, +@file{dejagnu.h} also reserves the C++ namespace @code{DejaGnu} for +possible future use. + +For convenience, the @code{totals()} method outputs summary totals to +be used at the end of unit test program. DejaGnu does not depend on +this summary and counts the test results independently. All of the methods that take a @code{msg} parameter use a STL string as the message to be displayed. There currently is no support for |