X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/9c3d92c56bc2663e2edf04844a307bafcaefea0e..21dc4be5d27fd73cda55795ab9d1e7e02b494c46:/docs/latex/wx/mbcnvfil.tex diff --git a/docs/latex/wx/mbcnvfil.tex b/docs/latex/wx/mbcnvfil.tex index e5e04f8b7a..2ed8c847df 100644 --- a/docs/latex/wx/mbcnvfil.tex +++ b/docs/latex/wx/mbcnvfil.tex @@ -5,13 +5,23 @@ \section{\class{wxMBConvFile}}\label{wxmbconvfile} -This class converts file names between filesystem multibyte encoding and -Unicode. It has one predefined instance, {\bf wxConvFileName}. -Since some platforms (e.g. Win32) use Unicode in the filenames, -and others (e.g. Unix) use multibyte encodings, this class should only +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 +filesystem multibyte encoding and Unicode. {\bf wxConvFileName} +can also be set to a something else at run-time which is used +e.g. by wxGTK to use a class which checks the environment +variable {\bf G_FILESYSTEM_ENCODING} indicating that filenames +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 (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 wxConvFile.cWX2MB in this case. You could use it -like this: +wxFNCONV, is defined to wxConvFileName->cWX2MB in this case. You could +use it like this: \begin{verbatim} wxChar *name = wxT("rawfile.doc");