Fix history part (wrong formatting when using multiple revmarks 11/14011/3
Vincent COUVERT [Thu, 13 Mar 2014 15:23:08 +0000 (16:23 +0100)]
Change-Id: I0a702c9ca0843ac089ddfe3236be7a06f91b8d87

scilab/modules/graphics/help/en_US/axes_operations/axes_properties.xml
scilab/modules/windows_tools/help/en_US/winqueryreg.xml
scilab/modules/windows_tools/help/fr_FR/winqueryreg.xml

index f0b4bc0..c27a99f 100644 (file)
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="en" xml:id="axes_properties">
     <refnamediv>
         <refname>axes properties</refname>
-        <refpurpose>description of the axes entity
+        <refpurpose>
+            description of the axes entity
             properties
         </refpurpose>
     </refnamediv>
     <refsection>
         <title>Description</title>
-        <para>The Axes entity is the second level of the graphics entities hierarchy.
+        <para>
+            The Axes entity is the second level of the graphics entities hierarchy.
             This entity defines the parameters allowing the change of coordinates and
             the axes drawing as well as the parameters' default values for the
             children creation.
@@ -40,7 +42,8 @@
                         <varlistentry>
                             <term>children: </term>
                             <listitem>
-                                <para>FA vector containing the handles of all graphics objects
+                                <para>
+                                    FA vector containing the handles of all graphics objects
                                     children of the axes These graphics objects are of type
                                     <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
                                     <literal>"Polyline"</literal>, <literal>"Segs"</literal>, <literal>"Arc"</literal>,
                         <varlistentry>
                             <term>grid: </term>
                             <listitem>
-                                <para>The field value is a vector
+                                <para>
+                                    The field value is a vector
                                     <literal>[x-grid,y-grid,z-grid]</literal> where <literal>x-grid</literal>
-                                    controls a grid drawning for the x-axis and <literal>y-grid,
+                                    controls a grid drawning for the x-axis and <literal>
+                                        y-grid,
                                         z-grid
                                     </literal>
                                     respecting to the y-axis, z-axis. The default values
                         <varlistentry>
                             <term>grid_position: </term>
                             <listitem>
-                                <para>This character string specifies the grid position compared with other graphic entities.
+                                <para>
+                                    This character string specifies the grid position compared with other graphic entities.
                                     Its value can be either <literal>"foreground"</literal>
                                     to draw the grid ahead other graphic entities or <literal>"background"</literal> to draw the grid behind.
                                 </para>
                         <varlistentry>
                             <term>x_location: </term>
                             <listitem>
-                                <para>Specify the location of the x-axis. The possible values
+                                <para>
+                                    Specify the location of the x-axis. The possible values
                                     are:
                                 </para>
                                 <itemizedlist>
                         <varlistentry>
                             <term>y_location: </term>
                             <listitem>
-                                <para>Specify the location of the y-axis. The possible values
+                                <para>
+                                    Specify the location of the y-axis. The possible values
                                     are:
                                 </para>
                                 <itemizedlist>
                         <varlistentry>
                             <term>title: </term>
                             <listitem>
-                                <para>An object attached to the Axes entity and returning a graphic
+                                <para>
+                                    An object attached to the Axes entity and returning a graphic
                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
                                     This field defines a title with options on this label.
                                 </para>
                         <varlistentry>
                             <term>x_label: </term>
                             <listitem>
-                                <para>An object attached to the Axes entity and returning a graphic
+                                <para>
+                                    An object attached to the Axes entity and returning a graphic
                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
                                     This field defines a label on x axis with options on this
                                     label.
                         <varlistentry>
                             <term>y_label: </term>
                             <listitem>
-                                <para>An object attached to the Axes entity and returning a graphic
+                                <para>
+                                    An object attached to the Axes entity and returning a graphic
                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
                                     This field defines a label on y axis with options on this
                                     label.
                         <varlistentry>
                             <term>z_label: </term>
                             <listitem>
-                                <para>An object attached to the Axes entity and returning a graphic
+                                <para>
+                                    An object attached to the Axes entity and returning a graphic
                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
                                     This field defines a label on z axis with options on this
                                     label.
                         <varlistentry>
                             <term>x_ticks, y_ticks, z_ticks: </term>
                             <listitem>
-                                <para>Each of these properties is a tlist of type "ticks" with 2 fields named "locations" and "labels":
+                                <para>
+                                    Each of these properties is a tlist of type "ticks" with 2 fields named "locations" and "labels":
                                     <literal>tlist(["ticks", "locations", "labels"], Locations, Labels)</literal> where
                                     <variablelist>
                                         <varlistentry>
                         <varlistentry>
                             <term>ticks_format: </term>
                             <listitem>
-                                <para>This property specifies the format to use for each axes.
+                                <para>
+                                    This property specifies the format to use for each axes.
                                     It is a row vector with at most 3 columns containing strings format (as specified for <link linkend="mprintf">mprintf</link>). Each ticks position will be used to format the string used as label.
                                 </para>
                                 <para>
                         <varlistentry>
                             <term>box: </term>
                             <listitem>
-                                <para>This property specifies whether to enclose the axes in a box.
+                                <para>
+                                    This property specifies whether to enclose the axes in a box.
                                     Its value can be either <literal>"off"</literal>,
                                     <literal>"hidden_axes"</literal>, <literal>"back_half"</literal> or
                                     <literal>"on".</literal> If the property is <literal>"off"</literal>, the box
                         <varlistentry>
                             <term>filled: </term>
                             <listitem>
-                                <para>This property specifies whether the axes background should be drawn or not.
+                                <para>
+                                    This property specifies whether the axes background should be drawn or not.
                                     Its value can be either <literal>"off"</literal> or
                                     <literal>"on".</literal> If the property is <literal>"off"</literal>, the background
                                     is not drawn, the axes box is transparent. If the property is <literal>"on"</literal> the
                         <varlistentry>
                             <term>sub_ticks: </term>
                             <listitem>
-                                <para>This field sets the number of tics to draw between two main
+                                <para>
+                                    This field sets the number of tics to draw between two main
                                     tics. The field value is the vector <literal>[nx,ny]</literal> where
                                     <literal>nx</literal> is the number of sub tics for the x-axis and
                                     <literal>ny</literal> respecting to the y-axis.
                         <varlistentry>
                             <term>font_style: </term>
                             <listitem>
-                                <para>Specifies the font used for displaying tics labels. This is a positive integer referecing one of the loaded fonts.
+                                <para>
+                                    Specifies the font used for displaying tics labels. This is a positive integer referecing one of the loaded fonts.
                                     Its value must be between 0, referecing the first font,
                                     and the number of loaded fonts minus one, referencing the last font.
                                     For more information see <link linkend="graphics_fonts">graphics_fonts</link>.
                         <varlistentry>
                             <term>isoview: </term>
                             <listitem>
-                                <para>This property is used to have isometric scales on the x, y and
+                                <para>
+                                    This property is used to have isometric scales on the x, y and
                                     z axes (for exemple to make the display of the curve sin(x) versus
                                     cos(x) be a circle not an ellipse). Its value should be
                                     <literal>"on"</literal> or <literal>"off"</literal>. If the value is
                         <varlistentry>
                             <term>view: </term>
                             <listitem>
-                                <para>This field is related to the graphics universe. It takes
+                                <para>
+                                    This field is related to the graphics universe. It takes
                                     <literal>"3d"</literal> as value corresponding to the three-dimensional
                                     views. In the other case its value can be <literal>"2d"</literal> for
                                     initial 2d plotting (default value). This flag also depends on the
                         <varlistentry>
                             <term>log_flags: </term>
                             <listitem>
-                                <para> 3 character string that sets the scale (linear or logarithmic) along the axes.
+                                <para>
+                                    3 character string that sets the scale (linear or logarithmic) along the axes.
                                     Each character speficfies the scale for respectivgly the X, Y and Z axes.
                                     They should take a value between <literal>'n'</literal> for linear scale or
                                     <literal>'l'</literal> for logarithmic scale.
                         <varlistentry>
                             <term>data_bounds: </term>
                             <listitem>
-                                <para>This field contains the boundary values for the x, y and z
+                                <para>
+                                    This field contains the boundary values for the x, y and z
                                     coordinates. It is either the matrix or the vector
                                     <literal>[xmin,ymin; xmax,ymax]</literal>,
                                     <literal>[xmin,ymin,zmin; xmax,ymax,zmax]</literal>,
                         <varlistentry>
                             <term>zoom_box: </term>
                             <listitem>
-                                <para>This field contains the current zoom box if any coordinates
+                                <para>
+                                    This field contains the current zoom box if any coordinates
                                     are given. It is an empty matrix (no zoom) or the vector
                                     <literal>[xmin,ymin,xmax,ymax,zmin,zmax]</literal> (defines a smaller axes box).
                                 </para>
                         <varlistentry>
                             <term>margins: </term>
                             <listitem>
-                                <para>A vector
+                                <para>
+                                    A vector
                                     <literal>[margin_left,margin_right,margin_top,margin_bottom]</literal>
                                     specifying the margins portion for this axes. This vector is
                                     composed of numbers between [0 1] with default: [0.125 0.125 0.125
                         <varlistentry>
                             <term>auto_margins: </term>
                             <listitem>
-                                <para>A property to allow the automatic computation of the margins accordint to their contents.
+                                <para>
+                                    A property to allow the automatic computation of the margins accordint to their contents.
                                     If value is <literal>"on"</literal>, then the automatic computation is activated.
                                 </para>
                             </listitem>
                         <varlistentry>
                             <term>hidden_axis_color: </term>
                             <listitem>
-                                <para>This property defined the color of the hidden axis. It takes
+                                <para>
+                                    This property defined the color of the hidden axis. It takes
                                     an index relative to the current colormap.
                                 </para>
                             </listitem>
                         <varlistentry>
                             <term>user_data: </term>
                             <listitem>
-                                <para>This field can be use to store any scilab variable in the axes
+                                <para>
+                                    This field can be use to store any scilab variable in the axes
                                     data structure, and to retreive it.
                                 </para>
                             </listitem>
                         <varlistentry>
                             <term>auto_scale: </term>
                             <listitem>
-                                <para>A property to update the axes data boundary. If value is
+                                <para>
+                                    A property to update the axes data boundary. If value is
                                     <literal>"on"</literal>, a new plot will adapt the current axes
                                     properties to fit with previous and current plots. If its value is
                                     <literal>"off"</literal> the new plot will be drawn in the current axes
                         <varlistentry>
                             <term>hiddencolor: </term>
                             <listitem>
-                                <para>This property controls the hidden parts' color. It takes as
+                                <para>
+                                    This property controls the hidden parts' color. It takes as
                                     value an index relative to the current colormap. In another case,
                                     if it is a negative value, the hidden parts take the same colors
                                     as the surface
                         <varlistentry>
                             <term>mark_background: </term>
                             <listitem>
-                                <para>This property controls the default
+                                <para>
+                                    This property controls the default
                                     <literal>mark_background</literal> property value for all objects
                                     created under this axes. Polyline, rectangle, legend, surface,
                                     segment and axis objects are using this property to specify a
                                     <varlistentry>
                                         <term/>
                                         <listitem>
-                                            <para>All these listed properties and fields inherit from
+                                            <para>
+                                                All these listed properties and fields inherit from
                                                 default values stored in an axes model. These default values
                                                 can be seen and changed. To do so, use the
                                                 <literal>get("default_axes")</literal> command : it returns a
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[
+        <programlisting role="example">
+            <![CDATA[
 lines(0) // disables vertical paging
 a=get("current_axes")//get the handle of the newly created axes
 a.axes_visible="on"; // makes the axes visible
@@ -946,15 +978,18 @@ a.x_ticks = tlist(["ticks", "locations", "labels"], (0:6)', [mathml;"1";"$\sin(x
 // Mixed expression: MathML and LaTex
 a.y_ticks = tlist(["ticks", "locations", "labels"], (-2:0.5:2)', ["0";"1";"2";"3";"$\cos(a)$";"5";"6";mathml;"8"]);
 
- ]]></programlisting>
+ ]]>
+        </programlisting>
         <para/>
-        <programlisting role="example"><![CDATA[
+        <programlisting role="example">
+            <![CDATA[
 m=[66.425514; 66.425513];
 plot([69;70], m);
 a=gca();
 a.ticks_format=["" sprintf("%.2f", m(2))+"%+.1e"];
 a.ticks_st=[1 1;0 m(2)];
- ]]></programlisting>
+ ]]>
+        </programlisting>
     </refsection>
     <refsection role="see also">
         <title>See Also</title>
@@ -1003,9 +1038,13 @@ a.ticks_st=[1 1;0 m(2)];
             </revision>
             <revision>
                 <revnumber>5.5.0</revnumber>
-                <revremark>line_style values 9 and 10 can be used to have respectively longblank dot and bigblank dot styles.</revremark>
-                <revremark>auto_margins property added to allow automatic computation of the margins.</revremark>
-                <revremark>ticks_format and ticks_st properties added to improve ticks labels display.</revremark>
+                <revremark>
+                    <itemizelist>
+                        <listitem>line_style values 9 and 10 can be used to have respectively longblank dot and bigblank dot styles.</listitem>
+                        <listitem>auto_margins property added to allow automatic computation of the margins.</listitem>
+                        <listitem>ticks_format and ticks_st properties added to improve ticks labels display.</listitem>
+                    </itemizelist>
+                </revremark>
             </revision>
         </revhistory>
     </refsection>
index 55fac5d..1f911f1 100644 (file)
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
+        <?xml version="1.0" encoding="UTF-8"?>
+        <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Allan CORNET
  * 
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="winqueryreg">
-    <refnamediv>
-        <refname>winqueryreg</refname>
-        <refpurpose>Get item from Microsoft Windows
-            registry (Windows only)
-        </refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>Calling Sequence</title>
-        <synopsis>
-            value = winqueryreg('name', 'rootkey','subkey')
-            value = winqueryreg('key', 'rootkey','subkey')
-            value = winqueryreg('rootkey', 'subkey','valname')
-            value = winqueryreg('rootkey','subkey')
-        </synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>Description</title>
-        <para>
-            value = winqueryreg('name', 'rootkey', 'subkey') returns the values names
-            in <literal>rootkey\subkey</literal> in a matrix of strings. The first argument
-            is the literal quoted string, 'name'.
-        </para>
-        <para>If the data retrieved from the registry is a string, winqueryreg
-            returns a string. If the data is a 32-bit integer, winqueryreg returns
-            the data as an integer (int32).
-        </para>
-        <para>
-            value = winqueryreg('key', 'rootkey', 'subkey') returns the keys names
-            in <literal>rootkey\subkey</literal> in a matrix of strings. The first argument
-            is the literal quoted string, 'key'.
-        </para>
-        <para>value = winqueryreg('rootkey', 'subkey', 'valname') returns the data
-            for value valname in <literal>rootkey\subkey</literal>.
-        </para>
-        <para>value = winqueryreg('rootkey', 'subkey') returns a data in
-            <literal>rootkey\subkey</literal> that has no value name property.
-        </para>
-        <para>
-            <literal>Note</literal>The literal name argument, key argument and the rootkey argument
-            are case-sensitive. The subkey and valname arguments are not.
-        </para>
-        <para>supported root keys are: 'HKEY_CLASSES_ROOT', 'HKEY_CURRENT_USER', 'HKEY_LOCAL_MACHINE', 'HKEY_USERS', 'HKEY_DYN_DATA' and 'HKEY_CURRENT_CONFIG'.</para>
-        <para>and shortcut names: 'HKCR', 'HKCU', 'HKLM', 'HKU', 'HKDD' and 'HKCC'.</para>
-    </refsection>
-    <refsection>
-        <title>Examples</title>
-        <programlisting role="example">
-            <![CDATA[ 
+        <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="winqueryreg">
+            <refnamediv>
+                <refname>winqueryreg</refname>
+                <refpurpose>Get item from Microsoft Windows
+                    registry (Windows only)
+                </refpurpose>
+            </refnamediv>
+            <refsynopsisdiv>
+                <title>Calling Sequence</title>
+                <synopsis>
+                    value = winqueryreg('name', 'rootkey','subkey')
+                    value = winqueryreg('key', 'rootkey','subkey')
+                    value = winqueryreg('rootkey', 'subkey','valname')
+                    value = winqueryreg('rootkey','subkey')
+                </synopsis>
+            </refsynopsisdiv>
+            <refsection>
+                <title>Description</title>
+                <para>
+                    value = winqueryreg('name', 'rootkey', 'subkey') returns the values names
+                    in <literal>rootkey\subkey</literal> in a matrix of strings. The first argument
+                    is the literal quoted string, 'name'.
+                </para>
+                <para>If the data retrieved from the registry is a string, winqueryreg
+                    returns a string. If the data is a 32-bit integer, winqueryreg returns
+                    the data as an integer (int32).
+                </para>
+                <para>
+                    value = winqueryreg('key', 'rootkey', 'subkey') returns the keys names
+                    in <literal>rootkey\subkey</literal> in a matrix of strings. The first argument
+                    is the literal quoted string, 'key'.
+                </para>
+                <para>value = winqueryreg('rootkey', 'subkey', 'valname') returns the data
+                    for value valname in <literal>rootkey\subkey</literal>.
+                </para>
+                <para>value = winqueryreg('rootkey', 'subkey') returns a data in
+                    <literal>rootkey\subkey</literal> that has no value name property.
+                </para>
+                <para>
+                    <literal>Note</literal>The literal name argument, key argument and the rootkey argument
+                    are case-sensitive. The subkey and valname arguments are not.
+                </para>
+                <para>supported root keys are: 'HKEY_CLASSES_ROOT', 'HKEY_CURRENT_USER', 'HKEY_LOCAL_MACHINE', 'HKEY_USERS', 'HKEY_DYN_DATA' and 'HKEY_CURRENT_CONFIG'.</para>
+                <para>and shortcut names: 'HKCR', 'HKCU', 'HKLM', 'HKU', 'HKDD' and 'HKCC'.</para>
+            </refsection>
+            <refsection>
+                <title>Examples</title>
+                <programlisting role="example">
+                    <![CDATA[ 
 if getos() == 'Windows' then
     winqueryreg 'HKEY_LOCAL_MACHINE' 'HARDWARE\DESCRIPTION\System\CentralProcessor\0\' 'ProcessorNameString'
     
@@ -75,20 +75,24 @@ if getos() == 'Windows' then
     winqueryreg('key' ,'HKLM', 'Software\Microsoft\.NETFramework')
 end
  ]]>
-        </programlisting>
-    </refsection>
-    <refsection>
-        <title>History</title>
-        <revhistory>
-            <revision>
-                <revnumber>5.4.0</revnumber>
-                <revremark>This function also manages 'HKEY_CURRENT_CONFIG' key.</revremark>
-            </revision>
-            <revision>
-                <revnumber>5.4.1</revnumber>
-                <revremark>Manage shorcut root names.</revremark>
-                <revremark>Can retrieve key list names.</revremark>
-            </revision>
-        </revhistory>
-    </refsection>
-</refentry>
+                </programlisting>
+            </refsection>
+            <refsection>
+                <title>History</title>
+                <revhistory>
+                    <revision>
+                        <revnumber>5.4.0</revnumber>
+                        <revremark>This function also manages 'HKEY_CURRENT_CONFIG' key.</revremark>
+                    </revision>
+                    <revision>
+                        <revnumber>5.4.1</revnumber>
+                        <revremark>
+                            <itemizedlist>
+                                <listitem>Manage shorcut root names.</listitem>
+                                <listitem>Can retrieve key list names.</listitem>
+                            </itemizedlist>
+                        </revremark>
+                    </revision>
+                </revhistory>
+            </refsection>
+        </refentry>
index 40da86a..9fa8c95 100644 (file)
@@ -1,53 +1,53 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="winqueryreg">
-    <refnamediv>
-        <refname>winqueryreg</refname>
-        <refpurpose>Obtenir une clef de la base des
-            registres de Microsoft Windows
-        </refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>Séquence d'appel</title>
-        <synopsis>
-            value = winqueryreg('name', 'rootkey', 'subkey')
-            value = winqueryreg('key', 'rootkey', 'subkey')
-            value = winqueryreg('rootkey', 'subkey', 'valname')
-            value = winqueryreg('rootkey', 'subkey')
-        </synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>Description</title>
-        <para>value = winqueryreg('name', 'rootkey', 'subkey') retourne les clefs
-            contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
-            Le premier argument doit etre la chaine de caracteres, 'name'.
-        </para>
-        <para>Si la valeur contenue dans la base des registres est une chaine de
-            caracteres, winqueryreg retourne une chaine de caracteres. Si la valeur
-            est un entier sur 32 bits, winqueryreg retourne la valeur comme un entier
-            (int32).
-        </para>
-        <para>
-            value = winqueryreg('key', 'rootkey', 'subkey') retourne les sous clés
-            contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
-            Le premier argument doit etre la chaine de caracteres, 'key'.
-        </para>
-        <para>value = winqueryreg('rootkey', 'subkey', 'valname') retourne la valeur
-            pour la clef valname dans rootkey\subkey.
-        </para>
-        <para>value = winqueryreg('rootkey', 'subkey') retourne la valeur "par
-            défaut" de la clef rootkey\subkey.
-        </para>
-        <para>
-            <literal>Note</literal>Les arguments 'name', 'key et 'rootkey' sont
-            "case-sensitive". Les arguments 'subkey' et 'valname' ne le sont pas.
-        </para>
-        <para>Les clefs racine supportées sont: 'HKEY_CLASSES_ROOT', 'HKEY_CURRENT_USER', 'HKEY_LOCAL_MACHINE', 'HKEY_USERS', 'HKEY_DYN_DATA' and 'HKEY_CURRENT_CONFIG'.</para>
-        <para>Leurs raccourcis peuvent aussi être utilisé 'HKCR', 'HKCU', 'HKLM', 'HKU', 'HKDD' and 'HKCC'</para>
-    </refsection>
-    <refsection>
-        <title>Exemples</title>
-        <programlisting role="example">
-            <![CDATA[
+        <?xml version="1.0" encoding="UTF-8"?>
+        <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="winqueryreg">
+            <refnamediv>
+                <refname>winqueryreg</refname>
+                <refpurpose>Obtenir une clef de la base des
+                    registres de Microsoft Windows
+                </refpurpose>
+            </refnamediv>
+            <refsynopsisdiv>
+                <title>Séquence d'appel</title>
+                <synopsis>
+                    value = winqueryreg('name', 'rootkey', 'subkey')
+                    value = winqueryreg('key', 'rootkey', 'subkey')
+                    value = winqueryreg('rootkey', 'subkey', 'valname')
+                    value = winqueryreg('rootkey', 'subkey')
+                </synopsis>
+            </refsynopsisdiv>
+            <refsection>
+                <title>Description</title>
+                <para>value = winqueryreg('name', 'rootkey', 'subkey') retourne les clefs
+                    contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
+                    Le premier argument doit etre la chaine de caracteres, 'name'.
+                </para>
+                <para>Si la valeur contenue dans la base des registres est une chaine de
+                    caracteres, winqueryreg retourne une chaine de caracteres. Si la valeur
+                    est un entier sur 32 bits, winqueryreg retourne la valeur comme un entier
+                    (int32).
+                </para>
+                <para>
+                    value = winqueryreg('key', 'rootkey', 'subkey') retourne les sous clés
+                    contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
+                    Le premier argument doit etre la chaine de caracteres, 'key'.
+                </para>
+                <para>value = winqueryreg('rootkey', 'subkey', 'valname') retourne la valeur
+                    pour la clef valname dans rootkey\subkey.
+                </para>
+                <para>value = winqueryreg('rootkey', 'subkey') retourne la valeur "par
+                    défaut" de la clef rootkey\subkey.
+                </para>
+                <para>
+                    <literal>Note</literal>Les arguments 'name', 'key et 'rootkey' sont
+                    "case-sensitive". Les arguments 'subkey' et 'valname' ne le sont pas.
+                </para>
+                <para>Les clefs racine supportées sont: 'HKEY_CLASSES_ROOT', 'HKEY_CURRENT_USER', 'HKEY_LOCAL_MACHINE', 'HKEY_USERS', 'HKEY_DYN_DATA' and 'HKEY_CURRENT_CONFIG'.</para>
+                <para>Leurs raccourcis peuvent aussi être utilisé 'HKCR', 'HKCU', 'HKLM', 'HKU', 'HKDD' and 'HKCC'</para>
+            </refsection>
+            <refsection>
+                <title>Exemples</title>
+                <programlisting role="example">
+                    <![CDATA[
 if getos() == 'Windows' then
     winqueryreg 'HKEY_LOCAL_MACHINE' 'HARDWARE\DESCRIPTION\System\CentralProcessor\0\' 'ProcessorNameString'
 
@@ -64,20 +64,24 @@ if getos() == 'Windows' then
     winqueryreg('key' ,'HKLM', 'Software\Microsoft\.NETFramework')
 end
  ]]>
-        </programlisting>
-    </refsection>
-    <refsection>
-        <title>History</title>
-        <revhistory>
-            <revision>
-                <revnumber>5.4.0</revnumber>
-                <revremark>Cette fonction gére également la clé 'HKEY_CURRENT_CONFIG'.</revremark>
-            </revision>
-            <revision>
-                <revnumber>5.4.1</revnumber>
-                <revremark>Accepte les raccourcis de clés racine.</revremark>
-                <revremark>Peut renvoyer la liste des noms de clés.</revremark>
-            </revision>
-        </revhistory>
-    </refsection>
-</refentry>
+                </programlisting>
+            </refsection>
+            <refsection>
+                <title>History</title>
+                <revhistory>
+                    <revision>
+                        <revnumber>5.4.0</revnumber>
+                        <revremark>Cette fonction gére également la clé 'HKEY_CURRENT_CONFIG'.</revremark>
+                    </revision>
+                    <revision>
+                        <revnumber>5.4.1</revnumber>
+                        <revremark>
+                            <itemizedlist>
+                                <listitem>Accepte les raccourcis de clés racine.</listitem>
+                                <listitem>Peut renvoyer la liste des noms de clés.</listitem>
+                            </itemizedlist>
+                        </revremark>
+                    </revision>
+                </revhistory>
+            </refsection>
+        </refentry>