From 2e03e60218d8d1136e8c033ddee87fc801d8a848 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Marjam=C3=A4ki?= <danielm77@spray.se>
Date: Sat, 10 Jul 2010 08:12:23 +0200
Subject: [PATCH] Manual: Better description of -D. As suggested by kwin.
 Ticket #1212

---
 man/manual.docbook | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/man/manual.docbook b/man/manual.docbook
index 2c0d8db9c..e1837b5a8 100644
--- a/man/manual.docbook
+++ b/man/manual.docbook
@@ -3,9 +3,9 @@
 "/usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd">
 <book>
   <bookinfo>
-    <title>Cppcheck 1.43</title>
+    <title>Cppcheck 1.44</title>
 
-    <date>2010-05-08</date>
+    <date>2010-07-10</date>
   </bookinfo>
 
   <chapter>
@@ -165,9 +165,14 @@ Checking path/file2.cpp...
     <para>But if you want to manually limit the checking you can do so with
     <literal>-D</literal>.</para>
 
-    <para>For example, if you want to limit the checking so the only
-    configuration to check should be "DEBUG=1;__cplusplus" then something like
-    this can be used:</para>
+    <para>Beware that only the macros, which are given here and the macros
+    defined in source files and known header files are considered. That
+    excludes all the macros defined in some system header files, which are by
+    default not examined by cppcheck.</para>
+
+    <para>The usage: if you, for example, want to limit the checking so the
+    only configuration to check should be "DEBUG=1;__cplusplus" then something
+    like this can be used:</para>
 
     <programlisting>cppcheck -DDEBUG=1 -D__cplusplus path</programlisting>
   </chapter>
@@ -220,7 +225,7 @@ Checking path/file2.cpp...
         <term>severity</term>
 
         <listitem>
-          <para>one of: error / possible error / style / possible style</para>
+          <para>either error or style</para>
         </listitem>
       </varlistentry>