define _HPUX_SOURCE under HP-UX, otherwise many things are not defined in standard...

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

diff --git a/docs/latex/wx/stdpaths.tex b/docs/latex/wx/stdpaths.tex
index a4252831c3d8d380db6acd0c60d946dcfc65d6e8..8e1817a43c6e333ab79cbeede03bbc86a7e33929 100644 (file)
--- a/docs/latex/wx/stdpaths.tex
+++ b/docs/latex/wx/stdpaths.tex
@@ -6,17 +6,13 @@
 %% Created:     2004-10-17
 %% RCS-ID:      $Id$
 %% Copyright:   (c) 2004 Vadim Zeitlin <vadim@wxwindows.org>
 %% Created:     2004-10-17
 %% RCS-ID:      $Id$
 %% Copyright:   (c) 2004 Vadim Zeitlin <vadim@wxwindows.org>

-%% License:     wxWidgets license
+%% License:     wxWindows license

 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxStandardPaths}}\label{wxstandardpaths}
 
 wxStandardPaths returns the standard locations in the file system and should be
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxStandardPaths}}\label{wxstandardpaths}
 
 wxStandardPaths returns the standard locations in the file system and should be

-used by the programs to find their data files in a portable way.
-
-Please note that this is not a real class because object of this type are never
-created but more a namespace containing the class methods which are all static,
-so to use wxStandardPaths simply call its methods directly.
+used by applications to find their data files in a portable way.

 
 In the description of the methods below, the example return values are given
 for the Unix, Windows and Mac OS X systems, however please note that these are
 
 In the description of the methods below, the example return values are given
 for the Unix, Windows and Mac OS X systems, however please note that these are


@@ -49,15 +45,22 @@ No base class
 
 \wxheading{Include files}
 
 
 \wxheading{Include files}
 

-<wx/fileloc.h>
+<wx/stdpaths.h>

 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 

+\membersection{wxStandardPaths::Get}\label{wxstandardpathsget}
+
+\func{static wxStandardPathsBase\&}{Get}{\void}
+
+Returns reference to the unique global standard paths object.
+
+

 \membersection{wxStandardPaths::GetConfigDir}\label{wxstandardpathsgetconfigdir}
 
 \membersection{wxStandardPaths::GetConfigDir}\label{wxstandardpathsgetconfigdir}
 

-\func{static wxString}{GetConfigDir}{\void}
+\func{wxString}{GetConfigDir}{\void}

 
 Return the directory containing the system config files.
 
 
 Return the directory containing the system config files.
 


@@ -75,7 +78,7 @@ Example return values:
 
 \membersection{wxStandardPaths::GetDataDir}\label{wxstandardpathsgetdatadir}
 
 
 \membersection{wxStandardPaths::GetDataDir}\label{wxstandardpathsgetdatadir}
 

-\func{static wxString}{GetDataDir}{\void}
+\func{wxString}{GetDataDir}{\void}

 
 Return the location of the applications global, i.e. not user-specific,
 data files.
 
 Return the location of the applications global, i.e. not user-specific,
 data files.


@@ -83,7 +86,7 @@ data files.
 Example return values:
 \begin{itemize}
     \item Unix: \texttt{\textit{prefix}/share/\textit{appname}}
 Example return values:
 \begin{itemize}
     \item Unix: \texttt{\textit{prefix}/share/\textit{appname}}

-    \item Windows: \texttt{C:$\backslash$Program Files$\backslash$\textit{appname}}
+    \item Windows: the directory where the executable file is located

     \item Mac: \texttt{\textit{appname}.app/Contents/SharedSupport} bundle subdirectory
 \end{itemize}
 
     \item Mac: \texttt{\textit{appname}.app/Contents/SharedSupport} bundle subdirectory
 \end{itemize}
 


@@ -94,7 +97,7 @@ Example return values:
 
 \membersection{wxStandardPaths::GetInstallPrefix}\label{wxstandardpathsgetinstallprefix}
 
 
 \membersection{wxStandardPaths::GetInstallPrefix}\label{wxstandardpathsgetinstallprefix}
 

-\func{static wxString}{GetInstallPrefix}{\void}
+\func{wxString}{GetInstallPrefix}{\void}

 
 \textbf{Note: } This function is only available under Unix.
 
 
 \textbf{Note: } This function is only available under Unix.
 


@@ -109,7 +112,7 @@ now) and finally returns the default \texttt{/usr/local} value if it failed.
 
 \membersection{wxStandardPaths::GetLocalDataDir}\label{wxstandardpathsgetlocaldatadir}
 
 
 \membersection{wxStandardPaths::GetLocalDataDir}\label{wxstandardpathsgetlocaldatadir}
 

