From 7f5bcc495495b6a4d4fbd4e6bceea26f560d9f7b Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 24 May 2018 14:33:12 +0200 Subject: Add note on relative path normalization --- libbutl/path.mxx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/libbutl/path.mxx b/libbutl/path.mxx index a0cdd90..c3bb42d 100644 --- a/libbutl/path.mxx +++ b/libbutl/path.mxx @@ -740,6 +740,10 @@ LIBBUTL_MODEXPORT namespace butl // unless sep is false, non-canonical directory separators. Empty path // is considered normalized. // + // Note that for a relative path normalize() may produce a path for which + // normalized() will still return false (for example, ../foo/../ which + // will be normalized to ../). + // bool normalized (bool sep = true) const; @@ -990,6 +994,10 @@ LIBBUTL_MODEXPORT namespace butl // Normally one can assume that "well-known" directories (current, home, // etc.) are returned in their actual spelling. // + // Note that for a relative path normalize() may produce a path for which + // normalized() will still return false (for example, ../foo/../ which + // will be normalized to ../). + // basic_path& normalize (bool actual = false, bool cur_empty = false); -- cgit v1.1