libs/filesystem/doc/release_history.html

   1 <html>
   2
   3 <head>
   4 <meta http-equiv="Content-Language" content="en-us">
   5 <meta name="GENERATOR" content="Microsoft FrontPage 5.0">
   6 <meta name="ProgId" content="FrontPage.Editor.Document">
   7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   8 <title>Filesystem Release History</title>
   9 <link href="styles.css" rel="stylesheet">
  10 </head>
  11
  12 <body>
  13
  14 <table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111">
  15   <tr>
  16     <td width="277">
  17 <a href="../../../index.htm">
  18 <img src="../../../boost.png" alt="boost.png (6897 bytes)" align="middle" width="300" height="86" border="0"></a></td>
  19     <td align="middle">
  20     <font size="7">Filesystem Release History</font>
  21     </td>
  22   </tr>
  23 </table>
  24
  25 <table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse"
  26  bordercolor="#111111" bgcolor="#D7EEFF" width="100%">
  27   <tr>
  28     <td><a href="index.htm">Home</a> &nbsp;&nbsp;
  29     <a href="tutorial.html">Tutorial</a> &nbsp;&nbsp;
  30     <a href="reference.html">Reference</a> &nbsp;&nbsp;
  31     <a href="faq.htm">FAQ</a> &nbsp;&nbsp;
  32     <a href="release_history.html">Releases</a> &nbsp;&nbsp;
  33     <a href="portability_guide.htm">Portability</a> &nbsp;&nbsp;
  34     <a href="v3.html">V3 Intro</a> &nbsp;&nbsp;
  35     <a href="v3_design.html">V3 Design</a> &nbsp;&nbsp;
  36     <a href="deprecated.html">Deprecated</a> &nbsp;&nbsp;
  37     <a href="issue_reporting.html">Bug Reports </a>&nbsp;&nbsp;
  38     </td>
  39 </table>
  40
  41 <h2>1.72.0</h2>
  42 <ul>
  43   <li>Extracted <code>filesystem_error</code> to <code>exception.hpp</code>; <code>file_status</code> and associated enums and functions to <code>file_status.hpp</code>; <code>directory_entry</code>, <code>directory_iterator</code> and <code>recursive_directory_iterator</code> to <code>directory.hpp</code>.</li>
  44   <li><b>Deprecated:</b> For backward compatibility <code>operations.hpp</code> still includes the new headers <code>exception.hpp</code>, <code>file_status.hpp</code> and <code>directory.hpp</code>, unless <code>BOOST_FILESYSTEM_NO_DEPRECATED</code> macro is defined. These implicit includes are considered deprecated and will be removed in a future release. Users are encouraged to include the new headers directly or include <code>filesystem.hpp</code>.</li>
  45   <li>The <code>filesystem_error</code> exception is now implemented in the compiled library of Boost.Filesystem. Users may need to add linking with Boost.Filesystem library in their projects.</li>
  46   <li>On POSIX.1-2008 platforms, use <code>utimensat</code> instead of <code>utime</code>. <code>utime</code> is declared obsolete in POSIX.1-2008 and can be disabled e.g. in uClibc-ng. (<a href="https://github.com/boostorg/filesystem/pull/115">PR#115</a>)</li>
  47   <li><code>directory_iterator</code> is now left in the end state on memory allocation errors.</li>
  48   <li>In <code>directory_iterator</code> on POSIX systems, support for <code>readdir</code>/<code>readdir_r</code> has been reworked to avoid memory allocations for <code>dirent</code> structures when <code>readdir</code> is used. This reduces memory consumption and eliminates the possibility of buffer overruns in case if <code>readdir</code> produces a very long directory name.</li>
  49   <li>On Windows, use Boost.WinAPI to select the target Windows version.</li>
  50   <li><b>New:</b> Added <code>directory_options</code> enum, which reflects the same named enum from C++20. The enum is supported in <code>directory_iterator</code> and <code>recursive_directory_iterator</code> to customize iteration behavior. In particular, the iterators now support skipping directories that can&apos;t be opened due to insufficient permissions. The <code>symlink_option</code> enum is now deprecated and should be replaced with <code>directory_options</code>.</li>
  51   <li>By default, <code>recursive_directory_iterator</code> is now reset to the end state in case of errors, as required by C++20. (<a href="https://github.com/boostorg/filesystem/issues/112">#112</a>)</li>
  52   <li><b>New:</b> Added <code>directory_options::pop_on_error</code> option, which configures <code>recursive_directory_iterator</code> so that it attempts to recover from iteration errors by repeatedly invoking <code>pop()</code> until it succeeds or the end state is reached. (<a href="https://github.com/boostorg/filesystem/issues/113">#113</a>)</li>
  53   <li><b>New:</b> Added <code>directory_options::skip_dangling_symlinks</code> option, which configures <code>recursive_directory_iterator</code> so that it doesn't follow dangling directory symlinks and continues iteration instead of reporting an error.</li>
  54   <li><b>Deprecated:</b> The following members of <code>recursive_directory_iterator</code> are now marked as deprecated: <code>level()</code>, <code>no_push_pending()</code>, <code>no_push_request()</code>, <code>no_push()</code>. Users are advised to replace their use with the standard counterparts: <code>depth()</code>, <code>recursion_pending()</code>, <code>disable_recursion_pending()</code>. Note that <code>recursion_pending()</code> has the opposite meaning compared to <code>no_push_pending()</code> and <code>no_push_request()</code>. Deprecated methods will be removed in a future release.</li>
  55   <li>Fixed <code>path::lexically_relative</code> (and any dependent algorithms) to correctly handle empty, dot and dot-dot path elements in its argument. The behavior is made closer to C++17 <code>std::path::lexically_relative</code> in that empty and dot path elements are ignored and dot-dot path elements are accounted by decreasing the number of dot-dot path elements to generate in the resulting relative path. (<a href="https://github.com/boostorg/filesystem/issues/76">#76</a>)</li>
  56 </ul>
  57
  58 <h2>1.71.0</h2>
  59 <ul>
  60   <li><b>New:</b> Added minimal support for CMake. (<a href="https://github.com/boostorg/filesystem/pull/106">PR#106</a>)</li>
  61   <li>Fixed incorrect <code>error_code</code> returned from directory iterator increment when <code>readdir_r</code> is used.</li>
  62   <li>For <code>path</code>, fixed rvalue-aware <code>operator/</code> return type to return an rvalue instead of rvalue reference. This fixes leaving a dangling reference in the user&apos;s code if the result of <code>operator/</code> is bound to a const reference. (<a href="https://github.com/boostorg/filesystem/issues/110">#110</a>)</li>
  63   <li>Fixes for better compatibility with Windows CE. (<a href="https://github.com/boostorg/filesystem/pull/24">PR#24</a>)</li>
  64 </ul>
  65
  66 <h2>1.70.0</h2>
  67 <ul>
  68   <li><b>New:</b> Added support for movability to directory iterators.</li>
  69   <li><b>New:</b> Added file status query overloads for directory_entry. This avoids a relatively expensive OS query when file status is requested for a result of dereferencing a directory iterator. (<a href="https://github.com/boostorg/filesystem/pull/55">PR#55</a>)</li>
  70   <li>Fixed a few instances of dereferencing <code>std::string::end()</code> in path implementation.</li>
  71   <li>Fixed program termination in case of out of memory condition in directory iterators constructors and operations accepting a reference to <code>error_code</code>. (<a href="https://github.com/boostorg/filesystem/issues/58">#58</a>)</li>
  72   <li>Fixed possible linking errors caused by missing definitions of static members of <code>path</code>. (<a href="https://svn.boost.org/trac/boost/ticket/12759">#12759</a>)</li>
  73   <li>Fixed possible use of uninitialized data in directory iterator increment operation on Linux. (<a href="https://github.com/boostorg/filesystem/issues/97">#97</a>)</li>
  74   <li>Reworked <code>current_path</code> and <code>read_symlink</code> implementation to avoid possible memory exhaustion on broken or tampered with filesystems. The functions now have an internal limit of the path size they will accept from the OS, which is currently 16 MiB.</li>
  75   <li>Increased the size of the internal buffer used by <code>copy_file</code>.</li>
  76 </ul>
  77
  78 <h2>1.69.0</h2>
  79 <ul>
  80   <li>Don&apos;t use <code>readdir_r</code> on Linux and Android since the <code>readdir</code> function is already thread-safe. (<a href="https://github.com/boostorg/filesystem/pull/68">PR#68</a>,
  81     <a href="https://github.com/boostorg/filesystem/issues/72/">#72</a>)</li>
  82   <li>Fixed crashes in <code>boost::filesystem::copy</code> due to undefined behavior in the implementation. (<a href="https://github.com/boostorg/filesystem/pull/71">PR#71</a>)</li>
  83   <li>Fixed undefined behavior in <code>boost::filesystem::directory_iterator</code> implementation. (<a href="https://github.com/boostorg/filesystem/pull/77">PR#77</a>)</li>
  84   <li>Fixed compilation errors when using directory iterators with <code>BOOST_FOREACH</code>.</li>
  85   <li>Removed workarounds for older PGI C++ compiler versions to fix compilation on the newer ones. (<a href="https://github.com/boostorg/filesystem/pull/49">PR#49</a>)</li>
  86   <li>Fixed MSVC warnings about narrowing conversions. (<a href="https://github.com/boostorg/filesystem/pull/44">PR#44</a>)</li>
  87 </ul>
  88
  89 <h2>1.67.0</h2>
  90 <ul>
  91   <li>Fix static initialization issue that caused a crash if path operations were used before main(). (<a href="https://github.com/boostorg/filesystem/pull/62">PR#62</a>,
  92     <a href="https://github.com/boostorg/filesystem/pull/43">PR#43</a>, <a href="https://github.com/boostorg/filesystem/pull/50">PR#50</a>, <a href="https://github.com/boostorg/filesystem/pull/59">PR#59</a>)</li>
  93 </ul>
  94
  95 <h2>1.66.0</h2>
  96 <ul>
  97   <li>Clean up some tutorial example code and fix the wording for it in the
  98   tutorial. Thanks to Anmol-Singh-Jaggi for pull request <a href="https://github.com/boostorg/filesystem/pull/11">#11</a>.</li>
  99 </ul>
 100
 101 <h2>1.64.0</h2>
 102 <ul>
 103   <li><code>is_empty()</code>overload with <code>error_code</code> parameter
 104   should not throw on error. Thanks to ldqrk for pull request #42</li>
 105   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/10731">#10731</a> and
 106   <a href="https://svn.boost.org/trac/boost/ticket/9480">#9480</a>, <i>Evaluate
 107   path.extension only once</i>. Thanks to Daniel Krügler for pull request #41.</li>
 108   <li>Fix error propagation in <code>space(p, ec)</code>. Thanks to cmuellner
 109   for pull request #39.</li>
 110   <li>Add test/config_info.cpp to increase macro state reporting in hopes of
 111   easing debugging on remote machines.</li>
 112   <li>Fix <code>operations_test</code> failure on MinGW: MinGW defines
 113   __MINGW32__ rather than _MSC_VER, so also test for __MINGW32__ to see if
 114   setenv/unsetenv workaround needed.</li>
 115 </ul>
 116
 117 <h2>1.63.0</h2>
 118 <ul>
 119   <li dir="ltr">
 120   <p dir="ltr"><b>Deprecated <code>generic()</code> function name</b>: The undocumented experimental class
 121   <code>path</code> member function <code>generic()</code> has been renamed <code>
 122   generic_path()</code>. Fixes
 123   <a href="https://svn.boost.org/trac/boost/ticket/11855">#11855</a>, <i>generic
 124   gives problems in C++/CLI.</i> Unless the macro BOOST_FILESYSTEM_NO_DEPRECATED
 125   is defined, the original <code>generic()</code> will continue to be supplied
 126   as a workaround for existing user code. But <code>generic()</code>is
 127   deprecated. User code should migrate to the new name.</li>
 128   <li><b>New:</b> Class <code>path</code> adds constexpr constants <code>
 129   separator</code> and <code>dot</code> of the type appropriate for the
 130   platform, and adds query functions <a href="reference.html#filename_is_dot">
 131   <code>filename_is_do</code>t</a> and <code>
 132   <a href="reference.html#filename_is_dot_dot">filename_is_dot_dot</a></code>.
 133   These add convenience and the implementations may be more efficient that user
 134   coded equivalent functions.</li>
 135   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/12578">#12578</a>, <i>
 136   Make directory iterators able to detect when a copy has advanced to the end</i>.
 137   This bug in <code>directory_iterator</code> and <code>
 138   recursive_directory_iterator</code> equality testing has existed more than a
 139   dozen years. Nowadays test driven development would likely have detected the
 140   problem in early development. Sigh.</li>
 141   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/12495">#12495</a>, <i>
 142   <code>create_directories()</code> crashes when passed empty string as path</i>,
 143   from Samantha Ritter. Also affected <code>create_directory()</code>. Charles
 144   Olivi submitted a pull request with some particularly helpful test cases.</li>
 145   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/7307">#7307</a>, <i>
 146   remove_all(dirname,ec) throws on write protected directories.</i> This is a
 147   tough one to test. There are three internal function calls where errors might
 148   arise, and it would take too much time to write tests for each of those cases.
 149   Someday we will have Titus Winter&#39;s mock installable file system, but for now
 150   are relying on code inspection rather than testing.</li>
 151   <li>Fix a cygwin warning and a cygwin error. Thanks to thtrummer for pull
 152   request #30.</li>
 153   <li>Fixed two broken links in reference docs. Thanks to tbeu for pull
 154   request #34.</li>
 155   <li>Fix reference doc signatures for <code>path</code> stem(), extension()
 156   member functions. Thanks to faithandbrave for pull request #31</li>
 157   <li>Fix broken link to <a href="https://svn.boost.org/trac/boost/ticket/7506">#7506</a> in 1.60.0 Release History (Daniel Krügler).</li>
 158   <li>Refactor <code>push_directory()</code>internal logic so it is easier to
 159   reason about.</li>
 160 </ul>
 161
 162 <h2>1.60.0</h2>
 163 <ul>
 164   <li dir="ltr">
 165   <p dir="ltr"><b>New:</b> Added functions <code>
 166   <a href="reference.html#lex-normal">lexically_normal</a></code>, <code>
 167   <a href="reference.html#lex-relative">lexically_relative</a></code>, <code>
 168   <a href="reference.html#op-relative">relative</a></code>, and <code>
 169   <a href="reference.html#weakly_canonical">weakly_canonical</a></code>. Many thanks to Jamie Allsop for his help and
 170   perseverance. Resolves tickets
 171   <a href="https://svn.boost.org/trac/boost/ticket/1976">#1976</a>,
 172   <a href="https://svn.boost.org/trac/boost/ticket/5897">#5897</a>,
 173   <a href="https://svn.boost.org/trac/boost/ticket/6249">#6249</a></li>
 174   <li><b>New:</b> Class <code>path</code> now has
 175   <a href="reference.html#path-iterators"> <code>reverse_iterator</code>,
 176   <code>const_reverse_iterator</code>, <code>rbegin()</code>, and <code>rend()</code></a>. </li>
 177   <li><b>New:</b> C++11 <code>noexcept</code> supplied as specified in the
 178   Filesystem TS if supported by the compiler.</li>
 179   <li><b>New:</b> C++11 move constructors and move assignments supplied as
 180   specified in the Filesystem TS if supported by the compiler. Resolves
 181   <a href="https://svn.boost.org/trac/boost/ticket/10291">#10291</a>.</li>
 182   <li><b>New:</b> Existing functions whose names changed in the Filesystem TS
 183   are now supported under both the old and new names.</li>
 184   <li><b>New: </b>Added <code><a href="reference.html#path-size">size</a>()</code>
 185   function to class <code>path</code>. Resolves
 186   <a href="https://svn.boost.org/trac/boost/ticket/6874">#6874</a>, <i>Path
 187   should have a size() member function</i>.</li>
 188   <li>Clear several spurious GCC warnings.</li>
 189   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/11733">#11733</a>, <i>
 190   Missing unistd.h include in boost/libs/filesystem/src/unique_path.cpp</i> by
 191   apply a patch from Idar Tollefsen.</li>
 192   <li>Fix a race condition in <code>unique_path</code> by applying
 193   <a href="https://github.com/boostorg/filesystem/pull/15">pull request #15</a>
 194   from Sebastian Redl. Also fixes
 195   <a href="https://svn.boost.org/trac/boost/ticket/7506">#7506</a>, <i><code>unique_path</code> Fails on Windows for Temporary User
 196   Profiles</i>.</li>
 197   <li>Fix bug in <i><code>file_status</code></i> and <i><code>
 198   recursive_directory_iterator</code></i>: C++ turns an explicit constructor
 199   with all arguments except first defaulted into non-explicit single argument
 200   constructor.</li>
 201   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/10591">#10591</a>, <i>
 202   boost::filesystem does not build on iOS 8</i>, by applying a patch submitted
 203   by Daniel Seither.</li>
 204   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/9454">#9454</a>, <i>
 205   Boost Filesystem [library build] not compiling when
 206   BOOST_FILESYSTEM_NO_DEPRECATED is defined</i>, by applying a patch submitted
 207   by Makesim.</li>
 208   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/11447">#11447</a>, <i>
 209   __OpenBSD__ macro name misspelled</i>, by applying a patch submitted by Jasper
 210   Lievisse Adriaanse.</li>
 211   <li>
 212   <p>Fix <a href="https://svn.boost.org/trac/boost/ticket/11288">#11288</a>, <i>
 213   <font face="Arial">A patch to avoid redundant string allocations</font></i>,
 214   by applying a patch submitted by Yevhen Ivannikov.</li>
 215   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/11175">#11175</a>,
 216   out-of-date documentation causing users to incorrectly expect that the library
 217   could be used with exceptions disabled.</li>
 218   <li>Resolve <a href="https://svn.boost.org/trac/boost/ticket/11175">#11166</a>
 219   by mitigating (i.e. reducing the likelihood of) a possible external file
 220   system race in <code>remove()</code>.</li>
 221   <li>
 222   <p>Fix <a href="https://svn.boost.org/trac/boost/ticket/7258">#7258</a>,
 223   <i><code>create_directories</code> returns false if the path ends with a slash</i>.
 224   Also fix related issues if path contains <i>dot</i> or <i>dot-dot</i>
 225   elements, and added test cases to the test suite.</li>
 226   <li>
 227   <p>Reference docs editorial cleanups: Use same style sheet as the
 228   rest of the documentation. Tweak tab font size. Fix excessively long lines in
 229   tables, synopsis.</li>
 230   <li>Resolve <a href="https://svn.boost.org/trac/boost/ticket/10766">
 231   #10766</a>, <i>parent_path() with redundant separator returns wrong value</i>,
 232   by adding examples and notes to the reference documentation to show why the
 233   returned value is in fact correct, and to provide rationale for that behavior.
 234   See <a href="reference.html#path-iterators">[path.itr]</a>, and
 235   <a href="reference.html#path-decomposition">[path.decompose]</a> <code>
 236   parent_path()</code> and <code>filename()</code> sections of the reference
 237   docs.</li>
 238   <li>Minor other fixes, including pull requests from Jonathan Wakely and Marcel
 239   Raad.</li>
 240   <li>Closed several tickets as duplicates or otherwise resolved by the
 241   above changes:<ul>
 242   <li><a href="https://svn.boost.org/trac/boost/ticket/7607">#7607</a>, <i>path
 243   should not infer an invisible &quot;.&quot; at the end of a path that ends with a slash;
 244   </i><a href="https://svn.boost.org/trac/boost/ticket/7258">#7258</a>,
 245   <a href="https://svn.boost.org/trac/boost/ticket/10766">#10766</a></li>
 246   <li><a href="https://svn.boost.org/trac/boost/ticket/11061">#11061</a>,
 247   <a href="https://svn.boost.org/trac/boost/ticket/11062">#11062</a>, <i>
 248   impossible to traverse the path of the reverse iterator</i>, is effectively
 249   resolved by the addition of the class <code>path</code> reverse iteration
 250   feature. The reference documentation has also been updated with
 251   <a href="reference.html#path-iterators">a note</a> warning about the
 252   limitations of class <code>path</code> iterators.</li>
 253 </ul>
 254
 255   </li>
 256 </ul>
 257
 258 <h2>1.59.0</h2>
 259 <ul>
 260   <li>Update the Tutorial:<ul>
 261     <li>Use C++11 in the example programs to improve clarity.</li>
 262     <li>Update the example source code show to match the actual example source
 263     code in the cpp files.</li>
 264     <li>Rerun all the examples and update the output shown in the tutorial
 265     accordingly.</li>
 266     <li>Fix spacing and other HTML presentation issues.</li>
 267   </ul>
 268   </li>
 269   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/11491">#11491</a>, <i>
 270   <code>temp_directory_path()</code> doesn&#39;t return valid temp path on Android</i>.</li>
 271 </ul>
 272
 273 <h2>1.58.0</h2>
 274 <ul>
 275   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/6124">#6124</a>,
 276   <a href="https://svn.boost.org/trac/boost/ticket/6779">#6779</a>, and
 277   <a href="https://svn.boost.org/trac/boost/ticket/10038">#10038</a>. Cannot
 278   pass a BOOST_SCOPED_ENUM to a compiled function because it will result in an
 279   undefined reference if the library is compiled with -std=c++0x but the use is
 280   compiled in C++03 mode, or visa versa.</li>
 281   <li>Rewrite Windows implementation of <code>temp_directory_path()</code> to (1) avoid
 282   <code>GetTempPath()</code> failure if path length &gt; 130 (ticket #5300) and (2) provide a
 283   more sensible sequence of directories than provided by <code>GetTempPath()</code>, per
 284   boost list discussion &quot;[filesystem] temp_directory_path() behavior on
 285   Windows&quot;. The new sequence is:<ol>
 286     <li><i><code>%TMP%</code></i></li>
 287     <li><i><code>%TEMP%</code></i></li>
 288     <li><code><i>%LOCALAPPDATA%</i>/Temp</code></li>
 289     <li><code><i>%USERPROFILE%</i>/Temp</code></li>
 290     <li><code><i>GetWindowsDirectoryW()</i>/Temp</code></li>
 291   </ol>
 292   </li>
 293 </ul>
 294
 295 <h2>1.57.0</h2>
 296 <ul>
 297   <li>Rework class <code>path</code> locale and codecvt implementation for increased reliability.
 298   This change was SVN revision 83021, which should have gone into 1.56.0 but
 299   unfortunately the merge didn't happen until too late.</li>
 300   <li>Fix tickets <a href="https://svn.boost.org/trac/boost/ticket/8930">#8930</a>, <a href="https://svn.boost.org/trac/boost/ticket/9054">#9054</a>,
 301   <a href="https://svn.boost.org/trac/boost/ticket/9214">#9219</a>,
 302   <a href="https://svn.boost.org/trac/boost/ticket/10228">#10228</a>, and
 303   <a href="https://svn.boost.org/trac/boost/ticket/10641">#10641</a>, all
 304   related to locales and codecvt facets.</li>
 305   <li>The net effect of the above changes and fixes should be to eliminate
 306   spurious &quot;locale::facet::_S_create_c_locale name not valid&quot; errors on Linux
 307   and other non-BSD POSIX-like systems. The error will continue to occur, as it
 308   should, when a path encoding conversion char-to-wchar_t or wchar_t-to-char is
 309   attempted in an environment without a valid C locale (for example, if the LANG
 310   environment variable is invalid or not defined).</li>
 311   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/6124">#6124</a>,
 312   <a href="https://svn.boost.org/trac/boost/ticket/6779">#6779</a>, and
 313   <a href="https://svn.boost.org/trac/boost/ticket/10038">#10038</a> - an
 314   undefined reference that occurred when the library was compiled for C++03 but
 315   the using program was compiled for C++11, or vice versa. The private library
 316   interface has been changed to use a plain-old C++03 enum. This is the fix
 317   suggested by Andy in 6779.</li>
 318   <li>The Windows implementation now treats NTFS directory junctions (also known
 319   as junctions, also known as mount points) as symlinks. This has the effect of
 320   treating directory junctions as directories, and thus supporting all
 321   operations suitable for directories. This resolves
 322   <a href="https://svn.boost.org/trac/boost/ticket/9016">#9016</a>. Directory
 323   junctions are very similar to symlinks, but may have performance or other
 324   advantages in some situations. They can be created from the command line with
 325   &quot;<code>mklink /j link target</code>&quot;. There is no plan for Boost.Filesystem to
 326   be able to create them directly other than by calling <code>std::system()</code>.</li>
 327 </ul>
 328
 329 <h2>1.56.0</h2>
 330 <ul>
 331   <li>Reorganize <code>recursive_directory_iterator::increment</code>, adding an
 332   invariant that progress is always made, even if an error is reported by
 333   exception or error_code. Add a manually executed test, <code>
 334   test/issues/recurse_dir_iter_5403.cpp</code>. Adjust regular regression tests
 335   as needed. Thanks to Claudio Bley for the
 336   <a href="https://github.com/boostorg/filesystem/pull/4">pull request</a> - the
 337   change was incorporated into the reorganized code. Fixes
 338   <a href="https://svn.boost.org/trac/boost/ticket/5403">#5403</a> and
 339   <a href="https://svn.boost.org/trac/boost/ticket/6821">#6821</a>.</li>
 340   <li>Fix <code>canonical()</code> to treat parent of root as root. (Christian
 341   Hammerl) Fixes <a href="https://svn.boost.org/trac/boost/ticket/9683">#9683</a>
 342   and <a href="https://svn.boost.org/trac/boost/ticket/10187">#10187</a>.</li>
 343   <li>Added missing test for <code>__sun</code> macro which is defined on
 344   Solaris 10. (Chris Stylianou)</li>
 345   <li>Minor fixes and code cleanup.</li>
 346   <li>Update IDE projects to Visual Studio 2013.</li>
 347   <li>Remove unused <code>const char colon</code> to clear clang warning. (J?gen
 348   Hunold)</li>
 349   <li>Add BOOST_NOEXCEPT to <code>class filesystem_error</code>.</li>
 350   <li>Change <code>perms::all_all</code> and <code>perms::perms_mask</code> to
 351   absolute values to quiet intellisense warnings, and conform to C++11.</li>
 352 </ul>
 353
 354 <h2>1.54.0</h2>
 355 <ul>
 356   <li>Reimplement <code>path::codecvt()</code> and <code>path::imbue()</code>
 357   with portable code that is intended to be much more robust and maintainable. A
 358   section on <a href="reference.html#path-Usage">path usage concerns</a> has
 359   been added to the reference documentation describing several concerns that
 360   arise in the context of multithreading and <code>path::codecvt()</code>.</li>
 361 </ul>
 362
 363 <h2>1.52.0</h2>
 364 <ul>
 365   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/7239">#7239</a>, <i>Stack
 366   overflow when calling <code>create_directories(&quot;:D&quot;)</code></i>. The reported
 367   problem was a symptom of an internal bug that caused <code>path::filename()</code>
 368   and <code>path::parent_path()</code> to fail on Windows for <code>path(&quot;:&quot;)</code>,
 369   and that in turn caused other functions that depend on <code>filename()</code>
 370   or <code>parent_path()</code> to fail, such as <code>create_directories()</code>.</li>
 371 </ul>
 372
 373 <h2>1.51.0</h2>
 374 <ul>
 375   <li>Add begin() and end() non-member functions for directory_iterator and
 376   recursive_directory_iterator so that C++11 range-based for statements  work.
 377   Suggested by feature requests
 378   <a href="https://svn.boost.org/trac/boost/ticket/5896">#5896</a> and
 379   <a href="https://svn.boost.org/trac/boost/ticket/6521">#6521</a>, using the
 380   <a href="https://svn.boost.org/trac/boost/ticket/5896">#5896</a> approach.</li>
 381   <li>Add range_begin() and range_end() non-member functions for directory_iterator and
 382   recursive_directory_iterator so that
 383   <a href="http://www.boost.org/libs/foreach/">BOOST_FOREACH</a> works.</li>
 384   <li>Fix a Linux fchmodat problem affecting symlink permissions reported during
 385   discussion of <a href="https://svn.boost.org/trac/boost/ticket/6659">#6659</a>.</li>
 386   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/6659">#6659</a> and
 387   <a href="https://svn.boost.org/trac/boost/ticket/7051">#7051</a>, <i>fchmodat
 388   supported only on Solaris 11</i>. Fix for both Sun and GCC compilers. </li>
 389 </ul>
 390
 391 <h2>1.50.0</h2>
 392 <ul>
 393   <li>Remove Filesystem Version 2 from the distribution. Version 3 is now the
 394   only distributed version. Those still using V2 are urged to migrate to V3 as
 395   soon as possible.</li>
 396   <li>Add <code>constexpr value_type preferred_separator</code> to class path.</li>
 397   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5118">#5118</a>, <i>
 398   <code>replace_extension</code> doesn't work as specified in documentation</i>. The
 399   documentation, implementation, and test cases have all had fixes applied. The
 400   documentation had failed to mention that any existing extension is removed.
 401   The behavior for simple cases has been reverted to the Version 2 behavior, but
 402   with corrections so that complex replacements now work. Two test cases from
 403   #5118 have been added.</li>
 404   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/3737">#3737</a>,
 405   <i>Boost.Filesystem does not compile on Windows Mobile</i>. On Windows, &lt;sys/stat.h&gt;
 406   is no longer included.</li>
 407   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/4065">#4065</a>,
 408   <i>Boost Filesystem lexicographic path comparison inconsistent</i>. This required
 409   multiple source code bug fixes and code cleanup, correcting problems not
 410   related to lexicographical issues.</li>
 411   <li>Add class path member function <code>compare</code> for consistency with
 412   std::string.</li>
 413   <li>Tighten BOOST_FILESYSTEM_DYN_LINK and BOOST_FILESYSTEM_STATIC_LINK logic
 414   in filesystem/config.hpp so that one or the other is always defined, and both
 415   being defined is a #error.</li>
 416   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/6690">#6690</a> and
 417   <a href="http://svn.boost.org/trac/boost/ticket/6737">#6737</a>, resolving
 418   static linking related problems with VC++ 8 through 11. Note that this fix may
 419   reintroduce codecvt thread safety problems
 420   <a href="http://svn.boost.org/trac/boost/ticket/4889">#4889</a>,
 421   <a href="http://svn.boost.org/trac/boost/ticket/6320">#6320</a>, for these
 422   compilers if static linking is used.</li>
 423   <li>Add path::operator+= and concat functions to tack on things like suffixes
 424   or numbers. Suggested by Ed Smith-Rowland and others.</li>
 425   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/6809">#6809</a>,
 426   <i>Implementation of filesystem::rename() method for MS Windows is wrong</i>, by
 427   adding MOVEFILE_COPY_ALLOWED to deal with renames across drives, volumes, file
 428   systems. Fix has no effect on non-Windows systems.</li>
 429   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/6819">#6819</a>, A path operand with a source that was a one character array was
 430   treated as empty, even if it wasn't empty. Such arrays can occur in unions or
 431   in code using C variable length array idioms.</li>
 432   <li>Fix <a href="http://svn.boost.org/trac/boost/ticket/6932">#6932</a>,
 433   <i>create_directories throws exception even if error_code is specified</i>.</li>
 434 </ul>
 435
 436 <h2>1.49.0</h2>
 437 <ul>
 438   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/3714">#3714</a>,
 439   Added test cases and fixes for class path errors when assignment or append
 440   used self or portion of self as source. </li>
 441   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/4889">#4889</a>,
 442   <a href="https://svn.boost.org/trac/boost/ticket/6320">#6320</a>, <i>Locale codecvt_facet not thread safe on Windows</i>. Move
 443   Windows, Mac OS X, locale and codecvt facet back to namespace scope. POSIX
 444   except OS X uses local static initialization (IE lazy) to ensure exceptions
 445   are catchable if environmental variables are misconfigured and to avoid use of
 446   locale(&quot;&quot;) if not actually used.</li>
 447   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5652">#5652</a>,
 448   <i>recursive_directory_iterator fails on cyclic symbolic links</i>. Thanks to Daniel Aarno for the patch.</li>
 449   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5653">#5653</a>,
 450   <i>recursive_directory_iterator(error_code) can still throw filesystem_error</i>.</li>
 451   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5900">#5900</a>, <i>directory_iterator
 452   access violation on Windows if error is thrown</i>. Thanks to Andreas Eckleder for the patch.</li>
 453   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5900#comment:2">#5900
 454   comment 2</a>, a bug in director_iterator construction with error_code argument that
 455   caused increment to be called without the ec argument being passed.</li>
 456   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5900">#5989</a> by cleaning up test suite path_test.cpp code even
 457   though the ticket itself was not a defect, and clarifying docs; iteration over a path yields
 458   generic format.</li>
 459   <li>Fix <a href="https://svn.boost.org/trac/boost/ticket/5592">#5592</a>, <i>Change Windows codecvt processing from CP_THREAD_ACP to CP_ACP</i>.</li>
 460   <li>Operations function fixes for PGI compiler, thanks to Noel Belcourt.</li>
 461   <li>Relax permissions test to reflect reality, particularly on the Sandia test
 462   platforms.</li>
 463 </ul>
 464
 465 <h2>1.48.0</h2>
 466 <ul>
 467   <li>Added operational function <a href="reference.html#canonical">canonical()</a>,
 468   suggested by David Svoboda, who also provided pseudo-code.</li>
 469   <li>Added <a href="reference.html#hash_value">hash_value()</a> function for
 470   paths. (Daniel James)</li>
 471   <li>Fix path inserter problem (<a href="https://svn.boost.org/trac/boost/ticket/5764">#5764</a>)
 472   reported for QNX6.3.2 host (gcc-3.3.5)</li>
 473   <li>Fix problem of locale(&quot;&quot;) exception being thrown before main() starts on
 474   poorly configured (e.g. LANG=&quot;bad name&quot;) POSIX systems. Resolves the most
 475   serious aspect of tickets
 476   <a href="https://svn.boost.org/trac/boost/ticket/4688">#4688</a>,
 477   <a href="https://svn.boost.org/trac/boost/ticket/5100">#5100</a>,
 478   <a href="https://svn.boost.org/trac/boost/ticket/5289">#5289</a>.</li>
 479 </ul>
 480
 481 <h2>1.47.0</h2>
 482 <ul>
 483   <li>Program file_status.cpp added (V3). See boost-root/libs/filesystem/v3/example.
 484   Useful both as an example and to explore how Boost.Filesystem treats various
 485   status errors.&nbsp; Run &quot;bjam&quot; (NOT &quot;bjam install&quot;) in the example directory
 486   to install in example/bin.</li>
 487 </ul>
 488
 489 <h2>1.46.1</h2>
 490
 491 <ul>
 492   <li>Fix fstream problem for STLPort masquerading as Dinkumware (<a href="https://svn.boost.org/trac/boost/ticket/5217">#5217</a>).</li>
 493 </ul>
 494
 495 <h2>1.46.0</h2>
 496 <ul>
 497   <li>Version 3 of the library is now the default.</li>
 498   <li>IBM vacpp: Workaround for compiler bug affecting iterator_facade. (<a href="https://svn.boost.org/trac/boost/ticket/4912">#4912</a>)</li>
 499   <li>Verify, clarify, document that &lt;boost/config/user.hpp&gt; can be used to
 500   specify BOOST_FILESYSTEM_VERSION. (<a href="https://svn.boost.org/trac/boost/ticket/4891">#4891</a>)</li>
 501   <li>Replaced C-style assert with BOOST_ASSERT.</li>
 502   <li>Undeprecated unique_path(). Instead, add a note mentioning the workaround
 503   for lack of thread safety and possible change to cwd. unique_path() is just
 504   too convenient to deprecate!</li>
 505   <li>Cleared several GCC warnings.</li>
 506   <li>Changed V2 code to use BOOST_THROW_EXCEPTION.</li>
 507   <li>Windows: Fix status() to report non-symlink reparse point correctly.</li>
 508   <li>Add <code>symlink_option</code> to <code>recursive_directory_iterator</code>,
 509   allowing control over recursion into directory symlinks. Note that the default
 510   is changed to not recurse into directory symlinks.</li>
 511   <li><a href="reference.html">Reference</a> documentation cleanup, including
 512   fixing missing and broken links, and adding missing functions.</li>
 513   <li>Miscellaneous implementation code cleanup. </li>
 514 </ul>
 515 <hr>
 516 <p>Revised
 517 <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->07 August, 2017<!--webbot bot="Timestamp" endspan i-checksum="34770" --></p>
 518 <p>&copy; Copyright Beman Dawes, 2011</p>
 519 <p> Use, modification, and distribution are subject to the Boost Software
 520 License, Version 1.0. See <a href="http://www.boost.org/LICENSE_1_0.txt">
 521 www.boost.org/LICENSE_1_0.txt</a></p>
 522 </body>
 523 </html>