deploy: 94fe31eb9b

integration/bazel/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/build2/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/cget/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/conan/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/conda/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/cpm/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/homebrew/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/hunter/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/index.md

@@ -30,15 +30,29 @@ Once the library is integrated, see the [Migration Guide](https://json.nlohmann.
 #include <nlohmann/json.hpp>
 
 // for convenience
-using json = nlohmann::json;
+using nlohmann::json;
 ```
 
 to the files you want to process JSON and set the necessary switches to enable C++11 (e.g., `-std=c++11` for GCC and Clang).
 
+Which file do I download?
+
+For a project without a package manager, the library itself, including the `_json` literals, is **one file**: [`json.hpp`](https://github.com/nlohmann/json/releases/latest/download/json.hpp) from the [releases page](https://github.com/nlohmann/json/releases). You do not need to clone the repository, build anything, or link a library. Put the file in a directory named `nlohmann` that is on your include path (for example `third_party/nlohmann/json.hpp` with `-I third_party`), so that `#include <nlohmann/json.hpp>` works. Download the companion headers listed below only if you use them: `json_view.hpp` for the [zero-copy views](https://json.nlohmann.me/features/json_view/index.md), `json_fwd.hpp` for forward declarations, and `json_literals.hpp` if you define `JSON_NO_AUTOMATIC_UDLS`. Keep them in the same `nlohmann` directory.
+
+Do not copy only parts of the repository's `include/` directory: the headers in it include each other and must be kept together. If your IDE reports "cannot open source file" while the compiler succeeds, the compiler's include path is set correctly but the IDE's is not; add the same directory to the IDE's include paths.
+
 You can further use file [`single_include/nlohmann/json_fwd.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json_fwd.hpp) for forward declarations (see [Compile times](https://json.nlohmann.me/integration/compile_times/index.md)), and file [`single_include/nlohmann/json_literals.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json_literals.hpp) for the user-defined string literals if you define [`JSON_NO_AUTOMATIC_UDLS`](https://json.nlohmann.me/api/macros/json_no_automatic_udls/index.md).
 
 For the read-only, non-owning [`basic_json_document`](https://json.nlohmann.me/api/basic_json_document/index.md)/[`basic_json_view`](https://json.nlohmann.me/api/basic_json_view/index.md) types, additionally include [`single_include/nlohmann/json_view.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json_view.hpp); see [Zero-copy JSON views](https://json.nlohmann.me/features/json_view/index.md).
 
+## Notes for builds and distribution
+
+**Reproducible and path-independent builds.** The runtime assertions use `assert`, which embeds the name of the source file (`__FILE__`) in the binary. Release builds do not contain them, because they define `NDEBUG`. If you compile with assertions enabled and need binaries that do not depend on the build directory, either define `NDEBUG` or map the prefix of the path with the compiler option `-ffile-prefix-map=<old>=<new>` (GCC 8 and later, Clang 10 and later). See [Runtime assertions](https://json.nlohmann.me/features/assertions/index.md).
+
+**There is no separate source file to compile.** The library is header-only, so there is no `.cpp` that could be built with different options than the code that includes it. It is also not available as a precompiled library. To compile the library with optimizations in an otherwise unoptimized build (for example to parse large files in a debug build, which is slow because of the unoptimized code and the checks of the debug standard library), keep the code that uses `json` in a separate source file and set the options for that file only. [Compile times](https://json.nlohmann.me/integration/compile_times/index.md) shows how to [instantiate `basic_json` once](https://json.nlohmann.me/integration/compile_times/#instantiate-basic_json-once).
+
+**Debugger visualization.** The Natvis file works with the Visual Studio debugger, including the `cppvsdbg` engine in Visual Studio Code, but not with debuggers that wrap LLDB, such as `codelldb`; see [Debugging](https://json.nlohmann.me/home/debugging/index.md).
+
 ## See also
 
 - [CMake](https://json.nlohmann.me/integration/cmake/index.md) - integrate the library into a CMake project

integration/macports/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/meson/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/msys2/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/package_managers.md

@@ -26,7 +26,7 @@ Throughout this page, we will describe how to compile the example file `example.
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {
@@ -92,7 +92,7 @@ The header can be used directly in your code or via CMake.
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -122,7 +122,7 @@ The header can be used directly in your code or via CMake.
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -223,7 +223,7 @@ The resulting compile definitions are part of the Meson dependency, the pkg-conf
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -282,7 +282,7 @@ repository can be referenced within a `MODULE.bazel` by rules such as `archive_o
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -345,7 +345,7 @@ requires, where `x.y.z` is the release version you want to use.
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -410,7 +410,7 @@ Please see the [Spack project](https://github.com/spack/spack) for any issues re
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -487,7 +487,7 @@ Please see the Hunter project for any issues regarding the packaging.
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -551,7 +551,7 @@ and follow the then displayed descriptions. Please see the vcpkg project for any
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -613,7 +613,7 @@ installed by adding the `-DJSON_MultipleHeaders=ON` flag (i.e., `cget install nl
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -703,7 +703,7 @@ The library's own [`Package.swift`](https://github.com/nlohmann/json/blob/develo
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -801,7 +801,7 @@ conda install -c conda-forge nlohmann_json
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -852,7 +852,7 @@ package; type `pacman -S mingw-w64-i686-nlohmann-json` or `pacman -S mingw-w64-x
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -902,7 +902,7 @@ to install the [nlohmann-json](https://ports.macports.org/port/nlohmann-json/) p
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -932,7 +932,7 @@ to install the [nlohmann-json](https://ports.macports.org/port/nlohmann-json/) p
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -1099,7 +1099,7 @@ To use this package in an existing [`build2`](https://build2.org) project, the g
             #include <iostream>
             #include <iomanip>
             
-            using json = nlohmann::json;
+            using nlohmann::json;
             
             int main()
             {
@@ -1182,7 +1182,7 @@ CPMAddPackage("gh:nlohmann/json@3.12.0")
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {
@@ -1238,7 +1238,7 @@ CPMAddPackage("gh:nlohmann/json@3.12.0")
         #include <iostream>
         #include <iomanip>
         
-        using json = nlohmann::json;
+        using nlohmann::json;
         
         int main()
         {

integration/package_managers/index.md

@@ -15,7 +15,7 @@ Throughout this page, we will describe how to compile the example file `example.
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {
@@ -78,7 +78,7 @@ Example: Raw compilation
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -109,7 +109,7 @@ Example: CMake
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -199,7 +199,7 @@ Example: Wrap
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -260,7 +260,7 @@ Example: Bazel module with `bazel_dep`
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -322,7 +322,7 @@ Example: CMake with the Conan toolchain
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -386,7 +386,7 @@ Example: CMake with a Spack-installed package
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -463,7 +463,7 @@ Example: CMake with HunterGate
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -527,7 +527,7 @@ Example: CMake with the vcpkg toolchain
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -590,7 +590,7 @@ Example: CMake with the cget toolchain
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -678,7 +678,7 @@ Example: a minimal executable package
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -755,7 +755,7 @@ Example: Raw compilation
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -805,7 +805,7 @@ Example: Raw compilation
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -855,7 +855,7 @@ Example: Raw compilation
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -886,7 +886,7 @@ Example: CMake
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -1058,7 +1058,7 @@ Example: from scratch, using `build2`'s [`bdep new` command](https://build2.org/
      #include <iostream>
      #include <iomanip>
 
-     using json = nlohmann::json;
+     using nlohmann::json;
 
      int main()
      {
@@ -1137,7 +1137,7 @@ Example: CMake with `CPMAddPackage`
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {
@@ -1195,7 +1195,7 @@ Example: xmake project
    #include <iostream>
    #include <iomanip>
 
-   using json = nlohmann::json;
+   using nlohmann::json;
 
    int main()
    {

integration/spack/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/swift/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/vcpkg/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {

integration/xmake/example.cpp

@@ -2,7 +2,7 @@
 #include <iostream>
 #include <iomanip>
 
-using json = nlohmann::json;
+using nlohmann::json;
 
 int main()
 {