[Mockpp-commits] mockpp/mockpp/docs/en dev_advanced_intro.docbook,1.6,1.7

[Ewald A. <ewa...@us...>]

Update of /cvsroot/mockpp/mockpp/mockpp/docs/en
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv5881/mockpp/docs/en

Modified Files:
	dev_advanced_intro.docbook 
Log Message:
update

Index: dev_advanced_intro.docbook
===================================================================
RCS file: /cvsroot/mockpp/mockpp/mockpp/docs/en/dev_advanced_intro.docbook,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- dev_advanced_intro.docbook	18 Nov 2005 21:43:45 -0000	1.6
+++ dev_advanced_intro.docbook	19 Nov 2005 14:15:07 -0000	1.7
@@ -142,8 +142,7 @@
 
 <itemizedlist>
  <listitem>Derive from the interface class and the according mock object class.</listitem>
- <listitem>Add the methods and their internal variables with one of the predefined
-           pair of macros.</listitem>
+ <listitem>Add the methods and their potential internal variables.</listitem>
  <listitem>Use one of the available methods to construct a helper object
            to set up the detailed behaviour.</listitem>
 </itemizedlist>
@@ -170,7 +169,7 @@
 
  <listitem><para>The newer and recommended approach with the help of mock methods.
  The methods are templates which wrap the method under test. Since they are fully
- accessible in constrast to a macro they are easier to use and better to debug.</para>
+ accessible in constrast to an obscure macro they are easier to use and better to debug.</para>
 
  <para>For both the Visitable and the Chainable types there are sets of templates
  for mock methods according to the number of parameters the method under test takes.
@@ -195,6 +194,15 @@
  </listitem>
 </itemizedlist>
 
+ <para>There is another point to keep in mind when choosing either the macros or the
+ templates. There are only macros available for up to five parameters. Extending this
+ number probably results
+ in a lot of coding and debugging. The templates on the other hand are generated by several
+ scripts. The standard distribution supports up to 6 parameters. If you need more you only
+ have to invoke <filename>gen_files_N.sh</filename> in the top level directory of the
+ source distribution. Supply the maximal number of parameters you need and all the header
+ files are generated.</para>
+
 </sect3>
 
 <sect3 id="choosing_macro">