X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/33a201363a194a38ee0f4e6b2c42b34b00d69731..bc253a97e78b2c42b93c1f3cc8e1bcceec68a336:/docs/latex/wx/docmanag.tex

diff --git a/docs/latex/wx/docmanag.tex b/docs/latex/wx/docmanag.tex
index 7194f9e0a8..152157b97f 100644
--- a/docs/latex/wx/docmanag.tex
+++ b/docs/latex/wx/docmanag.tex
@@ -1,6 +1,6 @@
 \section{\class{wxDocManager}}\label{wxdocmanager}
 
-The wxDocManager class is part of the document/view framework supported by wxWindows,
+The wxDocManager class is part of the document/view framework supported by wxWidgets,
 and cooperates with the \helpref{wxView}{wxview}, \helpref{wxDocument}{wxdocument}\rtfsp
 and \helpref{wxDocTemplate}{wxdoctemplate} classes.
 
@@ -72,16 +72,16 @@ A list of all document templates.
 
 \membersection{wxDocManager::wxDocManager}
 
-\func{void}{wxDocManager}{\param{long}{ flags = wxDEFAULT\_DOCMAN\_FLAGS}, \param{bool}{ initialize = TRUE}}
+\func{void}{wxDocManager}{\param{long}{ flags = wxDEFAULT\_DOCMAN\_FLAGS}, \param{bool}{ initialize = true}}
 
 Constructor. Create a document manager instance dynamically near the start of your application
 before doing any document or view operations.
 
 {\it flags} is currently unused.
 
-If {\it initialize} is TRUE, the \helpref{Initialize}{wxdocmanagerinitialize} function will be called
+If {\it initialize} is true, the \helpref{Initialize}{wxdocmanagerinitialize} function will be called
 to create a default history list object. If you derive from wxDocManager, you may wish to call the
-base constructor with FALSE, and then call Initialize in your own constructor, to allow
+base constructor with false, and then call Initialize in your own constructor, to allow
 your own Initialize or OnCreateFileHistory functions to be called.
 
 \membersection{wxDocManager::\destruct{wxDocManager}}
@@ -116,9 +116,9 @@ Adds the template to the document manager's template list.
 
 \membersection{wxDocManager::CloseDocuments}
 
-\func{bool}{CloseDocuments}{\param{bool }{force = TRUE}}
+\func{bool}{CloseDocuments}{\param{bool }{force = true}}
 
-Closes all currentled opened documents.
+Closes all currently opened documents.
 
 \membersection{wxDocManager::CreateDocument}
 
@@ -246,9 +246,9 @@ Returns the directory last selected by the user when opening a file. Initially e
 
 Returns the number of documents that can be open simultaneously.
 
-\membersection{wxDocManager::GetNoHistoryFiles}
+\membersection{wxDocManager::GetHistoryFilesCount}
 
-\func{int}{GetNoHistoryFiles}{\void}
+\func{size\_t}{GetHistoryFilesCount}{\void}
 
 Returns the number of files currently stored in the file history.
 
@@ -262,7 +262,7 @@ the opportunity to override functionality. If OnCreateFileHistory was called
 from the constructor, an overridden virtual OnCreateFileHistory would not be
 called due to C++'s `interesting' constructor semantics. In fact Initialize
 \rtfsp{\it is} called from the wxDocManager constructor, but this can be
-vetoed by passing FALSE to the second argument, allowing the derived class's
+vetoed by passing false to the second argument, allowing the derived class's
 constructor to call Initialize, possibly calling a different OnCreateFileHistory
 from the default.
 
@@ -277,6 +277,9 @@ Copies a suitable default name into {\it buf}. This is implemented by
 appending an integer counter to the string {\bf unnamed} and incrementing
 the counter.
 
+\perlnote{In wxPerl this function must return the modified name rather
+than just modifying the argument.}
+
 \membersection{wxDocManager::OnCreateFileHistory}
 
 \func{wxFileHistory *}{OnCreateFileHistory}{\void}
@@ -358,10 +361,16 @@ followed by a file selector.
 
 This function is used in wxDocManager::CreateDocument.
 
+\perlnote{In wxPerl {\tt templates} is a reference to a list of templates.
+If you override this method in your document manager it must return
+two values, eg:\par
+  (doctemplate, path) = My::DocManager->SelectDocumentPath( ... );
+}
+
 \membersection{wxDocManager::SelectDocumentType}
 
 \func{wxDocTemplate *}{SelectDocumentType}{\param{wxDocTemplate **}{templates},
- \param{int}{ noTemplates}, \param{bool}{ sort=FALSE}}
+ \param{int}{ noTemplates}, \param{bool}{ sort=false}}
 
 Returns a document template by asking the user (if there is more than one template).
 This function is used in wxDocManager::CreateDocument.
@@ -373,12 +382,14 @@ This function is used in wxDocManager::CreateDocument.
 \docparam{sort}{If more than one template is passed in in {\it templates}, 
 then this parameter indicates whether the list of templates that the user 
 will have to choose from is sorted or not when shown the choice box dialog.  
-Default is FALSE.}
+Default is false.}
+
+\perlnote{In wxPerl {\tt templates} is a reference to a list of templates.}
 
 \membersection{wxDocManager::SelectViewType}
 
 \func{wxDocTemplate *}{SelectViewType}{\param{wxDocTemplate **}{templates},
- \param{int}{ noTemplates}, \param{bool}{ sort=FALSE}}
+ \param{int}{ noTemplates}, \param{bool}{ sort=false}}
 
 Returns a document template by asking the user (if there is more than one template),
 displaying a list of valid views. This function is used in wxDocManager::CreateView.
@@ -392,7 +403,9 @@ those relevant to the document in question, and often there will only be one suc
 \docparam{sort}{If more than one template is passed in in {\it templates}, 
 then this parameter indicates whether the list of templates that the user 
 will have to choose from is sorted or not when shown the choice box dialog.  
-Default is FALSE.}
+Default is false.}
+
+\perlnote{In wxPerl {\tt templates} is a reference to a list of templates.}
 
 \membersection{wxDocManager::SetLastDirectory}\label{wxdocmanagersetlastdirectory}