[libcxx-commits] [libcxx] r356681 - [libc++] Re-document how to use <filesystem> with various versions of libc++

Louis Dionne via libcxx-commits libcxx-commits at lists.llvm.org
Thu Mar 21 09:21:10 PDT 2019

Author: ldionne
Date: Thu Mar 21 09:21:09 2019
New Revision: 356681

URL: http://llvm.org/viewvc/llvm-project?rev=356681&view=rev
[libc++] Re-document how to use <filesystem> with various versions of libc++

This documentation was removed when we added <filesystem> to the dylib
in r356518, but it really should have been updated to reflect the new
state of things. Keeping documentation around doesn't hurt and users
will have an easier time migrating.


Modified: libcxx/trunk/docs/UsingLibcxx.rst
URL: http://llvm.org/viewvc/llvm-project/libcxx/trunk/docs/UsingLibcxx.rst?rev=356681&r1=356680&r2=356681&view=diff
--- libcxx/trunk/docs/UsingLibcxx.rst (original)
+++ libcxx/trunk/docs/UsingLibcxx.rst Thu Mar 21 09:21:09 2019
@@ -49,6 +49,16 @@ An example of using ``LD_LIBRARY_PATH``:
   $ export LD_LIBRARY_PATH=<libcxx-install-prefix>/lib
   $ ./a.out # Searches for libc++ along LD_LIBRARY_PATH
+Using ``<filesystem>``
+Prior to LLVM 9.0, libc++ provides the implementation of the filesystem library
+in a separate static library. Users of ``<filesystem>`` and ``<experimental/filesystem>``
+are required to link ``-lc++fs``. Prior to libc++ 7.0, users of
+``<experimental/filesystem>`` were required to link libc++experimental.
+Starting with LLVM 9.0, support for ``<filesystem>`` is provided in the main
+library and nothing special is required to use ``<filesystem>``.
 Using libc++experimental and ``<experimental/...>``

More information about the libcxx-commits mailing list