-\func{static wxString}{GetLocalDataDir}{\void}
+\func{wxString}{GetLocalDataDir}{\void}

 
 Return the location for application data files which are host-specific and
 can't, or shouldn't, be shared with the other machines.
 
 Return the location for application data files which are host-specific and
 can't, or shouldn't, be shared with the other machines.


@@ -120,7 +123,7 @@ under Unix where it returns \texttt{/etc/\textit{appname}}.
 
 \membersection{wxStandardPaths::GetPluginsDir}\label{wxstandardpathsgetpluginsdir}
 
 
 \membersection{wxStandardPaths::GetPluginsDir}\label{wxstandardpathsgetpluginsdir}
 

-\func{static wxString}{GetPluginsDir}{\void}
+\func{wxString}{GetPluginsDir}{\void}

 
 Return the directory where the loadable modules (plugins) live.
 
 
 Return the directory where the loadable modules (plugins) live.
 


@@ -138,12 +141,12 @@ Example return values:
 
 \membersection{wxStandardPaths::GetUserConfigDir}\label{wxstandardpathsgetuserconfigdir}
 
 
 \membersection{wxStandardPaths::GetUserConfigDir}\label{wxstandardpathsgetuserconfigdir}
 

-\func{static wxString}{GetUserConfigDir}{\void}
+\func{wxString}{GetUserConfigDir}{\void}

 
 Return the directory for the user config files:
 \begin{itemize}
     \item Unix: \tt{~} (the home directory)
 
 Return the directory for the user config files:
 \begin{itemize}
     \item Unix: \tt{~} (the home directory)

-    \item Windows: \tt{C:\\Documents and Settings\\\textit{username}}
+    \item Windows: \tt{C:$\backslash$Documents and Settings$\backslash$\textit{username}}

     \item Mac: \tt{~/Library/Preferences}
 \end{itemize}
 
     \item Mac: \tt{~/Library/Preferences}
 \end{itemize}
 


@@ -154,19 +157,19 @@ more appropriate.
 
 \membersection{wxStandardPaths::GetUserDataDir}\label{wxstandardpathsgetuserdatadir}
 
 
 \membersection{wxStandardPaths::GetUserDataDir}\label{wxstandardpathsgetuserdatadir}
 

-\func{static wxString}{GetUserDataDir}{\void}
+\func{wxString}{GetUserDataDir}{\void}

 
 Return the directory for the user-dependent application data files:
 \begin{itemize}
     \item Unix: \tt{~/.\textit{appname}}
 
 Return the directory for the user-dependent application data files:
 \begin{itemize}
     \item Unix: \tt{~/.\textit{appname}}

-    \item Windows: \tt{C:\\Documents and Settings\\\textit{username}\\Application Data\\\textit{appname}}
+    \item Windows: \tt{C:$\backslash$Documents and Settings$\backslash$\textit{username}$\backslash$Application Data$\backslash$\textit{appname}}

     \item Mac: \tt{~/Library/Application Support/\textit{appname}}
 \end{itemize}
 
 
 \membersection{wxStandardPaths::GetUserLocalDataDir}\label{wxstandardpathsgetuserlocaldatadir}
 
     \item Mac: \tt{~/Library/Application Support/\textit{appname}}
 \end{itemize}
 
 
 \membersection{wxStandardPaths::GetUserLocalDataDir}\label{wxstandardpathsgetuserlocaldatadir}
 

-\func{static wxString}{GetUserLocalDataDir}{\void}
+\func{wxString}{GetUserLocalDataDir}{\void}

 
 Return the directory for user data files which shouldn't be shared with
 the other machines.
 
 Return the directory for user data files which shouldn't be shared with
 the other machines.


@@ -178,9 +181,9 @@ all platforms except Windows where it returns
 
 \membersection{wxStandardPaths::SetInstallPrefix}\label{wxstandardpathssetinstallprefix}
 
 
 \membersection{wxStandardPaths::SetInstallPrefix}\label{wxstandardpathssetinstallprefix}
 

-\func{static void}{SetInstallPrefix}{\param{const wxString\& }{prefix}}
+\func{void}{SetInstallPrefix}{\param{const wxString\& }{prefix}}

 
 

-\textbf{Note: } This function is only available under Unix.
+\textbf{Note:} This function is only available under Unix.

 
 Lets wxStandardPaths know about the real program installation prefix on a Unix
 system. By default, the value returned by 
 
 Lets wxStandardPaths know about the real program installation prefix on a Unix
 system. By default, the value returned by