X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4f83b9fc549a66de1e76362c9b1ff78236ef7ec7..4311588bfe40e15dc83154b9653ebc432b42baeb:/interface/wx/stdpaths.h diff --git a/interface/wx/stdpaths.h b/interface/wx/stdpaths.h index 22a36bdb30..88c37c870b 100644 --- a/interface/wx/stdpaths.h +++ b/interface/wx/stdpaths.h @@ -22,8 +22,8 @@ Notice that in the examples below the string @c appinfo may be either just the application name (as returned by wxApp::GetAppName()) or a combination of the vendor name (wxApp::GetVendorName()) and the application name, with - a path separator between them. By default, the vendor name is used under - Windows and OS X but not under other Unix systems, see UseAppInfo(). + a path separator between them. By default, only the application name is + used, use UseAppInfo() to change this. The other placeholders should be self-explanatory: the string @c username should be replaced with the value the name of the currently logged in user. @@ -103,11 +103,20 @@ public: /** Return the location of the applications global, i.e. not user-specific, data files. + Example return values: - Unix: @c prefix/share/appinfo - Windows: the directory where the executable file is located - Mac: @c appinfo.app/Contents/SharedSupport bundle subdirectory + Under Unix (only) it is possible to override the default value returned + from this function by setting the value of @c WX_APPNAME_DATA_DIR + environment variable to the directory to use (where @c APPNAME is the + upper-cased value of wxApp::GetAppName()). This is useful in order to + be able to run applications using this function without installing them + as you can simply set this environment variable to the source directory + location to allow the application to find its files there. + @see GetLocalDataDir() */ virtual wxString GetDataDir() const; @@ -327,8 +336,7 @@ public: used combined with AppInfo_AppName, i.e. as @code AppInfo_AppName | AppInfo_VendorName @endcode - By default, only the application name is used under Unix systems but both - application and vendor names are used under Windows and Mac. + By default, only the application name is used. @since 2.9.0 */