Warn that normalizing a valid path may make it invalid sometimes.

Mention the special case of a path without file name and with directory that
normalizes to empty string.

See #10960.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@66255 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin 2010-11-24 12:43:45 +00:00
parent 89a1395ebc
commit fcf56ee4de

View File

@ -962,9 +962,16 @@ public:
int flags = 0);
/**
Normalize the path. With the default flags value, the path will be
made absolute, without any ".." and "." and all environment
variables will be expanded in it.
Normalize the path.
With the default flags value, the path will be made absolute, without
any ".." and "." and all environment variables will be expanded in it.
Notice that in some rare cases normalizing a valid path may result in
an invalid wxFileName object. E.g. normalizing "./" path using
wxPATH_NORM_DOTS but not wxPATH_NORM_ABSOLUTE will result in a
completely empty and thus invalid object. As long as there is a non
empty file name the result of normalization will be valid however.
@param flags
The kind of normalization to do with the file name. It can be