<sect1 id="appwizard-behind">
<title>Behind the scenes</title>

<para>
It is always advisable to look at the messages output and try to understand what had happened. At least in principle you should know what was going on, when the Application Wizard initiated your new project. We cannot go into the depths, yet a short survey the messages might suffice.
</para>

<tip>
<para>
If your project was set up for local &CVS; you will have got two series of messages of which the first set most probably was gone before you could thoroughly read, as &CVS; used the <guilabel>Messages</guilabel> window for its own purposes. So we catched both series in separate runs - set up the application twice, one time without &CVS;, then removed the directory and started over, this time setting the application up with &CVS;.
</para>
<para>
You may want to follow this same procedure if anything weird happened and you just could not catch the messages of the first setup step.
</para>
</tip>

<sect2 id="appwizard-behind-app">
<title>Setting up the application</title>

<para>
If you set up <quote>YourNewApplication</quote> as in our previous example the Application Wizard should have printed the following messages (we re-arranged the output a bit for readability):
</para>
<screen><computeroutput><literal>
* perl /opt/kde3/share/apps/kdevappwizard/template-kapp/script \
  --author='Your Name' \
  --email='you@you.com' \
  --version='0.1' \
  --appname='YourNewApplication' \
  --dest='/home/devel/yournewapplication' \
  --source='/opt/kde3/share/apps/kdevappwizard' \
  --license='GPL' \
  --licensefile='COPYING' \
  --filetemplates='h,/tmp/kde-devel/gideoncDE5Ja.tmp,\
                   cpp,/tmp/kde-devel/gideonsRrLab.tmp'
* Making destination directory
* Installing file templates
* Installing license file
* Installing admin directory
* Installing GNU coding standard files
* Installing Docbook template
* Installing project file
* Installing application framework
* Installing application sources
* Finished
* *** Success ***
</literal></computeroutput></screen>
<formalpara>
<title>A <application>Perl</application> script called</title>
<para>
As you see from the first line, the Application Wizard did construct a <application>Perl</application> program call from the settings you made in the <guilabel>Create New Project</guilabel> dialog. The called <filename>script</filename> resides in a directory which was determined from the application type template you selected in the upper part of the <guilabel>General</guilabel> page of the <guilabel>Create New Project</guilabel> dialog.
</para>
</formalpara>
<para>
In our case this <filename>sript</filename> is located in the <filename class="directory">/opt/kde3/share/apps/kdevappwizard/template-kapp/</filename> directory. Just replace <filename class="directory">/opt/kde3/</filename> by the &kde; directory in your system.
</para>
<para>
This <application>Perl</application> <filename>script</filename> is called with a series of parameters, all marked by <quote><computeroutput>--</computeroutput></quote> prefixes, where the Application wizard put information from the other selections you made in the <guilabel>Create New Project</guilabel> dialog.
</para>
<para>
The exact series of initialization steps depends on which <application>Perl</application> <filename>script</filename> was called. You may want to look it up at the place given in the command.
</para>
<note><para>
The scripts makes use of a set of <application>Perl</application> subroutines collected in the <filename>gideon.pm</filename> file which you may find in the <filename class="directory">share/apps/kdevwizard/template-common/</filename> subdirectory of your &kde; installation.
</para></note>

<formalpara>
<title>The destination directory</title>
<para>
When the <application>Perl</application> script is run, you get a series of messages what is about to be done in the next installation step. At first the destination direcory will be set up. This is what you got dispayed in the <guilabel>Final location</guilabel> line on the <guilabel>Create New Project</guilabel> dialog <guilabel>General</guilabel> page. The script uses the value of the <computeroutput>--dest</computeroutput> parameter in the <application>Perl</application> command above.
</para>
</formalpara>

<formalpara>
<title>The file templates</title>
<para>
In the next step the file templates you set up in the <guilabel>Create New Project</guilabel> dialog will be copied to the <filename class="directory">templates</filename> subdirectory of the application directory just set up. As you can see from the <computeroutput>--filetemplates</computeroutput> parameter, the templates are given in pairs - the suffix they are used for first, followed by the name of a temporary file in which the Application wizard copied the contents of the templates dialog pages. This suffix will be taken as the name of the file to store the template information.
</para>
</formalpara>
<para>
In our example two such template files were installed, namely <filename>templates/h</filename> for C++ header and <filename>templates/cpp</filename> for C++ source files.
</para>

</sect2> <!-- appwizard-behind-app -->

<sect2 id="appwizard-behind-cvs">
<title>Setting up &CVS;</title>

<para>
</para>
</sect2> <!-- appwizard-behind-cvs -->

</sect1> <!-- appwizard-behind -->