allow predefining wxNO_XXX_LIB symbols to avoid implicitly linking with the corresponding library when using msvc/wx/setup.h

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53155 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/doxygen/mainpages/const_cpp.h

@@ -23,6 +23,7 @@ always tested using @ifdef_ and not @if_.
 @li @ref page_cppconst_hardware
 @li @ref page_cppconst_compiler
 @li @ref page_cppconst_featuretests
+@li @ref page_cppconst_msvc_setup_h
 @li @ref page_cppconst_miscellaneous
 
 <hr>
@@ -199,6 +200,35 @@ Currently the following symbols exist:
 
 
 
+@section page_cppconst_msvc_setup_h Libraries selection for MSVC setup.h
+
+Microsoft Visual C++ users may use the special @c wx/setup.h file for this
+compiler in @c include/msvc subdirectory. This file implicitly links in all the
+wxWidgets libraries using MSVC-specific pragmas which usually is much more
+convenient than manually specifying the libraries list in all of the project
+configurations. However sometimes linking with all the libraries is not
+desirable, for example because some of them were not built and this is where
+the symbols in this section can be helpful: defining them allows to not link
+with the corresponding library. The following symbols are honoured:
+    - wxNO_ADV_LIB
+    - wxNO_AUI_LIB
+    - wxNO_HTML_LIB
+    - wxNO_MEDIA_LIB
+    - wxNO_NET_LIB
+    - wxNO_QA_LIB
+    - wxNO_RICHTEXT_LIB
+    - wxNO_XML_LIB
+    - wxNO_REGEX_LIB
+    - wxNO_EXPAT_LIB
+    - wxNO_JPEG_LIB
+    - wxNO_PNG_LIB
+    - wxNO_TIFF_LIB
+    - wxNO_ZLIB_LIB
+
+Notice that the base library is always included and the core is always included
+for the GUI applications (i.e. those which don't define @c wxUSE_GUI as 0).
+
+
 @section page_cppconst_miscellaneous Miscellaneous
 
 @beginDefList