]> git.saurik.com Git - wxWidgets.git/commitdiff
Minor English corrections
authorJulian Smart <julian@anthemion.co.uk>
Wed, 30 Mar 2005 15:20:02 +0000 (15:20 +0000)
committerJulian Smart <julian@anthemion.co.uk>
Wed, 30 Mar 2005 15:20:02 +0000 (15:20 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@33177 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/debugrpt.tex
docs/latex/wx/mbcnvfil.tex
docs/latex/wx/tmbconv.tex

index dc812d94d7faa938cbe7829189650a3ca6525298..ef3ef801cb42f1819ff089351cc20784bee056ad 100644 (file)
@@ -16,17 +16,17 @@ the program current state. It is usually used from
 \helpref{wxApp::OnFatalException()}{wxapponfatalexception} as shown in the 
 \helpref{sample}{sampledebugrpt}.
 
-wxDebugReport contains one or more files. A few of them can be created by the
+A wxDebugReport object contains one or more files. A few of them can be created by the
 class itself but more can be created from the outside and then added to the
 report. Also note that several virtual functions may be overridden to further
 customize the class behaviour.
 
-Once report is fully assembled, it can be simply left in the temporary
+Once a report is fully assembled, it can simply be left in the temporary
 directory so that the user can email it to the developers (in which case you
 should still use \helpref{wxDebugReportCompress}{wxdebugreportcompress} to
 compress it in a single file) or uploaded to a Web server using 
 \helpref{wxDebugReportUpload}{wxdebugreportupload} (setting up the Web server
-to accept uploads is your responsibility, of course). Other handlers, e.g. for
+to accept uploads is your responsibility, of course). Other handlers, for example for
 automatically emailing the report, can be defined as well but are not currently
 included in wxWidgets.
 
@@ -37,7 +37,7 @@ included in wxWidgets.
     wxDebugReportPreviewStd preview;
 
     report.AddCurrentContext();  // could also use AddAll()
-    report.AddCurrentDump();     //     to do both at once
+    report.AddCurrentDump();     // to do both at once
 
     if ( preview.Show(report) )
         report.Process();
@@ -53,8 +53,9 @@ No base class
 
 \wxheading{Data structures}
 
-This enum used for the functions which may report either the current state
+This enum is used for functions that report either the current state
 or the state during the last (fatal) exception:
