From 21de14b3311398f386f730cae582fe4d9da5a646 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Thu, 11 Jan 2007 16:41:43 +0000
Subject: [PATCH] use wxNO_LEN and wxCONV_FAILED symbolic constants instead of
 -1

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@44200 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/mbconv.tex | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/latex/wx/mbconv.tex b/docs/latex/wx/mbconv.tex
index 3f11aa5894..5b695f3cff 100644
--- a/docs/latex/wx/mbconv.tex
+++ b/docs/latex/wx/mbconv.tex
@@ -218,20 +218,21 @@ return type (without const).
 
 \membersection{wxMBConv::FromWChar}\label{wxmbconvfromwchar}
 
-\constfunc{virtual size\_t}{FromWChar}{\param{wchar\_t *}{dst}, \param{size\_t }{dstLen}, \param{const char *}{src}, \param{size\_t }{srcLen = $-1$}}
+\constfunc{virtual size\_t}{FromWChar}{\param{wchar\_t *}{dst}, \param{size\_t }{dstLen}, \param{const char *}{src}, \param{size\_t }{srcLen = wxNO\_LEN}}
 
 The most general function for converting a multibyte string to a wide string.
-The main case is when \arg{dst} is not \NULL and \arg{srcLen} is not $-1$: then
+The main case is when \arg{dst} is not \NULL and \arg{srcLen} is not 
+\texttt{wxNO\_LEN} (which is defined as \texttt{(size\_t)$-1$}): then
 the function converts exactly \arg{srcLen} bytes starting at \arg{src} into
 wide string which it output to \arg{dst}. If the length of the resulting wide
 string is greater than \arg{dstLen}, an error is returned. Note that if 
 \arg{srcLen} bytes don't include \NUL characters, the resulting wide string is
 not \NUL-terminated neither.
 
-If \arg{srcLen} is $-1$, the function supposes that the string is properly
-(i.e. as necessary for the encoding handled by this conversion) \NUL-terminated
-and converts the entire string, including any trailing \NUL bytes. In this case
-the wide string is also \NUL-terminated.
+If \arg{srcLen} is \texttt{wxNO\_LEN}, the function supposes that the string is
+properly (i.e. as necessary for the encoding handled by this conversion) 
+\NUL-terminated and converts the entire string, including any trailing \NUL 
+bytes. In this case the wide string is also \NUL-terminated.
 
 Finally, if \arg{dst} is \NULL, the function returns the length of the needed
 buffer.
@@ -262,12 +263,13 @@ trailing \NUL characters for any encoding.
 This function returns $1$ for most of the multibyte encodings in which the
 string is terminated by a single \NUL, $2$ for UTF-16 and $4$ for UTF-32 for
 which the string is terminated with $2$ and $4$ \NUL characters respectively.
-The other cases are not currently supported and $-1$ is returned for them.
+The other cases are not currently supported and \texttt{wxCONV\_FAILED} 
+(defined as $-1$) is returned for them.
 
 
 \membersection{wxMBConv::ToWChar}\label{wxmbconvtowchar}
 
-\constfunc{virtual size\_t}{ToWChar}{\param{char\_t *}{dst}, \param{size\_t }{dstLen}, \param{const wchar\_t *}{src}, \param{size\_t }{srcLen = $-1$}}
+\constfunc{virtual size\_t}{ToWChar}{\param{char\_t *}{dst}, \param{size\_t }{dstLen}, \param{const wchar\_t *}{src}, \param{size\_t }{srcLen = wxNO\_LEN}}
 
 This function has the same semantics as \helpref{FromWChar}{wxmbconvfromwchar} 
 except that it converts a wide string to multibyte one.
-- 
2.45.2

