← Back to branch summary

~ubuntu-branches/ubuntu/vivid/lire/vivid

« back to all changes in this revision

Viewing changes to doc/dev-manual/ch08.html

  • Committer: Bazaar Package Importer
  • Author(s): Joost van Baal
  • Date: 2009-03-15 08:45:20 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20090315084520-fu8dvg0xp7kr1cm2
Tags: 2:2.1-1
http://bugs.debian.org/492180
http://bugs.debian.org/513586
* New upstream release.
* debian/control: Made myself maintainer, Wolfgang Sourdeau now is in
  Uploaders.
* debian/control: Update dependency:
  s/libdbd-sqlite2-perl (>= 1:0.33)/libdbd-sqlite3-perl/, add suggests
  sqlite, sqlite3: Lire 2.1 requires DBD::SQLite, which uses SQLite 3.0
  (Debian package "sqlite3").  SQLite 2 (Debian package "sqlite") is no
  longer supported by Lire. If you have one or more old lire stores, you
  will need to convert each of them to the new format, like this:
  sqlite oldstore.db .dump | sqlite3 newstore.db .
  See /usr/share/doc/lire/NEWS.Debian.gz for more information.
* debian/lire.NEWS: document upgrade procedure to SQLite3.
* Acknowledge NMU, thanks a lot Christian Perrier! (Closes: #492180,
  #502291, #492180, #502767).
* debian/po/vi.po: Update Vietnamese translation, thanks to Clytie Siddall
  (Closes: #513586).
* debian/{lire.config,lire.postinst,lire.postrm,lire.preinst}: Support
  upgrades from 2.0.2-3 (etch / current oldstable) or later only.
  - Debconf variables lire/useexistinguser and lire/useexistinggroup have
    been removed < 2.0.2-3; remove code dealing with them from lire.config.
  - Debconf variables "user group filesuser filesgroup leftuser leftgroup
    usingexistinguser usingexistinggroup wronguser wronggroup
    lire_user_not_lire upgradingvariables upgrading_to_15
    upgrating_to_20" have all been removed < 2.0.2-3; remove code dealing
    with them from lire.postinst.
  - Configuration files /etc/lire/*/defaults and /etc/lire/catalog.xml have
    been removed at around 1.1-1.  Remove code dealing with them from
    lire.postrm.
  - Remove code dealing with obsolete Debconf variables lire/user and
    lire/group from lire.preinst
* debian/rules: remove support for patches: we're no longer applying any
  patches since 2.0.1-3.
* control: libmime-perl is superseded by libmime-tools-perl, adjust name.
* debian/control: Update Standards-Version from 3.7.3 to 3.8.0  (no
  changes needed).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/dev-manual/ch08.html
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter�8.�The Lire Report Configuration Specification Markup Language</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="Lire Developer's Manual"><link rel="up" href="pt03.html" title="Part�III.�Developer's Reference"><link rel="prev" href="ch07.html" title="Chapter�7.�Common Textual Elements to All XML Formats"><link rel="next" href="ch09.html" title="Chapter�9.�The Lire Report Configuration Markup Language"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter�8.�The Lire Report Configuration Specification Markup Language</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07.html">Prev</a>�</td><th width="60%" align="center">Part�III.�Developer's Reference</th><td width="20%" align="right">�<a accesskey="n" href="ch09.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="chap:lrcsml-doc"></a>Chapter�8.�The Lire Report Configuration Specification Markup Language</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch08.html#id2574947">The Lire Report Configuration Specification Markup Language</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#id2575145"><code class="sgmltag-element">config-spec</code> element</a></span></dt><dt><span class="section"><a href="ch08.html#id2575178"><code class="sgmltag-element">summary</code> element</a></span></dt><dt><span class="section"><a href="ch08.html#id2575207">Parameter Specifiations Elements</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2574947"></a>The Lire Report Configuration Specification Markup Language</h2></div></div></div><p>Document Type Definition for the Lire Report Configuration Specification
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter�8.�The Lire Report Configuration Specification Markup Language</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="Lire Developer's Manual"><link rel="up" href="pt03.html" title="Part�III.�Developer's Reference"><link rel="prev" href="ch07.html" title="Chapter�7.�Common Textual Elements to All XML Formats"><link rel="next" href="ch09.html" title="Chapter�9.�The Lire Report Configuration Markup Language"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter�8.�The Lire Report Configuration Specification Markup Language</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07.html">Prev</a>�</td><th width="60%" align="center">Part�III.�Developer's Reference</th><td width="20%" align="right">�<a accesskey="n" href="ch09.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="chap:lrcsml-doc"></a>Chapter�8.�The Lire Report Configuration Specification Markup Language</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch08.html#id316834">The Lire Report Configuration Specification Markup Language</a></span></dt><dd><dl><dt><span class="section"><a href="ch08.html#id316965"><code class="sgmltag-element">config-spec</code> element</a></span></dt><dt><span class="section"><a href="ch08.html#id316991"><code class="sgmltag-element">summary</code> element</a></span></dt><dt><span class="section"><a href="ch08.html#id317016">Parameter Specifiations Elements</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id316834"></a>The Lire Report Configuration Specification Markup Language</h2></div></div></div><p>Document Type Definition for the Lire Report Configuration Specification
2
2
   Markup Language.</p><p>This DTD defines a grammar that is used to specify the
3
3
   configuration parameters used by the Lire framework. Besides the
4
4
   framework parameters, this DTD can be used by extensions writers to
98
98
             value     CDATA                               #IMPLIED &gt;
99
99
 
100
100
 
101
 
  </pre><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2575145"></a><code class="sgmltag-element">config-spec</code> element</h3></div></div></div><p>Root element of a configuration specification document. It
 
101
  </pre><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316965"></a><code class="sgmltag-element">config-spec</code> element</h3></div></div></div><p>Root element of a configuration specification document. It
102
102
    contains a list of parameter specifications..
103
103
   </p><p>This element doesn't have any attributes.</p><pre class="programlisting">
104
104
 
107
107
             %LRCSML.xmlns.attr; 
108
108
             %LRCML.xmlns.attr;                                         &gt;
109
109
 
110
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2575178"></a><code class="sgmltag-element">summary</code> element</h3></div></div></div><p>This element is used for a short one description of the
 
110
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316991"></a><code class="sgmltag-element">summary</code> element</h3></div></div></div><p>This element is used for a short one description of the
111
111
    parameter's purpose. Use the <code class="sgmltag-element">description</code>
112
112
    element for longer help text.
113
113
   </p><p>This element doesn't have any attribute.</p><pre class="programlisting">
114
114
 
115
115
&lt;!ELEMENT %LRCSML.summary;    (#PCDATA)                                &gt;
116
116
 
117
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2575207"></a>Parameter Specifiations Elements</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575213"></a>Common Attributes</h4></div></div></div><p>These attributes are common to all parameters specification
 
117
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317016"></a>Parameter Specifiations Elements</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317022"></a>Common Attributes</h4></div></div></div><p>These attributes are common to all parameters specification
118
118
     elements:</p><div class="variablelist"><dl><dt><span class="term">name</span></dt><dd><p>Contains the name of the parameter to which this
119
119
        specification apply.
120
120
       </p></dd><dt><span class="term">required</span></dt><dd><p>Determines if a valid value is required to make the
134
134
        summary  CDATA                                     #IMPLIED
135
135
        obsolete NMTOKEN                                   '0'"&gt;
136
136
 
137
 
    </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575322"></a><code class="sgmltag-element">boolean</code> element</h4></div></div></div><p>This element is used to define a boolean parameter which can
 
137
    </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317119"></a><code class="sgmltag-element">boolean</code> element</h4></div></div></div><p>This element is used to define a boolean parameter which can
138
138
     takes a <code class="constant">yes</code> or <code class="constant">no</code>
139
139
     value.
140
140
    </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
144
144
 %common.attr;
145
145
                                                                     &gt;
146
146
 
147
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575359"></a><code class="sgmltag-element">integer</code> element</h4></div></div></div><p>This element is used to define an integer parameter.</p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
 
147
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317151"></a><code class="sgmltag-element">integer</code> element</h4></div></div></div><p>This element is used to define an integer parameter.</p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
148
148
 
149
149
&lt;!ELEMENT %LRCSML.integer; (%common.mix.default;)                    &gt;
150
150
&lt;!ATTLIST %LRCSML.integer;
151
151
 %common.attr;
152
152
                                                                     &gt;
153
153
 
154
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575390"></a><code class="sgmltag-element">string</code> element</h4></div></div></div><p>This element is used to define an string parameter. These
 
154
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317175"></a><code class="sgmltag-element">string</code> element</h4></div></div></div><p>This element is used to define an string parameter. These
155
155
    parameters can contains any value.
156
156
   </p><p>This can have a <code class="sgmltag-attribute">valid-re</code> attribute which specify a
157
157
     regular expression that the value must match.</p><pre class="programlisting">
162
162
 valid-re CDATA                                         #IMPLIED
163
163
                                                                     &gt;
164
164
 
165
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575430"></a><code class="sgmltag-element">dlf-converter</code> element</h4></div></div></div><p>This element is used to select a registered
 
165
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317208"></a><code class="sgmltag-element">dlf-converter</code> element</h4></div></div></div><p>This element is used to select a registered
166
166
     DlfConverter.</p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
167
167
 
168
168
&lt;!ELEMENT %LRCSML.dlf-converter; (%common.mix.default;)              &gt;
170
170
 %common.attr;
171
171
                                                                     &gt;
172
172
 
173
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575461"></a><code class="sgmltag-element">dlf-schema</code> element</h4></div></div></div><p>This element is used to select an available DlfSchema.</p><p>If this element has the <code class="sgmltag-attribute">superservices</code> set, only
 
173
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317233"></a><code class="sgmltag-element">dlf-schema</code> element</h4></div></div></div><p>This element is used to select an available DlfSchema.</p><p>If this element has the <code class="sgmltag-attribute">superservices</code> set, only
174
174
      superservices can be selected.
175
175
    </p><pre class="programlisting">
176
176
 
180
180
 superservices NMTOKEN                                            '0'
181
181
                                                                     &gt;
182
182
 
183
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575500"></a><code class="sgmltag-element">dlf-streams</code> element</h4></div></div></div><p>This element is used to configure Lire::DlfStream in
 
183
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317264"></a><code class="sgmltag-element">dlf-streams</code> element</h4></div></div></div><p>This element is used to configure Lire::DlfStream in
184
184
     Lire::DlfStore.</p><p>This element has no attribute.</p><pre class="programlisting">
185
185
 
186
186
&lt;!ELEMENT %LRCSML.dlf-streams; (%common.mix.default;)                &gt;
188
188
 %common.attr;
189
189
                                                                     &gt;
190
190
 
191
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575531"></a><code class="sgmltag-element">command</code> element</h4></div></div></div><p>This element is used to define a command parameter.
 
191
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317290"></a><code class="sgmltag-element">command</code> element</h4></div></div></div><p>This element is used to define a command parameter.
192
192
    To be accepted as valid the parameter's value must point to an
193
193
    executable file or an executable file with the specified value
194
194
    must exist in a directory of the PATH environment variable.</p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
198
198
 %common.attr;
199
199
                                                                     &gt;
200
200
 
201
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575565"></a><code class="sgmltag-element">file</code> element</h4></div></div></div><p>This element is used to define a file parameter. To be
 
201
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317317"></a><code class="sgmltag-element">file</code> element</h4></div></div></div><p>This element is used to define a file parameter. To be
202
202
    accepted as valid, the parameter's value must point to an existing
203
203
    file.
204
204
   </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
208
208
 %common.attr;
209
209
                                                                     &gt;
210
210
 
211
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575598"></a><code class="sgmltag-element">directory</code> element</h4></div></div></div><p>This element is used to define a directory parameter. To be
 
211
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317342"></a><code class="sgmltag-element">directory</code> element</h4></div></div></div><p>This element is used to define a directory parameter. To be
212
212
    accepted as valid, the parameter's value must point to an existing
213
213
    directory.
214
214
   </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
218
218
 %common.attr;
219
219
                                                                     &gt;
220
220
 
221
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575630"></a><code class="sgmltag-element">executable</code> element</h4></div></div></div><p>This element is used to define an executable parameter. To be
 
221
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317368"></a><code class="sgmltag-element">executable</code> element</h4></div></div></div><p>This element is used to define an executable parameter. To be
222
222
    accepted as valid, the parameter's value must point to an existing
223
223
    executable file.
224
224
   </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
228
228
 %common.attr;
229
229
                                                                     &gt;
230
230
 
231
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575663"></a><code class="sgmltag-element">select</code> element</h4></div></div></div><p>This element is used to define a parameter for which the
 
231
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317395"></a><code class="sgmltag-element">select</code> element</h4></div></div></div><p>This element is used to define a parameter for which the
232
232
    value is selected among a set of options. The allowed set of
233
233
    options is specified using <code class="sgmltag-element">option</code> elements.
234
234
   </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
238
238
 %common.attr;
239
239
                                                                     &gt;
240
240
 
241
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575699"></a><code class="sgmltag-element">option</code> element</h4></div></div></div><p>This element is used to define the valid values for a
 
241
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317424"></a><code class="sgmltag-element">option</code> element</h4></div></div></div><p>This element is used to define the valid values for a
242
242
    <code class="sgmltag-element">select</code> parameter.
243
243
   </p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
244
244
 
247
247
 %common.attr;
248
248
                                                                     &gt;
249
249
 
250
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575733"></a><code class="sgmltag-element">list</code> element</h4></div></div></div><p>This element is used to define a parameter that can contains
 
250
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317453"></a><code class="sgmltag-element">list</code> element</h4></div></div></div><p>This element is used to define a parameter that can contains
251
251
    an ordered set of values. The type of values which can be
252
252
    contained is specified using other parameters elements. Any number
253
253
    of parameters of the type specified by the children elements can
259
259
 %common.attr;
260
260
                                                                     &gt;
261
261
 
262
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575769"></a><code class="sgmltag-element">object</code> element</h4></div></div></div><p>This element is used to define a parameter that will instantiate an
 
262
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317480"></a><code class="sgmltag-element">object</code> element</h4></div></div></div><p>This element is used to define a parameter that will instantiate an
263
263
    object. The object will be instantiated by calling the "new_from_config()"
264
264
    class method defined in the package specified by the element's <code class="sgmltag-attribute">class</code> attribute. The constructor will receive
265
265
    the hash instantiated from the parameter's components as parameter.
275
275
        label    NMTOKEN                                    #IMPLIED
276
276
                                                                     &gt;
277
277
 
278
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575821"></a><code class="sgmltag-element">output-format</code> element</h4></div></div></div><p>This element is used to select an available
 
278
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317522"></a><code class="sgmltag-element">output-format</code> element</h4></div></div></div><p>This element is used to select an available
279
279
     OutputFormat.</p><p>This element doesn't have any specific attributes.</p><pre class="programlisting">
280
280
 
281
281
&lt;!ELEMENT %LRCSML.output-format; (%common.mix.default;)              &gt;
283
283
 %common.attr;
284
284
                                                                     &gt;
285
285
 
286
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575852"></a><code class="sgmltag-element">record</code> element</h4></div></div></div><p>This element is used to define a parameter that holds record-like
 
286
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317547"></a><code class="sgmltag-element">record</code> element</h4></div></div></div><p>This element is used to define a parameter that holds record-like
287
287
    data.
288
288
   </p><p>The <code class="sgmltag-attribute">label</code> attribute can
289
289
     be used to specify the contained element that should be used to
296
296
        label    NMTOKEN                                    #IMPLIED
297
297
                                                                     &gt;
298
298
 
299
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575893"></a><code class="sgmltag-element">record</code> element</h4></div></div></div><p>This element is used to define a parameter that holds record-like
 
299
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317580"></a><code class="sgmltag-element">record</code> element</h4></div></div></div><p>This element is used to define a parameter that holds record-like
300
300
    data.
301
301
   </p><p>The <code class="sgmltag-attribute">label</code> attribute can
302
302
     be used to specify the contained element that should be used to
309
309
        label    NMTOKEN                                    #IMPLIED
310
310
                                                                     &gt;
311
311
 
312
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575933"></a><code class="sgmltag-element">reference</code> element</h4></div></div></div><p>This element is used to select from an index. The index in
 
312
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317613"></a><code class="sgmltag-element">reference</code> element</h4></div></div></div><p>This element is used to select from an index. The index in
313
313
     which the available values is taken is specified in the <code class="sgmltag-attribute">index</code> attribute.</p><pre class="programlisting">
314
314
 
315
315
&lt;!ELEMENT %LRCSML.reference; (%common.mix.default;)                   &gt;
318
318
 index  CDATA                                             #REQUIRED
319
319
                                                                     &gt;
320
320
 
321
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2575969"></a><code class="sgmltag-element">report-config</code> element</h4></div></div></div><p>This element is used to configure a report configuration.</p><p>This element doesn't have any attribute. Each superservice
 
321
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317642"></a><code class="sgmltag-element">report-config</code> element</h4></div></div></div><p>This element is used to configure a report configuration.</p><p>This element doesn't have any attribute. Each superservice
322
322
     can define a default report configuration using this element with
323
323
     a name of
324
324
     <code class="constant"><em class="replaceable"><code>superservice</code></em>_default</code>.
329
329
 %common.attr;
330
330
                                                                     &gt;
331
331
 
332
 
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2576007"></a><code class="sgmltag-element">plugin</code> element</h4></div></div></div><p>This element is used to define a parameter for which the value is
 
332
   </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id317674"></a><code class="sgmltag-element">plugin</code> element</h4></div></div></div><p>This element is used to define a parameter for which the value is
333
333
    selected among a set of options. The allowed set of options is specified
334
334
    using <code class="sgmltag-element">option</code> elements. The element will also contain
335
335
    additional parameters based on the selected value. The available