KWSys 2017-06-09 (a700e2ab)

Code extracted from:

    https://gitlab.kitware.com/utils/kwsys.git

at commit a700e2ab06e2741e4955a1aa120293bf78b8fcac (master).

Upstream Shortlog
-----------------

Brad King (1):
      7e04a3d2 SystemTools: Remove RemoveEmptyPathElements method

1 files changed, 8 insertions, 4 deletions

diff --git a/SystemTools.hxx.in b/SystemTools.hxx.in
index 5e091c2..1672e92 100644
--- a/SystemTools.hxx.in
+++ b/SystemTools.hxx.in
@@ -461,6 +461,10 @@ public:
    * produce the original path.  Home directory references are
    * automatically expanded if expand_home_dir is true and this
    * platform supports them.
+   *
+   * This does *not* normalize the input path.  All components are
+   * preserved, including empty ones.  Typically callers should use
+   * this only on paths that have already been normalized.
    */
   static void SplitPath(const std::string& p,
                         std::vector<std::string>& components,
@@ -469,15 +473,15 @@ public:
   /**
    * Join components of a path name into a single string.  See
    * SplitPath for the format of the components.
+   *
+   * This does *not* normalize the input path.  All components are
+   * preserved, including empty ones.  Typically callers should use
+   * this only on paths that have already been normalized.
    */
   static std::string JoinPath(const std::vector<std::string>& components);
   static std::string JoinPath(std::vector<std::string>::const_iterator first,
                               std::vector<std::string>::const_iterator last);
 
-  /** Removes empty components from path.
-   */
-  static void RemoveEmptyPathElements(std::vector<std::string>& path);
-
   /**
    * Compare a path or components of a path.
    */