libxmlplusplus · kjellahl · Jul 5, 2023 · Jul 5, 2023
diff --git a/MSVC_NMake/MSVC-Builds.md b/MSVC_NMake/MSVC-Builds.md
@@ -0,0 +1,84 @@
+Building libxml++ with Visual Studio 2017 or later
+-
+
+* You will need Visual Studio 2017 (MSVC 15.7.x) or later, as `C++-17` is
+required and only 15.7.x or later had adequate `C++-17` support.
+* Install libxml2 from https://xmlsoft.org/, either via Windows binaries or
+building from source, using NMake or CMake.  It is strongly recommended, if
+building libxml2 from source, that Visual Studio 2015 or later is used.
+* Add libxml2's include path to `%INCLUDE%` and its library path to `%LIB%`, or
+placing the dependencies like the following:
+```
+$(some_dir_1)\include
+   |
+   --libxml2\libxml\*.h
+   |
+   --(headers of libraries libxml2 depends on, such as ZLib, liblzma...)
+
+$(some_dir_2)\lib
+   |
+   --libxml2.lib
+   |
+   --(.lib's of libraries that libxml2 depends on, such as ZLib, liblzma)
+```
+* You need libxml2's DLL and all of its dependent DLLs in `%PATH%` if linking
+against a DLL build of libxml2 in order to run the tests.
+
+* Notice that for the built DLL and .lib the Visual Studio version is no
+longer `vc$(VSVER)0`, but is named like the following (Visual Studio version),
+to follow what is done in other C++ libraries such as Boost (use
+`-Dmsvc14x-parallel-installable=false` to the Meson options or pass
+`USE_COMPAT_LIBS=1` in the NMake commandline to override, recommended only if
+rebuilding items using libxml++ is inconvenient):
+  * NMake:
+    * 2017: `VSVER=15`, `xml++-vc141-5_0.[dll|pdb|lib]`
+    * 2019: `VSVER=16`, `xml++-vc142-5_0.[dll|pdb|lib]`
+    * 2022: `VSVER=17`, `xml++-vc143-5_0.[dll|pdb|lib]`
+  * Meson:
+    * 2017: `VSVER=15`, `xml++-vc141-5.0-1[dll|pdb]`, `xml++-vc141-5.0.lib`
+    * 2019: `VSVER=16`, `xml++-vc142-5.0-1[dll|pdb]`, `xml++-vc142-5.0.lib`
+    * 2022: `VSVER=17`, `xml++-vc143-5.0-1[dll|pdb]`, `xml++-vc143-5.0.lib`
+
+
+### NMake Builds
+* Note that `$(Platform)` refers to the following:
+  * `$(Platform)`
+    * AMD64/x86_64/x64: `x64`
+    * ARM64/aarch64: `arm64`
+    * x86/i686: `Win32`
+
+* Run the following:
+```
+cd $(srcroot)\MSVC_NMake
+# Run "nmake /f Makefile.vc" to see to see what options are supported by
+# the NMake Makefiles
+# INCLUDEDIR is by default $(PREFIX)\include, and LIBDIR is by default
+# $(PREFIX)\lib. PREFIX is by default $(srcroot)\..\vs$(VSVER\$(Platform).
+# $(some_dir_1) and $(some_dir_2) refer to the sample layout listed above.
+
+nmake /f Makefile.vc CFG=[debug|release] [PREFIX=...] [INCLUDEDIR=$(some_dir_1)\include] [LIBDIR=$(some_dir_2)\lib]
+```
+* The following targets are supported (only DLL builds are supported out of the
+box with the NMake Makefiles):
+  * `all`, `libxmlxx_examples` (or nothing passed in): The libxml++ library as
+a DLL with the example programs
+  * `tests`: The libxml++ library as a DLL with the test programs
+
+### Meson builds
+Please also see [README.md](../README.md) for further details.
+
+For Visual Studio builds, it is also recommended that CMake is installed and can
+be found in `%PATH%`, so that it can help with finding an installed libxml2, or
+build libxml2 alongside with libxml++ if it is not previously installed. If
+libxml2 is installed, you will most probably need to add its include directory
+to `%INCLUDE%` and its library path to `%LIB%`, as described earlier.
+
+
+Cedric Gustin
+01/26/2005
+
+Armin Burgmeier
+10/03/2010
+
+Chun-wei Fan
+06/12/2020, updated 07/05/2023
diff --git a/MSVC_NMake/README b/MSVC_NMake/README
diff --git a/MSVC_NMake/filelist.am b/MSVC_NMake/filelist.am
@@ -1,15 +1,15 @@
-## This file is part of libxml++.
-
-msvc_nmake_data = \
-  README \
-  libxml++/libxml++.rc \
-  libxml++/libxml++config.h \
-  build-rules-msvc.mak \
-  config-msvc.mak \
-  create-lists-msvc.mak \
-  create-lists.bat \
-  detectenv-msvc.mak \
-  generate-msvc.mak \
-  info-msvc.mak \
-  install.mak \
-  Makefile.vc
+## This file is part of libxml++.
+
+msvc_nmake_data = \
+  MSVC-Builds.md \
+  libxml++/libxml++.rc \
+  libxml++/libxml++config.h \
+  build-rules-msvc.mak \
+  config-msvc.mak \
+  create-lists-msvc.mak \
+  create-lists.bat \
+  detectenv-msvc.mak \
+  generate-msvc.mak \
+  info-msvc.mak \
+  install.mak \
+  Makefile.vc
diff --git a/README.md b/README.md
@@ -22,7 +22,7 @@ supplier of your operating system, such as your Linux distribution.
 
 ## Building on Windows
 
-See MSVC_NMake/README
+See [MSVC-Builds.md](MSVC_NMake/MSVC-Builds.md)
 
 ## Building from a release tarball