+
 \begin{verbatim}
 enum wxDebugReport::Context
 {
@@ -70,7 +71,7 @@ enum wxDebugReport::Context
 
 \func{}{wxDebugReport}{\void}
 
-Constructor creates a temporary directory where the files which will
+The constructor creates a temporary directory where the files that will
 be included in the report are created. Use 
 \helpref{IsOk()}{wxdebugreportisok} to check for errors.
 
@@ -79,8 +80,8 @@ be included in the report are created. Use
 
 \func{}{\destruct{wxDebugReport}}{\void}
 
-Destructor normally destroys the temporary directory created in the constructor
-with all the files it contains, call \helpref{Reset()}{wxdebugreportreset} to
+The destructor normally destroys the temporary directory created in the constructor
+with all the files it contains. Call \helpref{Reset()}{wxdebugreportreset} to
 prevent this from happening.
 
 
@@ -88,7 +89,7 @@ prevent this from happening.
 
 \func{void}{AddAll}{\param{Context }{context = Context\_Exception}}
 
-Add all available information to the report. Currently this includes a
+Adds all available information to the report. Currently this includes a
 text (XML) file describing the process context and, under Win32, a minidump
 file.
 
@@ -105,23 +106,23 @@ stack trace.
 
 \func{bool}{AddCurrentContext}{\void}
 
-Same as \helpref{AddContext(Context\_Current)}{wxdebugreportaddcontext}.
+The same as \helpref{AddContext(Context\_Current)}{wxdebugreportaddcontext}.
 
 
 \membersection{wxDebugReport::AddCurrentDump}\label{wxdebugreportaddcurrentdump}
 
 \func{bool}{AddCurrentDump}{\void}
 
-Same as \helpref{AddDump(Context\_Current)}{wxdebugreportadddump}.
+The same as \helpref{AddDump(Context\_Current)}{wxdebugreportadddump}.
 
 
 \membersection{wxDebugReport::AddDump}\label{wxdebugreportadddump}
 
 \func{bool}{AddDump}{\param{Context }{ctx}}
 
-Adds minidump file to the debug report.
+Adds the minidump file to the debug report.
 
-Minidumps are only available under recent Win32 versions (\texttt{dbghlp32.dll}
+Minidumps are only available under recent Win32 versions (\texttt{dbghlp32.dll} 
 can be installed under older systems to make minidumps available).
 
 
@@ -129,14 +130,14 @@ can be installed under older systems to make minidumps available).
 
 \func{bool}{AddExceptionContext}{\void}
 
-Same as \helpref{AddContext(Context\_Exception)}{wxdebugreportaddcontext}.
+The same as \helpref{AddContext(Context\_Exception)}{wxdebugreportaddcontext}.
 
 
 \membersection{wxDebugReport::AddExceptionDump}\label{wxdebugreportaddexceptiondump}
 
 \func{bool}{AddExceptionDump}{\void}
 
-Same as \helpref{AddDump(Context\_Exception)}{wxdebugreportadddump}.
+The same as \helpref{AddDump(Context\_Exception)}{wxdebugreportadddump}.
 
 
 \membersection{wxDebugReport::AddFile}\label{wxdebugreportaddfile}
@@ -187,7 +188,7 @@ the XML context file.
 
 \constfunc{const wxString\&}{GetDirectory}{\void}
 
-Return the name of the temporary directory used for the files in this report.
+Returns the name of the temporary directory used for the files in this report.
 
 This method should be used to construct the full name of the files which you
 wish to add to the report using \helpref{AddFile}{wxdebugreportaddfile}.
@@ -197,7 +198,7 @@ wish to add to the report using \helpref{AddFile}{wxdebugreportaddfile}.
 
 \constfunc{bool}{GetFile}{\param{size\_t }{n}, \param{wxString* }{name}, \param{wxString* }{desc}}
 
-Retrieve the name (relative to 
+Retrieves the name (relative to 
 \helpref{GetDirectory()}{wxdebugreportgetdirectory}) and the description of the
 file with the given index. If \arg{n} is greater than or equal to the number of
 filse, \false is returned.
@@ -207,14 +208,14 @@ filse, \false is returned.
 
 \constfunc{size\_t}{GetFilesCount}{\void}
 
-Get the current number files in this report.
+Gets the current number files in this report.
 
 
 \membersection{wxDebugReport::GetReportName}\label{wxdebugreportgetreportname}
 
 \constfunc{wxString}{GetReportName}{\void}
 
-Get the name used as base name for various files, by default 
+Gets the name used as a base name for various files, by default 
 \helpref{wxApp::GetAppName()}{wxappgetappname} is used.
 
 
@@ -222,7 +223,7 @@ Get the name used as base name for various files, by default
 
 \constfunc{bool}{IsOk}{\void}
 
-Return \true if the object was successfully initialized, if this method returns 
+Returns \true if the object was successfully initialized. If this method returns 
 \false the report can't be used.
 
 
@@ -230,8 +231,8 @@ Return \true if the object was successfully initialized, if this method returns
 
 \func{bool}{Process}{\void}
 
-Process this report: the base class simply notifies the user that the
-report has been generated, this is usually not enough -- instead you
+Processes this report: the base class simply notifies the user that the
+report has been generated. This is usually not enough -- instead you
 should override this method to do something more useful to you.
 
 
@@ -239,7 +240,7 @@ should override this method to do something more useful to you.
 
 \func{void}{RemoveFile}{\param{const wxString\& }{name}}
 
-Remove the file from report: this is used by 
+Removes the file from report: this is used by 
 \helpref{wxDebugReportPreview}{wxdebugreportpreview} to allow the user to
 remove files potentially containing private information from the report.
 
@@ -248,6 +249,6 @@ remove files potentially containing private information from the report.
 
 \func{void}{Reset}{\void}
 
-Reset the directory name we use, the object can't be used any more after
-this as it becomes invalid/uninitialized.
+Resets the directory name we use. The object can't be used any more after
+this as it becomes uninitialized and invalid.
 
index f394797bbb9bf5a6517a87416d8143974a5efa84..2ed8c847df68fe353954c4ac1dd1ee18c2f55a7a 100644 (file)
@@ -5,7 +5,7 @@
 
 \section{\class{wxMBConvFile}}\label{wxmbconvfile}
 
-This class used to be used for defining the class instance
+This class used to define the class instance 
 {\bf wxConvFileName}, but nowadays {\bf wxConvFileName} is
 either of type wxConvLibc (on most platforms) or wxConvUTF8
 (on MacOS X). {\bf wxConvFileName} converts filenames between 
@@ -17,8 +17,8 @@ should not be interpreted as UTF8 and also for converting
 invalid UTF8 characters (e.g. if there is a filename in iso8859_1)
 to strings with octal values. 
 
-Since some platforms (e.g. Win32) use Unicode in the filenames,
-and others (e.g. Unix) use multibyte encodings, this class should only
+Since some platforms (such as Win32) use Unicode in the filenames,
+and others (such as Unix) use multibyte encodings, this class should only
 be used directly if wxMBFILES is defined to 1. A convenience macro,
 wxFNCONV, is defined to wxConvFileName->cWX2MB in this case. You could
 use it like this:
index 0bc02d681cd2b3c4877ab716a76c8c54b7382e83..2a1ad1f34890d86f4d8d4bc0165ab8de17008600 100644 (file)
 
 Classes: \helpref{wxMBConv}{wxmbconv}, wxMBConvLibc, 
 \helpref{wxMBConvUTF7}{wxmbconvutf7}, \helpref{wxMBConvUTF8}{wxmbconvutf8}, 
-\helpref{wxCSConv}{wxcsconv},
+\helpref{wxCSConv}{wxcsconv}, 
 \helpref{wxMBConvUTF16}{wxmbconvutf16}, \helpref{wxMBConvUTF32}{wxmbconvutf32}
 
-The wxMBConv classes in wxWidgets enables an Unicode-aware application to
+The wxMBConv classes in wxWidgets enable an Unicode-aware application to
 easily convert between Unicode and the variety of 8-bit encoding systems still
 in use.