From 44571a5d2712b132a03f6d159feb9c872edbfa00 Mon Sep 17 00:00:00 2001
From: Julian Smart <julian@anthemion.co.uk>
Date: Tue, 6 May 2003 07:53:46 +0000
Subject: [PATCH] Doc clarifications

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_4_BRANCH@20496 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/colour.tex   |  4 +++-
 docs/latex/wx/font.tex     |  4 +++-
 docs/latex/wx/keyevent.tex |  6 +++---
 docs/latex/wx/listitem.tex |  3 +--
 docs/latex/wx/valtext.tex  | 12 ++++++++----
 docs/latex/wx/window.tex   | 17 +++++++----------
 docs/latex/wx/wxstring.tex |  2 ++
 7 files changed, 27 insertions(+), 21 deletions(-)

diff --git a/docs/latex/wx/colour.tex b/docs/latex/wx/colour.tex
index 06171474d8..7aad1266ed 100644
--- a/docs/latex/wx/colour.tex
+++ b/docs/latex/wx/colour.tex
@@ -7,6 +7,8 @@ named colour may be returned instead of creating a new colour.
 
 Valid RGB values are in the range 0 to 255.
 
+You can retrieve the current system font settings with \helpref{wxSystemSettings}{wxsystemsettings}.
+
 \wxheading{Derived from}
 
 \helpref{wxObject}{wxobject}
@@ -34,7 +36,7 @@ wxLIGHT\_GREY}
 \wxheading{See also}
 
 \helpref{wxColourDatabase}{wxcolourdatabase}, \helpref{wxPen}{wxpen}, \helpref{wxBrush}{wxbrush},\rtfsp
-\helpref{wxColourDialog}{wxcolourdialog}
+\helpref{wxColourDialog}{wxcolourdialog}, \helpref{wxSystemSettings}{wxsystemsettings}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
diff --git a/docs/latex/wx/font.tex b/docs/latex/wx/font.tex
index 349f507633..611e2584c5 100644
--- a/docs/latex/wx/font.tex
+++ b/docs/latex/wx/font.tex
@@ -4,6 +4,8 @@ A font is an object which determines the appearance of text. Fonts are
 used for drawing text to a device context, and setting the appearance of
 a window's text.
 
+You can retrieve the current system colour settings with \helpref{wxSystemSettings}{wxsystemsettings}.
+
 \wxheading{Derived from}
 
 \helpref{wxGDIObject}{wxgdiobject}\\
@@ -92,7 +94,7 @@ wxSWISS\_FONT}
 
 \helpref{wxFont overview}{wxfontoverview}, \helpref{wxDC::SetFont}{wxdcsetfont},\rtfsp
 \helpref{wxDC::DrawText}{wxdcdrawtext}, \helpref{wxDC::GetTextExtent}{wxdcgettextextent},\rtfsp
-\helpref{wxFontDialog}{wxfontdialog}
+\helpref{wxFontDialog}{wxfontdialog}, \helpref{wxSystemSettings}{wxsystemsettings}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
diff --git a/docs/latex/wx/keyevent.tex b/docs/latex/wx/keyevent.tex
index d6dbea27fb..027b874038 100644
--- a/docs/latex/wx/keyevent.tex
+++ b/docs/latex/wx/keyevent.tex
@@ -170,13 +170,13 @@ platform-dependent and should only be used in advanced applications.
 
 \constfunc{long}{GetX}{\void}
 
-Returns the X position of the event.
+Returns the X position (in client coordinates) of the event.
 
 \membersection{wxKeyEvent::GetY}
 
 \constfunc{long}{GetY}{\void}
 
-Returns the Y position of the event.
+Returns the Y position (in client coordinates) of the event.
 
 \membersection{wxKeyEvent::MetaDown}
 
@@ -190,7 +190,7 @@ Returns TRUE if the Meta key was down at the time of the key event.
 
 \constfunc{void}{GetPosition}{\param{long *}{x}, \param{long *}{y}}
 
-Obtains the position at which the key was pressed.
+Obtains the position (in client coordinates) at which the key was pressed.
 
 \membersection{wxKeyEvent::HasModifiers}
 
diff --git a/docs/latex/wx/listitem.tex b/docs/latex/wx/listitem.tex
index 1d8d713792..6ff8dc618d 100644
--- a/docs/latex/wx/listitem.tex
+++ b/docs/latex/wx/listitem.tex
@@ -169,8 +169,7 @@ into the image list.
 
 \func{void}{SetMask}{\param{long }{mask}}
 
-Sets the mask of valid fields. See
-\helpref{wxListItem::SetMask}{wxlistitemsetmask}.
+Sets the mask of valid fields. See \helpref{wxListItem::GetMask}{wxlistitemgetmask}.
 
 \membersection{wxListItem::SetState}\label{wxlistitemsetstate}
 
