summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChun-wei Fan <fanchunwei@src.gnome.org>2018-09-10 12:16:24 +0800
committerKjell Ahlstedt <kjellahlstedt@gmail.com>2018-10-30 10:52:48 +0100
commite153981de0db9496efe6babcd77819a2747bf597 (patch)
treee091e38f1516be5009f044cbbadb7428631a79b5
parent45a73c22a97b4bed085ca570ceab94869a8ea0c4 (diff)
downloadsigc++-e153981de0db9496efe6babcd77819a2747bf597.tar.gz
builds: Add README file for MSVC builds
Let people know how Visual Studio builds can be done and the options that can be used for the builds.
-rw-r--r--MSVC_NMake/README.txt47
-rw-r--r--MSVC_NMake/filelist.am1
2 files changed, 48 insertions, 0 deletions
diff --git a/MSVC_NMake/README.txt b/MSVC_NMake/README.txt
new file mode 100644
index 0000000..bb0281c
--- /dev/null
+++ b/MSVC_NMake/README.txt
@@ -0,0 +1,47 @@
+Instructions for building libsigc++ on Visual Studio
+====================================================
+Building the libsigc++ on Windows is now supported using Visual Studio
+versions 2013 or later in both 32-bit and 64-bit (x64) flavors,
+via NMake Makefiles. Due to C++-11 usage, Visual Studio 2012 or
+earlier is not supported.
+
+libsigc++ itself has no external dependencies, but building the
+benchmark test program will require an installation of the Boost
+C++ libraries.
+
+The following describes what items are built with the following
+targets:
+
+-all (or no target specified): The libsigc++ DLL and the example programs.
+-test: The libsigc++ DLL and the test programs.
+-benchmark: The libsigc++ DLL and the benchmark program.
+
+The following are instructions for performing such a build. A 'clean' target is
+provided-it is recommended that one cleans the build and redo the build if any
+configuration option changed. An
+'install' target is also provided to copy the built items in their appropriate
+locations under $(PREFIX), which is described below.
+
+Invoke the build by issuing the command:
+nmake /f Makefile.vc CFG=[release|debug] [PREFIX=...] <option1=1 option2=1 ...>
+where:
+
+CFG: Required. Choose from a release or debug build. Note that
+ all builds generate a .pdb file for each .dll and .exe built--this refers
+ to the C/C++ runtime that the build uses.
+
+PREFIX: Optional. Base directory of where the third-party headers, libraries
+ and needed tools can be found, i.e. headers in $(PREFIX)\include,
+ libraries in $(PREFIX)\lib and tools in $(PREFIX)\bin. If not
+ specified, $(PREFIX) is set as $(srcroot)\..\vs$(X)\$(platform), where
+ $(platform) is win32 for 32-bit builds or x64 for 64-bit builds, and
+ $(X) is the short version of the Visual Studio used, as follows:
+ 2017: 15
+
+Explanation of options, set by <option>=1:
+------------------------------------------
+BOOST_DLL: When building the benchmark, link to a DLL build of the Boost
+ libraries. Required if your installation of the Boost libraries
+ are built as DLLs. Note that debug builds must link to debug
+ builds of Boost and release builds must link to releease builds
+ of Boost.
diff --git a/MSVC_NMake/filelist.am b/MSVC_NMake/filelist.am
index 38ce634..bc6ff4b 100644
--- a/MSVC_NMake/filelist.am
+++ b/MSVC_NMake/filelist.am
@@ -10,5 +10,6 @@ msvc_nmake_data = \
info-msvc.mak \
install.mak \
Makefile.vc \
+ README.txt \
sigc++config.h \
sigc.rc