Changes between Version 3 and Version 4 of Guidelines/Warnings/Microsoft

Timestamp:

Sep 3, 2010, 11:55:25 AM (12 years ago)

Author:

Daniel James

Comment:

Try using headers instead of definition lists, with a parameter to PageOutline to avoid including them.

Guidelines/Warnings/Microsoft

@@ -1 +1 @@
 = Microsoft Warnings =
 
-[[PageOutline]]
+[[PageOutline(1-2)]]
 
 == C4100 - Unreferenced formal parameter == #c4100
 
- Suggestion::
-    Either surround the parameter with C comments (for example: `int /* my_variable */`) or just delete if the variable name is uninformative. If in other's module(s), or you are too busy/idle, at least suppress warning. In generic code you might not be able to comment the variable name as it might actually be used to call a static function. In this case simply referencing the variable (`varname;`) in the function body eliminates the warning.
- Suppression::
-    `#  pragma warning(disable: 4100) // 'name' : unreferenced formal parameter`
+=== Suggestion ===
+
+Either surround the parameter with C comments (for example: `int /* my_variable */`) or just delete if the variable name is uninformative. If in other's module(s), or you are too busy/idle, at least suppress warning. In generic code you might not be able to comment the variable name as it might actually be used to call a static function. In this case simply referencing the variable (`varname;`) in the function body eliminates the warning.
+
+=== Suppression ===
+
+`#  pragma warning(disable: 4100) // 'name' : unreferenced formal parameter`
 
 == C4127 - Conditional expression is constant == #c4127
 
- Suggestion::
-    Very common and many believe unhelpful, but a few find it informative, so do not suppress globally.  Even `while(true)` can trigger this! `while(true)` can be rewritten as `for(;;)` eliminating the warning.
- Suppression::
-    `#  pragma warning(disable: 4127) // conditional expression is constant.`
+=== Suggestion ===
+
+Very common and many believe unhelpful, but a few find it informative, so do not suppress globally.  Even `while(true)` can trigger this! `while(true)` can be rewritten as `for(;;)` eliminating the warning.
+
+=== Suppression ===
+
+`#  pragma warning(disable: 4127) // conditional expression is constant.`