added wxTopLevelWindow::RequestUserAttention(); documented it and implemented it...

[wxWidgets.git] / docs / latex / wx / tempfile.tex

diff --git a/docs/latex/wx/tempfile.tex b/docs/latex/wx/tempfile.tex
index 2a196c6432bb8a2edc1241c3a83400ac4a6357ba..06a03a0d1e60f62571fa5fbfd77e4c4d2ccbd1ae 100644 (file)
--- a/docs/latex/wx/tempfile.tex
+++ b/docs/latex/wx/tempfile.tex
@@ -37,6 +37,10 @@ the modifications.
 
 No base class
 
+\wxheading{Include files}
+
+<wx/file.h>
+
 \wxheading{See also:}
 
 \helpref{wxFile}{wxfile}
@@ -44,54 +48,71 @@ No base class
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 \membersection{wxTempFile::wxTempFile}\label{wxtempfilewxtempfilector}
+
 \func{}{wxTempFile}{\void}
 
 Default constructor - \helpref{Open}{wxtempfileopen} must be used to open the
 file.
 
 \membersection{wxTempFile::wxTempFile}\label{wxtempfilewxtempfile}
+
 \func{}{wxTempFile}{\param{const wxString\& }{strName}}
 
-Associates wxTempFile with the file to be replaced and opens it. You should use
+Associates wxTempFile with the file to be replaced and opens it. You should use 
 \helpref{IsOpened}{wxtempfileisopened} to verify if the constructor succeeded.
 
 \membersection{wxTempFile::Open}\label{wxtempfileopen}
+
 \func{bool}{Open}{\param{const wxString\& }{strName}}
 
-Open the temporary file (strName is the name of file to be replaced), returns
-TRUE on success, FALSE if an error occured.
+Open the temporary file, returns {\tt true} on success, {\tt false} if an error
+occurred.
+
+{\it strName} is the name of file to be replaced. The temporary file is always
+created in the directory where {\it strName} is. In particular, if 
+{\it strName} doesn't include the path, it is created in the current directory
+and the program should have write access to it for the function to succeed.
 
 \membersection{wxTempFile::IsOpened}\label{wxtempfileisopened}
+
 \constfunc{bool}{IsOpened}{\void}
 
-Returns TRUE if the file was successfully opened.
+Returns {\tt true} if the file was successfully opened.
 
 \membersection{wxTempFile::Write}\label{wxtempfilewrite}
+
 \func{bool}{Write}{\param{const void }{*p}, \param{size\_t }{n}}
 
-Write to the file, return TRUE on success, FALSE on failure.
+Write to the file, return {\tt true} on success, {\tt false} on failure.
 
 \membersection{wxTempFile::Write}\label{wxtempfilewrites}
-\func{bool}{Write}{\param{const wxString\& }{str}}
 
-Write to the file, return TRUE on success, FALSE on failure.
+\func{bool}{Write}{\param{const wxString\& }{str}, \param{wxMBConv\&}{ conv = wxConvLibc}}
+
+Write to the file, return {\tt true} on success, {\tt false} on failure.
+
+The second argument is only meaningful in Unicode build of wxWidgets when
+{\it conv} is used to convert {\it str} to multibyte representation.
 
 \membersection{wxTempFile::Commit}\label{wxtempfilecommit}
+
 \func{bool}{Commit}{\void}
 
 Validate changes: deletes the old file of name m\_strName and renames the new
-file to the old name. Returns TRUE if both actions succeeded. If FALSE is
+file to the old name. Returns {\tt true} if both actions succeeded. If {\tt false} is
 returned it may unfortunately mean two quite different things: either that
 either the old file couldn't be deleted or that the new file couldn't be renamed
 to the old name.
 
 \membersection{wxTempFile::Discard}\label{wxtempfilediscard}
+
 \func{void}{Discard}{\void}
 
 Discard changes: the old file contents is not changed, temporary file is
 deleted.
 
 \membersection{wxTempFile::\destruct{wxTempFile}}\label{wxtempfiledtor}
+
 \func{}{\destruct{wxTempFile}}{\void}
 
 Destructor calls \helpref{Discard()}{wxtempfilediscard} if temporary file