X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a660d684eda27638bca0384b2058911a31c8e845..88bed4b484a2f78c284c049428cd82adcc69f25d:/docs/latex/wx/debugcxt.tex diff --git a/docs/latex/wx/debugcxt.tex b/docs/latex/wx/debugcxt.tex index 841b177e3b..6e34ed172e 100644 --- a/docs/latex/wx/debugcxt.tex +++ b/docs/latex/wx/debugcxt.tex @@ -3,14 +3,18 @@ A class for performing various debugging and memory tracing operations. Full functionality (such as printing out objects currently allocated) is only present in a debugging build of wxWindows, -i.e. if the DEBUG symbol is defined and non-zero. wxDebugContext +i.e. if the \_\_WXDEBUG\_\_ symbol is defined. wxDebugContext and related functions and macros can be compiled out by setting -USE\_DEBUG\_CONTEXT to 0 is wx\_setup.h +wxUSE\_DEBUG\_CONTEXT to 0 is setup.h \wxheading{Derived from} No parent class. +\wxheading{Include files} + + + \wxheading{See also} \overview{Overview}{wxdebugcontextoverview} @@ -74,6 +78,8 @@ the WXTRACELEVEL macro to specify how detailed the trace information is; setting a different level will only have an effect if trace statements in the application specify a value other than one. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{See also} \helpref{wxDebugContext::SetLevel}{wxdebugcontextsetlevel} @@ -84,6 +90,8 @@ specify a value other than one. Returns the output stream associated with the debug context. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{See also} \helpref{wxDebugContext::SetStream}{wxdebugcontextsetstream} @@ -96,6 +104,8 @@ Returns a pointer to the output stream buffer associated with the debug context. There may not necessarily be a stream buffer if the stream has been set by the user. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \membersection{wxDebugContext::HasStream}\label{wxdebugcontexthasstream} \func{bool}{HasStream}{\void} @@ -103,6 +113,8 @@ by the user. Returns TRUE if there is a stream currently associated with the debug context. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{See also} \helpref{wxDebugContext::SetStream}{wxdebugcontextsetstream}, \helpref{wxDebugContext::GetStream}{wxdebugcontextgetstream} @@ -168,7 +180,7 @@ Sets the debug mode on or off. If debug mode is on, the wxObject new and delete operators store or use information about memory allocation. Otherwise, a straight malloc and free will be performed by these operators. -By default, debug mode is on if DEBUG is non-zero. If the application +By default, debug mode is on if \_\_WXDEBUG\_\_ is defined. If the application uses this function, it should make sure that all object memory allocated is deallocated with the same value of debug mode. Otherwise, the delete operator might try to look for memory information that does not @@ -195,6 +207,8 @@ the WXTRACELEVEL macro to specify how detailed the trace information is; setting a different level will only have an effect if trace statements in the application specify a value other than one. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{See also} \helpref{wxDebugContext::GetLevel}{wxdebugcontextgetlevel} @@ -206,6 +220,8 @@ specify a value other than one. Sets the debugging stream to be the debugger (Windows) or standard error (other platforms). This is the default setting. The existing stream will be flushed and deleted. +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \membersection{wxDebugContext::SetStream}\label{wxdebugcontextsetstream} \func{void}{SetStream}{\param{ostream* }{stream}, \param{streambuf* }{streamBuf = NULL}} @@ -213,6 +229,8 @@ This is the default setting. The existing stream will be flushed and deleted. Sets the stream and optionally, stream buffer associated with the debug context. This operation flushes and deletes the existing stream (and stream buffer if any). +This is obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{Parameters} \docparam{stream}{Stream to associate with the debug context. Do not set this to NULL.} @@ -231,10 +249,16 @@ Windows, an ostream constructed with this buffer outputs to the debugger, or other program that intercepts debugging output. On other platforms, the output goes to standard error (cerr). +This is soon to be obsolete, replaced by \helpref{wxLog}{wxlog} functionality. + \wxheading{Derived from} streambuf +\wxheading{Include files} + + + \wxheading{Example} \begin{verbatim}