Changes between Version 14 and Version 15 of Guidelines/MaintenanceGuidelines

Timestamp:

Nov 5, 2009, 3:49:00 PM (13 years ago)

Author:

Paul A. Bristow

Comment:

Added example & some typos corrected.

Guidelines/MaintenanceGuidelines

@@ -575 +575 @@
 For GCC this means -Wall -pendantic  
 
-Using bjam add warnings=all
+Using bjam add warnings=all to the invocation line.
+
+Putting options in jam files allows setting to be made for one or more specified compiler(s).
+
+Some sample options in jamfile.v2 are:
+
+{{{
+project  
+    : requirements 
+      <toolset>gcc:<cxxflags>-Wno-missing-braces
+      <toolset>darwin:<cxxflags>-Wno-missing-braces
+      <toolset>acc:<cxxflags>+W2068,2461,2236,4070,4069 # Comments on warning message help readers who do not have ACC documentation to hand.
+      <toolset>intel:<cxxflags>-nologo 
+      <toolset>msvc:<warnings>all # == /W4
+      <toolset>msvc:<asynch-exceptions>on # Needed for Boost.Test
+      <toolset>msvc:<cxxflags>/Za # disable MS extensions.
+      <toolset>msvc:<define>_SCL_SECURE_NO_WARNINGS
+      <toolset>msvc:<define>_SCL_SECURE_NO_DEPRECATE
+      <toolset>msvc:<define>_CRT_SECURE_NO_DEPRECATE
+      <toolset>msvc:<define>_CRT_SECURE_NO_WARNINGS
+      <toolset>msvc:<cxxflags>/wd4996 # 'putenv': The POSIX name for this item is deprecated.
+      <toolset>msvc:<cxxflags>/wd4512 # assignment operator could not be generated.
+      <toolset>msvc:<cxxflags>/wd4224 # nonstandard extension used : formal parameter 'arg' was previously defined as a type.
+      <toolset>msvc:<cxxflags>/wd4127 # expression is constant.
+      <toolset>msvc:<cxxflags>/wd4701 # unreachable code - needed for lexical cast - temporary for Boost 1.40 & earlier.
+   ...
+    ;
+}}}
 
 2  Consider each warning and
@@ -587 +614 @@
 to the package as possible so that users can still get warnings from *their code*.
 
-For MSVC, this involved pushing to save the current warning state, disabling the warning, and later popping to restore.
+For MSVC, this involves pushing to save the current warning state, disabling the warning, and later popping to restore.
+Adding some or all of the warning message is helpful to tell readers what warning is being ignored.
 
 {{{
 #if defined(_MSC_VER)
 #pragma warning(push) // Save warning settings.
-#pragma warning(disable : 4996) // disable depricated localtime/gmtime warning
+#pragma warning(disable : 4996) // disable deprecated localtime/gmtime warning.
 #endif