<para>In the admin web interface, producers appear, for example, on
the admin->"Generate manually"->"advanced page": (they are called Tasks)</para>
<para>
-Further information on producers may be found at XXX and in the javadoc
-(classes Producer, NodedProducer, roducerNode...).
+More information on producers is available in <xref linkend="producer_framework" />.
</para>
</glossdef>
</glossentry>
<glossterm>generator</glossterm>
<glossdef>
<para>
-A generator is an abstraction for a template engine.
+A generator is an abstraction for a template (html template).
+Calling the generator's <function>generate(outputFileWriter,keyValuePairs)</function> method
+will run the template engine on the template file
+and write an output html file.
Different template engines are
supported right now:
<ulink href="http://freemarker.sourceforge.net">freemarker</ulink>
</glossdef>
</glossentry>
-<glossentry id="bundle">
+<glossentry id="bundles">
<glossterm>bundles</glossterm>
<glossdef>
<para>
-Bundles are key/value pairs in a text file, used for configuration
-and internationalization.
-Bundles may be used to create a template for multiple languages. The
-language dependent aspects are stored in a properties file.
+A Bundle represents a set key/value pairs stored in a ".properties"
+text file. Bundles are used for internationalization (language
+translations) and for <glossterm linkend="configuration">configuration</glossterm> files (config.properties and
+source/default.properties).
+Bundles may be used to create a template for multiple languages.
</para>
</glossdef>
</glossentry>
So
<uri>http://somehost.org/mir/servlet/Mir?module=Comment&do=list</uri>
will call <function>ServletModuleComment.list()</function>.
-
-
</para>
</glossdef>
</glossentry>
<para>
The media framework is quite old and will be thoroughly changed
in a future release.
-</para>
+ </para>
+ </glossdef>
+</glossentry>
+
+<glossentry id="configuration">
+ <glossterm>configuration</glossterm>
+ <glossdef>
+ <para>
+Mir is configured through the
+<filename>etc/config.properties</filename> file, which
+overrides default values in
+the
+<filename>source/default.properties</filename> file.
+The key/value pairs are handled by
+<glossterm linkend="bundles">bundles</glossterm>.
+ </para>
</glossdef>
</glossentry>
-<chapter id="introduction">
+<chapter id="producer_framework">
<title>The producer framework</title>
Please read the presentation of the <glossterm linkend="producers">producers</glossterm> concept
for an introduction.
<para>
<table border="1">
+ <title>Expressions</title>
+
<tr><td>a string literal</td> <td><code>'hello'</code></td></tr>
<tr><td>a numeric literal</td> <td><code>2138</code></td></tr>
</para>
<table border="1">
+ <title>Reference for producer node types and statements</title>
<tr><td>Name</td> <td bgcolor="#eea8a8"><code>Set</code></td></tr>
<tr><td>Purpose</td> <td>Alter a variable's using a free expression</td></tr>