diff --git a/docs/latex/wx/valtext.tex b/docs/latex/wx/valtext.tex
index 87ca0bb22b..6973c0ca30 100644
--- a/docs/latex/wx/valtext.tex
+++ b/docs/latex/wx/valtext.tex
@@ -43,13 +43,17 @@ Constructor, taking a style and optional pointer to a wxString variable.
 \twocolitem{{\bf wxFILTER\_ALPHANUMERIC}}{Non-alphanumeric characters are filtered out.}
 \twocolitem{{\bf wxFILTER\_NUMERIC}}{Non-numeric characters are filtered out.}
 \twocolitem{{\bf wxFILTER\_INCLUDE\_LIST}}{Use an include list. The validator
-checks if the user input is on the list, complaining if not.}
+checks if the user input is on the list, complaining if not. See 
+\helpref{wxTextValidator::SetIncludeList}{wxtextvalidatorsetincludelist}.}
 \twocolitem{{\bf wxFILTER\_EXCLUDE\_LIST}}{Use an exclude list. The validator
-checks if the user input is on the list, complaining if it is.}
+checks if the user input is on the list, complaining if it is. See 
+\helpref{wxTextValidator::SetExcludeList}{wxtextvalidatorsetexcludelist}.}
 \twocolitem{{\bf wxFILTER\_INCLUDE\_CHAR\_LIST}}{Use an include list. The validator
-checks if each input character is in the list (one character per list element), complaining if not.}
+checks if each input character is in the list (one character per list element), complaining if not.
+See \helpref{wxTextValidator::SetIncludeList}{wxtextvalidatorsetincludelist}.}
 \twocolitem{{\bf wxFILTER\_EXCLUDE\_CHAR\_LIST}}{Use an include list. The validator
-checks if each input character is in the list (one character per list element), complaining if it is.}
+checks if each input character is in the list (one character per list element), complaining if it is.
+See \helpref{wxTextValidator::SetExcludeList}{wxtextvalidatorsetexcludelist}.}
 \end{twocollist}
 }
 
diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex
index 9775530617..7cdbc38fba 100644
--- a/docs/latex/wx/window.tex
+++ b/docs/latex/wx/window.tex
@@ -966,6 +966,12 @@ Gets the window's title. Applicable only to frames and dialogs.
 
 \membersection{wxWindow::GetUpdateRegion}\label{wxwindowgetupdateregion}
 
+\membersection{wxWindow::GetToolTip}\label{wxwindowgettooltip}
+
+\constfunc{wxToolTip*}{GetToolTip}{\void}
+
+Get the associated tooltip or NULL if none.
+
 \constfunc{virtual wxRegion}{GetUpdateRegion}{\void}
 
 Returns the region specifying which parts of the window have been damaged. Should
@@ -2592,15 +2598,7 @@ create a new validator of this type.
 Attach a tooltip to the window.
 
 See also: \helpref{GetToolTip}{wxwindowgettooltip},
-          \helpref{wxToolTip}{wxtooltip}
-
-
-\membersection{wxWindow::GetToolTip}\label{wxwindowgettooltip}
-
-\constfunc{wxToolTip*}{GetToolTip}{\void}
-
-Get the associated tooltip or NULL if none.
-
+ \helpref{wxToolTip}{wxtooltip}
 
 \membersection{wxWindow::SetVirtualSize}\label{wxwindowsetvirtualsize}
 
@@ -2610,7 +2608,6 @@ Get the associated tooltip or NULL if none.
 
 Sets the virtual size of the window in pixels.
 
-
 \membersection{wxWindow::SetVirtualSizeHints}\label{wxwindowsetvirtualsizehints}
 
 \func{virtual void}{SetVirtualSizeHints}{\param{int}{ minW},\param{int}{ minH}, \param{int}{ maxW=-1}, \param{int}{ maxH=-1}}
diff --git a/docs/latex/wx/wxstring.tex b/docs/latex/wx/wxstring.tex
index 1c45f72813..af1d85131b 100644
--- a/docs/latex/wx/wxstring.tex
+++ b/docs/latex/wx/wxstring.tex
@@ -638,6 +638,8 @@ Returns a reference to the character at position {\it n}.
 \func{char*}{GetWriteBuf}{\param{size\_t}{ len}}
 
 Returns a writable buffer of at least {\it len} bytes.
+It returns a pointer to a new memory block, and the
+existing data will not be copied.
 
 Call \helpref{wxString::UngetWriteBuf}{wxstringungetwritebuf} as soon as possible
 to put the string back into a reasonable state.