Index: trunk/SRC/Documentation/xmldoc/all_plots_docbook.xsl
===================================================================
--- trunk/SRC/Documentation/xmldoc/all_plots_docbook.xsl	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/all_plots_docbook.xsl	(revision 345)
@@ -1,5 +1,10 @@
-<?xml version="1.0" encoding="iso-8859-1" ?>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<xsl:stylesheet
+version="1.0"
+xmlns:dbk="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <!--
-module : 
+module :
 generation of a docbook file for display all plots of firtsteps.xml
 
@@ -8,4 +13,6 @@
 
 update :
+fplod 2008-04-15T12:40:25Z aedon.locean-ipsl.upmc.fr (Darwin)
+adaptation to docbook 5 in and out
 fplod 2006-05-17T09:59:52Z aedon.lodyc.jussieu.fr (Darwin)
 fplod 2006-09-21T14:58:05Z aedon.locean-ipsl.upmc.fr (Darwin)
@@ -13,21 +20,22 @@
 -->
 
-<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
-<xsl:output 
- method="xml" 
- indent="yes" 
- encoding="iso-8859-1"
- omit-xml-declaration="no"
- doctype-public="-//OASIS//DTD DocBook XML V4.2//EN"
- doctype-system="http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"/>
+<xsl:output
+ method="xml"
+ indent="yes"
+ omit-xml-declaration="no"/>
 
- <xsl:template match="article"> 
-  <article id="all_plots" lang="en">
+<xsl:template match="/">
+ <xsl:element name="article">
+ <xsl:attribute name="version">5.0</xsl:attribute>
+ <xsl:attribute name="xmlns">http://docbook.org/ns/docbook</xsl:attribute>
+ <xsl:attribute name="xml:lang">en</xsl:attribute>
+ <xsl:attribute name="xml:id">all_plots</xsl:attribute>
+
   <title>All plots of SAXO demo</title>
-    <articleinfo>
+    <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>smasson_at_lodyc.jussieu.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_lodyc.jussieu.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>smasson_at_lodyc.jussieu.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_lodyc.jussieu.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -35,62 +43,70 @@
       <keyword>SAXO</keyword>
     </keywordset>
-    </articleinfo>
-    <sect1 id="intro">
+    </info>
+    <sect1 xml:id="intro">
     <title>Introduction</title>
     <para>
-      This page gathers all plots used in <ulink url="firststeps.html">firststeps</ulink> and display them in one unique page to facilitate the search of plots examples.
+      This page gathers all plots used in <link xl:href="firststeps.html">firststeps</link> and display them in one unique page to facilitate the search of plots examples.
     </para>
     </sect1>
-    <sect1 id="allplots">
+    <sect1 xml:id="allplots">
     <title>All plots</title>
+     <xsl:element name="itemizedlist">
 
-<!-- for all ulink where url is something .png
-plot it with the title of the closest ancestor which have an id attibutes
+<!-- for all links where xl:href is something .png
+plot it with the title of the closest ancestor which have an xml:id attribute
 -->
-<xsl:for-each select="self::node()/descendant-or-self::node()/child::ulink[contains(@url,'png')]">
-  <xsl:sort order="ascending" data-type="text" select="@url"/>
+<!-- version dbk 4 pour mémoire
+<xsl:for-each select="self::node()/descendant-or-self::node()/child::link[contains(@xl:href,'png')]">
+-->
+<xsl:for-each select="//dbk:link[contains(@xl:href,'png')]">
+  <xsl:sort order="ascending" data-type="text" select="@xl:href"/>
   <xsl:call-template name="plot">
-      <xsl:with-param name="url" select="@url"/>
-      <xsl:with-param name="id" select="(ancestor-or-self::node()/@id)[last()]"/>
-      <xsl:with-param name="title" select="(ancestor-or-self::node()/title)[last()]"/>
+      <xsl:with-param name="href" select="@xl:href"/>
+      <xsl:with-param name="id" select="(ancestor-or-self::node()/@xml:id)[last()]"/>
+      <xsl:with-param name="title" select="(ancestor-or-self::node()/dbk:title)[last()]"/>
   </xsl:call-template>
 </xsl:for-each>
+   </xsl:element>
   </sect1>
-  </article>
- </xsl:template> 
+  </xsl:element>
+</xsl:template>
 
-    <xsl:template name="plot"> 
-        <xsl:param name="url"/>  
-        <xsl:param name="id"/>  
-        <xsl:param name="title"/>  
-        <xsl:element name="para">
-        <xsl:element name="mediaobject">
+    <xsl:template name="plot">
+        <xsl:param name="href"/>
+        <xsl:param name="id"/>
+        <xsl:param name="title"/>
+        <xsl:element name="listitem">
+         <xsl:element name="para">
+          [plot <xsl:value-of select="$href"/>]
+         </xsl:element> 
+         <xsl:element name="para">
+          <xsl:element name="mediaobject">
             <xsl:element name="imageobject">
                 <xsl:element name="imagedata">
-                    <xsl:attribute name="fileref"><xsl:value-of select="$url"/></xsl:attribute>
+                    <xsl:attribute name="fileref"><xsl:value-of select="$href"/></xsl:attribute>
                     <xsl:attribute name="format">PNG</xsl:attribute>
                     <xsl:attribute name="valign">top</xsl:attribute>
                 </xsl:element>
             </xsl:element>
+            <xsl:element name="textobject">
+             <xsl:element name="phrase">
+              [plot <xsl:value-of select="$href"/>]
+             </xsl:element>
+            </xsl:element>
+            <xsl:element name="caption">
+             <xsl:element name="para">
+              cf. 
+              <xsl:element name="link">
+               <xsl:attribute name="xl:href">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute>
+                <xsl:value-of select="$title"/>
+              </xsl:element>
+              <xsl:text> in </xsl:text><xsl:value-of select="//dbk:title"/>
+             </xsl:element>
+            </xsl:element>
+           </xsl:element>
+          </xsl:element>
         </xsl:element>
-        <xsl:element name="textobject">
-            <xsl:element name="phrase">
-                [plot <xsl:value-of select="$url"/>]
-            </xsl:element>
-        </xsl:element>
-        <xsl:element name="caption">
-            <xsl:element name="para">
-            cf. <xsl:element name="ulink">
-<!--
-                    <xsl:attribute name="url">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute>
--->
-                    <xsl:attribute name="url">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute>
-                <xsl:value-of select="$title"/>
-                </xsl:element>
-                <xsl:text>in First steps with SAXO</xsl:text> <!--++ récupérer le titre de l'article -->
-            </xsl:element>
-        </xsl:element>
-        </xsl:element>
-    </xsl:template> 
+    </xsl:template>
 
 </xsl:stylesheet>
Index: trunk/SRC/Documentation/xmldoc/doidldoc.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/doidldoc.sh	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/doidldoc.sh	(revision 345)
@@ -6,4 +6,10 @@
 # update :
 # $Id$
+# fplod 2008-01-10T08:13:41Z aedon.locean-ipsl.upmc.fr (Darwin)
+# version 
+# http://cookbook.idldev.com/idldoc-3.0rc2.zip
+# fplod 2008-01-03T09:59:18Z aedon.locean-ipsl.upmc.fr (Darwin)
+# version 
+# http://cookbook.idldev.com/idldoc-3.0rc1.zip
 # fplod 2007-12-12T09:47:04Z aedon.locean-ipsl.upmc.fr (Darwin)
 # version
@@ -42,4 +48,5 @@
 root="../../"
 root="/Users/fplod/SAXO_DIR_ws/SRC/" #++ à cause du cd pour éviter expand_path
+# ++ pb avec /Users/fplod/SAXO_DIR_ws/SRC/ToBeReviewed/UTILITAIRE/oups.pro ELEMENTS ... à cause de todo
 #root="/usr/home/fplod/src/mglib/" # overriding root for test ++
 #
@@ -49,7 +56,9 @@
 #idldoc_dir="/usr/home/fplod/src/idldoc-3.0b4-src/" # overriding idldoc_dir for test ++
 idldoc_dir="/usr/home/fplod/src/idldoc-3.0b4/" # overriding idldoc_dir for test ++
+idldoc_dir="/usr/home/fplod/src/idldoc-3.0rc2/" # overriding idldoc_dir for test ++
 template_location=${idldoc_dir}/templates/
 #++ pas fini 
-#template_location=${idldoc_dir}/templates_dbk/ # overriding TEMPLATE_LOCATION++
+template_location=${idldoc_dir}/templates_dbk/ # overriding TEMPLATE_LOCATION++
+template_location=/usr/home/fplod/src/idldoc-3.0b3/templates_dbk/ # overriding TEMPLATE_LOCATION++
 #
 # memorize current directory
@@ -65,4 +74,5 @@
 
 #+++ a remettre pour dbk template_location="${template_location}", $
+#++MARKUP_STYLE="verbatim", $
 # !path = expand_path('+' + '${idldoc_dir}')
 cd ${idldoc_dir}
@@ -71,9 +81,11 @@
 cat <<EOF > ${pro}
 idldoc,root="${root}",title="${title}", $
+CHARSET="ISO-8859-15", $
 LOG_FILE="${log}", $
 output="${outputtmp}", $
+template_prefix="dbk", $
 template_location="${template_location}", $
-COMMENT_STYLE="latex", $
-overview="../../overview", /statistics
+overview="../../overview", /statistics, $
+COMMENT_STYLE="assistant"
 exit
 EOF
Index: trunk/SRC/Documentation/xmldoc/faqsaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/faqsaxo.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/faqsaxo.xml	(revision 345)
@@ -1,9 +1,13 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article [
 <!ENTITY promptidl "idl&gt;">
 ]>
-<article>
+
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en"
+xml:id="faqsaxo">
+
 <!--
 en s'inspirant de
@@ -21,8 +25,8 @@
 -->
 <title>Frequently Asked questions about SAXO</title>
-  <articleinfo>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -42,11 +46,14 @@
         <revremark>+ onlinehelp</revremark>
       </revision>
+      <revision>
+        <revnumber>0.2</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
     </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
 <qandaset>
-<qandadiv id="intro">
-<title>Introduction</title>
 <para>
 This is a list of Frequently Asked Questions about SAXO.
@@ -59,6 +66,5 @@
 Suggestions for corrections or additional sections are welcome -- please email them to <email>saxo-dev@forge.ipsl.jussieu.fr</email>.
 </para>
-</qandadiv>
-<qandadiv id="general">
+<qandadiv xml:id="general">
 <title>General</title>
 <qandaentry>
@@ -70,5 +76,5 @@
 <answer>
 <para>
-see document <ulink url="./whatissaxo.html">What is SAXO</ulink>.
+see document <link xl:href="./whatissaxo.html">What is SAXO</link>.
 </para>
 </answer>
@@ -82,5 +88,5 @@
 <answer>
 <para>
-see Support in document <ulink url="./websaxo.html">Main page of SAXO</ulink>.
+see Support in document <link xl:href="./websaxo.html">Main page of SAXO</link>.
 </para>
 </answer>
@@ -94,5 +100,5 @@
 <answer>
 <para>
-see document <ulink url="./getsaxo.html">Get SAXO</ulink>.
+see document <link xl:href="./getsaxo.html">Get SAXO</link>.
 </para>
 </answer>
@@ -167,5 +173,5 @@
 </qandaentry>
 </qandadiv>
-<qandadiv id="technical">
+<qandadiv xml:id="technical">
 <title>Technical questions</title>
 <qandaentry>
@@ -177,5 +183,5 @@
 <answer>
 <para>
-Yes, if you use at least IDL 6.2. It is produced by <application><ulink url="http://www.ittvis.com/codebank/search.asp?FID=100">IDLdoc</ulink></application>. SAXO and IDL online_help have been merged, you can simply get the help by typing:
+Yes, if you use at least IDL 6.2. It is produced by <application><link xl:href="http://www.ittvis.com/codebank/search.asp?FID=100">IDLdoc</link></application>. SAXO and IDL online_help have been merged, you can simply get the help by typing:
      <screen>
        <prompt>&promptidl;</prompt> <userinput><command>?</command></userinput>
@@ -185,5 +191,5 @@
 </qandaentry>
 </qandadiv>
-<qandadiv id="Contributors">
+<qandadiv xml:id="Contributors">
 <title>Contributors</title>
 <qandaentry>
@@ -195,5 +201,5 @@
 <answer>
 <para>
-There is a template for header <ulink url="../new_header.txt">new_header.txt</ulink>
+There is a template for header <link xl:href="../new_header.txt">new_header.txt</link>
 which can be parsed by <application>IDLdoc</application>.
 </para>
@@ -277,5 +283,5 @@
 There is one way with command line :
      <screen>
-       <prompt>$</prompt> <userinput><command>aspell</command> <option>--mode=sgml</option> <option>-c</option> <parameter><filename><replaceable>xmlfile</replaceable></filename></parameter></userinput>
+       <prompt>$</prompt> <userinput><command>aspell</command> <option>--mode=sgml</option> <option>-c</option> <filename><replaceable>xmlfile</replaceable></filename></userinput>
      </screen>
 </para>
@@ -292,5 +298,5 @@
 Not so easy but you can start with something like this :
      <screen>
-       <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR/SRC</parameter></userinput>
+       <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">${HOME}/SAXO_DIR/SRC/</filename></userinput>
        <prompt>$</prompt> <userinput>list=$(find . -name "*.pro")</userinput>
        <prompt>$</prompt> <userinput>for file in ${list}; do aspell list &lt; ${file}; done > /tmp/list_word </userinput>
Index: trunk/SRC/Documentation/xmldoc/firststeps.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/firststeps.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/firststeps.xml	(revision 345)
@@ -1,7 +1,16 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
-<!ENTITY hellip	"&#x2026;">
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article [
+<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
+%isolat1;
+<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
+%isolat2;
+<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
+%isogrk3;
+<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
+%isopub;
+<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
+%isotech;
+<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
+%isonum;
 <!ENTITY promptidl "idl&gt;">
 <!ENTITY numb1 '<inlinemediaobject><imageobject><imagedata fileref="images/callouts/1.png" format="PNG"/></imageobject><textobject><phrase>1</phrase></textobject></inlinemediaobject>'>
@@ -9,4 +18,11 @@
 <!ENTITY showfig '<inlinemediaobject><imageobject><imagedata fileref="images/showfig.png" format="PNG"/></imageobject><textobject><phrase>show result</phrase></textobject></inlinemediaobject>'>
 ]>
+
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="firststeps">
 
 <!--
@@ -27,13 +43,10 @@
 
 -->
-<article lang="en">
-  <title>
-    First steps with <application>SAXO</application>
-  </title>
-
-  <articleinfo>
+  <title> First steps with <application>SAXO</application> </title>
+
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -43,43 +56,45 @@
     <revhistory>
       <revision>
-	<revnumber>0.0</revnumber>
-	<date>29 July 2005</date>
-	<revremark>First draft</revremark>
+<revnumber>0.0</revnumber>
+<date>29 July 2005</date>
+<revremark>First draft</revremark>
       </revision>
       <revision>
-	<revnumber>0.1</revnumber>
-	<date>29 August 2005</date>
-	<revremark>last Japanese version!</revremark>
+<revnumber>0.1</revnumber>
+<date>29 August 2005</date>
+<revremark>last Japanese version!</revremark>
       </revision>
       <revision>
-	<revnumber>0.2</revnumber>
-	<date>May 2006</date>
-	<revremark>split with getsaxo</revremark>
+<revnumber>0.2</revnumber>
+<date>May 2006</date>
+<revremark>split with getsaxo</revremark>
       </revision>
+      <revision>
+        <revnumber>0.3</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+
      </revhistory>
      <pubdate>$Id$</pubdate>
-  </articleinfo>
-<sect1 id="beforefirststeps">
+  </info>
+<sect1 xml:id="beforefirststeps">
 <title>Before this</title>
 <para>
-In this document, we supposed that you followed <ulink url="./getsaxo.html">Get SAXO</ulink> recommendations.
+In this document, we supposed that you followed <link xl:href="./getsaxo.html">Get SAXO</link> recommendations.
 </para>
 </sect1>
 
-  <sect1 id="first_plots">
-    <title>
-      First plots &hellip;
-    </title>
-    <sect2 id="start_with_init">
-      <title>
-	Start IDL session: <userinput><command>@init</command></userinput>
-      </title>
-      <para>
-	Each IDL session using <application>SAXO</application> must always start with: <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>.
-      </para>
-      <para>
-	<emphasis>The @ is equivalent to an include. It is used to execute a set of IDL commands that will be directly executed without any compilation (as it is the case for a procedure or a function). All variables defined and used in the @&hellip; file will still be accessible after the execution of the @&hellip; is finished (which is not the case for procedures and functions that ends with the return instruction).</emphasis>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory"><envar>${HOME}</envar>/My_IDL/</filename></userinput>
+  <sect1 xml:id="first_plots">
+    <title> First plots &hellip; </title>
+    <sect2 xml:id="start_with_init">
+      <title> Start IDL session: <userinput><command>@init</command></userinput> </title>
+      <para>
+Each IDL session using <application>SAXO</application> must always start with: <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>.
+      </para>
+      <para>
+<emphasis>The @ is equivalent to an include. It is used to execute a set of IDL commands that will be directly executed without any compilation (as it is the case for a procedure or a function). All variables defined and used in the @&hellip; file will still be accessible after the execution of the @&hellip; is finished (which is not the case for procedures and functions that ends with the return instruction).</emphasis>
+<screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">${HOME}/My_IDL/</filename></userinput>
   <prompt>$</prompt> <userinput><command>idl</command></userinput>
   <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput>
@@ -102,53 +117,49 @@
   <computeroutput>% Compiled module: LOADCT.</computeroutput>
   <prompt>&promptidl;</prompt>
-	</screen>
-	As an IDL session using <application>SAXO</application> must always start with <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>, it could be convenient to define the environment variable <envar>IDL_STARTUP</envar> to <filename><envar>${HOME}</envar>/My_IDL/init.pro</filename>. In that way, <filename>init.pro</filename> will automatically been executed when starting IDL. This can be done with the following command:
+</screen>
+As an IDL session using <application>SAXO</application> must always start with <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>, it could be convenient to define the environment variable <envar>IDL_STARTUP</envar> to <filename>${HOME}/My_IDL/init.pro</filename>. In that way, <filename>init.pro</filename> will automatically been executed when starting IDL. This can be done with the following command:
       <variablelist>
-	<varlistentry><term><command>csh</command></term>
-	<listitem><screen><prompt>$</prompt> <userinput><command>setenv</command> <envar>IDL_STARTUP</envar> <filename><envar>${HOME}</envar>/My_IDL/init.pro</filename></userinput></screen></listitem>
-	</varlistentry>
-	<varlistentry><term><command>ksh</command></term>
-	<listitem><screen><prompt>$</prompt> <userinput><command>export</command> <envar>IDL_STARTUP</envar>=<filename><envar>${HOME}</envar>/My_IDL/init.pro</filename></userinput></screen></listitem>
-	</varlistentry>
+<varlistentry><term><command>csh</command></term>
+<listitem><screen><prompt>$</prompt> <userinput><command>setenv</command> <envar>IDL_STARTUP</envar> <filename>${HOME}/My_IDL/init.pro</filename></userinput></screen></listitem>
+</varlistentry>
+<varlistentry><term><command>ksh</command></term>
+<listitem><screen><prompt>$</prompt> <userinput><command>export</command> <envar>IDL_STARTUP</envar>=<filename>${HOME}/My_IDL/init.pro</filename></userinput></screen></listitem>
+</varlistentry>
       </variablelist>
       </para>
     </sect2>
-    <sect2 id="basic_plots">
-      <title>
-	Basic plots &hellip;
-      </title>
-      <sect3 id="basic_splot">
-      <title>
-	splot
-      </title>
-
-      <para>
-	<screenco>
-	  <areaspec>
-	    <area id="findgen" coords='2'/>
-	  </areaspec>
-	<screen format="linespecific">
+    <sect2 xml:id="basic_plots">
+      <title> Basic plots &hellip; </title>
+      <sect3 xml:id="basic_splot">
+      <title> splot </title>
+
+      <para>
+<screenco>
+  <areaspec>
+    <area xml:id="findgen" coords="2"/>
+  </areaspec>
+<screen>
    <prompt>&promptidl;</prompt> <userinput><command>n = 10</command></userinput>
    <prompt>&promptidl;</prompt> <userinput><command>y = findgen(n)</command></userinput> &numb1;
-   <prompt>&promptidl;</prompt> <userinput><command>plot, y</command></userinput> <ulink url="./figpng/basic_plot.png">&showfig;</ulink>
-	</screen>
+   <prompt>&promptidl;</prompt> <userinput><command>plot, y</command></userinput> <link xl:href="./figpng/basic_plot.png">&showfig;</link>
+</screen>
  	  <calloutlist>
-	    <callout arearefs="findgen">
-	      <para>
-		<command>findgen</command> stands for
+    <callout arearefs="findgen">
+      <para>
+<command>findgen</command> stands for
 <emphasis role="bold">f</emphasis>loat <emphasis role="bold">ind</emphasis>ex <emphasis role="bold">gen</emphasis>erator.
-		<screen format="linespecific">
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>print, findgen(6)</command></userinput>
   <computeroutput>      0.00000      1.00000      2.00000      3.00000      4.00000      5.00000</computeroutput>
-		</screen>
-	      </para>
-	    </callout>
-	  </calloutlist>
-	</screenco>
+</screen>
+      </para>
+    </callout>
+  </calloutlist>
+</screenco>
      </para>
       <para>
-	Using IDL <command>plot</command> command is quite inconvenient to save the figure as a postscript. In addition, positioning the figure on the window/page by using <varname>!p.position</varname>, <varname>!p.region</varname> and <varname>!p.multi</varname> is often a nightmare. That's why we developed <command>splot</command> (like super-plot) which can be used in the same way as plot but is much more convenient to make postscript and position the figure.
-	<screen format="linespecific">
-  <prompt>&promptidl;</prompt> <userinput><command>splot, y</command></userinput> <ulink url="./figpng/basic_splot1.png">&showfig;</ulink>
+Using IDL <command>plot</command> command is quite inconvenient to save the figure as a postscript. In addition, positioning the figure on the window/page by using <varname>!p.position</varname>, <varname>!p.region</varname> and <varname>!p.multi</varname> is often a nightmare. That's why we developed <command>splot</command> (like super-plot) which can be used in the same way as plot but is much more convenient to make postscript and position the figure.
+<screen>
+  <prompt>&promptidl;</prompt> <userinput><command>splot, y</command></userinput> <link xl:href="./figpng/basic_splot1.png">&showfig;</link>
   <computeroutput>% Compiled module: SPLOT.</computeroutput>
   <computeroutput>% Compiled module: REINITPLT.</computeroutput>
@@ -158,11 +169,11 @@
   <computeroutput>% Compiled module: GET_SCREEN_SIZE.</computeroutput>
   <computeroutput>% Compiled module: TERMINEDESSIN.</computeroutput>
-	</screen>
-	Save the figure seen on the screen as a (real, not a screen capture) postscript in only one command.
-	<screenco>
-	  <areaspec>
-	    <area id="make_ps" coords='6'/>
-	  </areaspec>
-	<screen format="linespecific">
+</screen>
+Save the figure seen on the screen as a (real, not a screen capture) postscript in only one command.
+<screenco>
+  <areaspec>
+    <area xml:id="make_ps" coords="6"/>
+  </areaspec>
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>@ps</command></userinput>
   <computeroutput>% Compiled module: GETFILE.</computeroutput>
@@ -178,15 +189,15 @@
   <computeroutput>% Compiled module: CW_BGROUP.</computeroutput>
   <computeroutput>% Compiled module: XMANAGER.</computeroutput>
-	</screen>
-	  <calloutlist>
-	    <callout arearefs="make_ps">
-	      <para>
-		<remark>If needed, the name of the postscript will automatically be completed with .ps. Just hit return, if you want to use the default postscript name: <filename>idl.ps</filename>.</remark>
-	      </para>
-	    </callout>
-	  </calloutlist>
-	</screenco>
-	Check that the <quote><filename>first_ps.ps</filename></quote> file is now existing &hellip;
-	<screen format="linespecific">
+</screen>
+  <calloutlist>
+    <callout arearefs="make_ps">
+      <simpara>
+If needed, the name of the postscript will automatically be completed with .ps. Just hit return, if you want to use the default postscript name: <filename>idl.ps</filename>.
+      </simpara>
+    </callout>
+  </calloutlist>
+</screenco>
+Check that the <quote><filename>first_ps.ps</filename></quote> file is now existing &hellip;
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>print, file_test(psdir + 'first_ps.ps')</command></userinput>
   <computeroutput>           1</computeroutput>
@@ -216,112 +227,108 @@
   <computeroutput>   MTIME           LONG64                1122424373</computeroutput>
   <computeroutput>   SIZE            LONG64                      4913</computeroutput>
-	</screen>
-      </para>
-      <para id="splot_description">
-	<command>splot</command> accepts the same keywords as <command>plot</command> (<computeroutput id="plot_kwd">/ISOTROPIC, MAX_VALUE=value, MIN_VALUE=value, NSUM=value, /POLAR, THICK=value, /XLOG, /YLOG, /YNOZERO</computeroutput>), including the graphics keywords (<computeroutput id="gr_kwd">BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE, FONT, LINESTYLE, NOCLIP, NODATA, NOERASE, NORMAL, POSITION, PSYM, SUBTITLE, SYMSIZE, T3D, THICK, TICKLEN, TITLE, [XYZ]CHARSIZE, [XYZ]GRIDSTYLE, [XYZ]MARGIN, [XYZ]MINOR, [XYZ]RANGE, [XYZ]STYLE, [XYZ]THICK, [XYZ]TICKFORMAT, [XYZ]TICKINTERVAL, [XYZ]TICKLAYOUT, [XYZ]TICKLEN, [XYZ]TICKNAME, [XYZ]TICKS, [XYZ]TICKUNITS, [XYZ]TICKV, [XYZ]TICK_GET, [XYZ]TITLE, ZVALUE</computeroutput>).
+</screen>
+      </para>
+      <para xml:id="splot_description">
+<command>splot</command> accepts the same keywords as <command>plot</command> (<computeroutput xml:id="plot_kwd">/ISOTROPIC, MAX_VALUE=value, MIN_VALUE=value, NSUM=value, /POLAR, THICK=value, /XLOG, /YLOG, /YNOZERO</computeroutput>), including the graphics keywords (<computeroutput xml:id="gr_kwd">BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE, FONT, LINESTYLE, NOCLIP, NODATA, NOERASE, NORMAL, POSITION, PSYM, SUBTITLE, SYMSIZE, T3D, THICK, TICKLEN, TITLE, [XYZ]CHARSIZE, [XYZ]GRIDSTYLE, [XYZ]MARGIN, [XYZ]MINOR, [XYZ]RANGE, [XYZ]STYLE, [XYZ]THICK, [XYZ]TICKFORMAT, [XYZ]TICKINTERVAL, [XYZ]TICKLAYOUT, [XYZ]TICKLEN, [XYZ]TICKNAME, [XYZ]TICKS, [XYZ]TICKUNITS, [XYZ]TICKV, [XYZ]TICK_GET, [XYZ]TITLE, ZVALUE</computeroutput>).
       </para>
       <simpara>
-	It can therefore be customized <emphasis>as much as you want</emphasis>. See this short example:
+It can therefore be customized <emphasis>as much as you want</emphasis>. See this short example:
       </simpara>
       <para>
-	<screen format="linespecific">
-  <prompt>&promptidl;</prompt> <userinput><command>splot, y, y^2, linestyle = 2, thick = 2, title = 'y = x^2', /portrait</command></userinput> <ulink url="./figpng/basic_splot2.png">&showfig;</ulink>
-	</screen>
-	<command>splot</command> can be used to setup the graphic environment (<varname>!p</varname>, <varname>!x</varname>, <varname>!y</varname>, <varname>!z</varname> variables) needed by procedures like <command>oplot</command>
-	<screen format="linespecific">
+<screen>
+  <prompt>&promptidl;</prompt> <userinput><command>splot, y, y^2, linestyle = 2, thick = 2, title = 'y = x^2', /portrait</command></userinput> <link xl:href="./figpng/basic_splot2.png">&showfig;</link>
+</screen>
+<command>splot</command> can be used to setup the graphic environment (<varname>!p</varname>, <varname>!x</varname>, <varname>!y</varname>, <varname>!z</varname> variables) needed by procedures like <command>oplot</command>
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>splot, y, yrange = [0, (n-1)^2], title = 'x and x^2'</command></userinput>
-  <prompt>&promptidl;</prompt> <userinput><command>oplot, y^2, color = 50, linestyle = 2</command></userinput> <ulink url="./figpng/basic_splot4.png">&showfig;</ulink>
-	</screen>
-	Use the keyword small to produce multi plots figures.
-	<screenco>
-	  <areaspec>
-	    <areaset id="small" coords="">
-	      <area id="small.1" coords='1'/>
-	      <area id="small.2" coords='2'/>
-	    </areaset>
-	    <area id="noerase" coords='2'/>
-	  </areaspec>
-	<screen format="linespecific">
+  <prompt>&promptidl;</prompt> <userinput><command>oplot, y^2, color = 50, linestyle = 2</command></userinput> <link xl:href="./figpng/basic_splot4.png">&showfig;</link>
+</screen>
+Use the keyword small to produce multi plots figures.
+<screenco>
+  <areaspec>
+    <areaset xml:id="small">
+      <area xml:id="small.1" coords="1"/>
+      <area xml:id="small.2" coords="2"/>
+    </areaset>
+    <area xml:id="noerase" coords="2"/>
+  </areaspec>
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>splot, y, y^2, title = 'y = x^2', psym = 2, small &numb1; = [1, 2, 1]</command></userinput>
   <prompt>&promptidl;</prompt> <userinput><command>splot, findgen(360)/36., findgen(360)*2.*!dtor, /polar $</command></userinput>
-  <prompt>&promptidl;</prompt> <userinput><command>    , small &numb1; = [1, 2, 2], /noerase &numb2;</command></userinput> <ulink url="./figpng/basic_splot3.png">&showfig;</ulink>
-	</screen>
-	  <calloutlist>
-	    <callout arearefs="small">
-	      <para>
-		the <computeroutput>small</computeroutput> keyword is a 3 elements vector which defines how we divide the page and in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
-	      </para>
-	    </callout>
-	    <callout arearefs="noerase">
-	      <simpara>
-		you must put <computeroutput>/noerase</computeroutput> otherwise the second plot will be done in a new window.
-	      </simpara>
-	    </callout>
-	  </calloutlist>
-	</screenco>
+  <prompt>&promptidl;</prompt> <userinput><command>    , small &numb1; = [1, 2, 2], /noerase &numb2;</command></userinput> <link xl:href="./figpng/basic_splot3.png">&showfig;</link>
+</screen>
+  <calloutlist>
+    <callout arearefs="small">
+      <simpara>
+the <computeroutput>small</computeroutput> keyword is a 3 elements vector which defines how we divide the page and in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
+      </simpara>
+    </callout>
+    <callout arearefs="noerase">
+      <simpara>
+you must put <computeroutput>/noerase</computeroutput> otherwise the second plot will be done in a new window.
+      </simpara>
+    </callout>
+  </calloutlist>
+</screenco>
       </para>
       </sect3>
 
-      <sect3 id="basic_contour">
-      <title>
-	scontour
-      </title>
-      <para>
-	Following <command><link linkend="basic_splot">splot</link></command> example, we provide <command>scontour</command> as a "super <command>contour</command>".
-	<screen format="linespecific">
+      <sect3 xml:id="basic_contour">
+      <title> scontour </title>
+      <para>
+Following <command><link linkend="basic_splot">splot</link></command> example, we provide <command>scontour</command> as a "super <command>contour</command>".
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>z = dist(n)</command></userinput>
   <computeroutput>% Compiled module: DIST.</computeroutput>
-  <prompt>&promptidl;</prompt> <userinput><command>scontour, z</command></userinput> <ulink url="./figpng/basic_scontour1.png">&showfig;</ulink>
+  <prompt>&promptidl;</prompt> <userinput><command>scontour, z</command></userinput> <link xl:href="./figpng/basic_scontour1.png">&showfig;</link>
   <computeroutput>% Compiled module: SCONTOUR.</computeroutput>
   <computeroutput>% Compiled module: CHKSTRU.</computeroutput>
-	</screen>
-	<command>scontour</command> accepts the same keywords as <command>contour</command> (<computeroutput>C_ANNOTATION=vector_of_strings, C_CHARSIZE=value, C_CHARTHICK=integer, C_COLORS=vector, C_LABELS=vector{each element 0 or 1}, C_LINESTYLE=vector, { /FILL | /CELL_FILL | C_ORIENTATION=degrees}, C_SPACING=value, C_THICK=vector, /CLOSED, /DOWNHILL, /FOLLOW, /IRREGULAR, /ISOTROPIC, LEVELS=vector, NLEVELS=integer{1 to 60}, MAX_VALUE=value, MIN_VALUE=value, /OVERPLOT, {/PATH_DATA_COORDS, PATH_FILENAME=string, PATH_INFO=variable, PATH_XY=variable}, TRIANGULATION=variable, /PATH_DOUBLE, /XLOG, /YLOG, ZAXIS={0 | 1 | 2 | 3 | 4}</computeroutput>), including the <link linkend="gr_kwd">graphics keywords</link> (except <computeroutput>LINESTYLE, PSYM, SYMSIZE</computeroutput>).
+</screen>
+<command>scontour</command> accepts the same keywords as <command>contour</command> (<computeroutput>C_ANNOTATION=vector_of_strings, C_CHARSIZE=value, C_CHARTHICK=integer, C_COLORS=vector, C_LABELS=vector{each element 0 or 1}, C_LINESTYLE=vector, { /FILL | /CELL_FILL | C_ORIENTATION=degrees}, C_SPACING=value, C_THICK=vector, /CLOSED, /DOWNHILL, /FOLLOW, /IRREGULAR, /ISOTROPIC, LEVELS=vector, NLEVELS=integer{1 to 60}, MAX_VALUE=value, MIN_VALUE=value, /OVERPLOT, {/PATH_DATA_COORDS, PATH_FILENAME=string, PATH_INFO=variable, PATH_XY=variable}, TRIANGULATION=variable, /PATH_DOUBLE, /XLOG, /YLOG, ZAXIS={0 | 1 | 2 | 3 | 4}</computeroutput>), including the <link linkend="gr_kwd">graphics keywords</link> (except <computeroutput>LINESTYLE, PSYM, SYMSIZE</computeroutput>).
       </para>
       <simpara>It can therefore be customized <emphasis>as much as you want</emphasis>. See these short examples:</simpara>
       <para>
-	<screen format="linespecific">
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>scontour, z, /fill, nlevels = 15, subtitle = 'nicer contour' $</command></userinput>
-  <prompt>&promptidl;</prompt> <userinput><command>    , xtitle = 'x index', charsize = 1.5</command></userinput> <ulink url="./figpng/basic_scontour2.png">&showfig;</ulink>
-	</screen>
+  <prompt>&promptidl;</prompt> <userinput><command>    , xtitle = 'x index', charsize = 1.5</command></userinput> <link xl:href="./figpng/basic_scontour2.png">&showfig;</link>
+</screen>
 It can be used in combination with contour to make more complex plots:
-	<screenco>
-	  <areaspec>
-	    <area id="rebin" coords='1'/>
-	  </areaspec>
-	<screen format="linespecific">
+<screenco>
+  <areaspec>
+    <area xml:id="rebin" coords="1"/>
+  </areaspec>
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>ind = findgen(2*n)/(2.*n)</command></userinput>
   <prompt>&promptidl;</prompt> <userinput><command>scontour, z, levels = n*ind, c_orientation = 180*ind, c_spacing = 0.4*ind</command></userinput>
   <prompt>&promptidl;</prompt> <userinput><command>contour, z, /overplot, c_label = rebin([1, 0], 2, n) &numb1;, levels = n*ind $</command></userinput>
-  <prompt>&promptidl;</prompt> <userinput><command>    , c_charthick = 2, c_charsize = 1.5, c_colors = 250*ind</command></userinput> <ulink url="./figpng/basic_scontour3.png">&showfig;</ulink>
-	</screen>
-	<calloutlist>
-	  <callout arearefs="rebin">
-	    <para>
-	      <command>rebin</command> is used to build an array containing an alternation of 1 and 0 in order to label one contour every two contours.
-		<screen format="linespecific">
+  <prompt>&promptidl;</prompt> <userinput><command>    , c_charthick = 2, c_charsize = 1.5, c_colors = 250*ind</command></userinput> <link xl:href="./figpng/basic_scontour3.png">&showfig;</link>
+</screen>
+<calloutlist>
+  <callout arearefs="rebin">
+    <para>
+      <command>rebin</command> is used to build an array containing an alternation of 1 and 0 in order to label one contour every two contours.
+<screen>
   <prompt>&promptidl;</prompt> <userinput><command>print, rebin([1, 0], 2, 3)</command></userinput>
   <computeroutput>       1       0</computeroutput>
   <computeroutput>       1       0</computeroutput>
   <computeroutput>       1       0</computeroutput>
-		</screen>
-	    </para>
-	  </callout>
-	</calloutlist>
-	</screenco>
-	<command>scontour</command> is compatible with the positioning method associated with the <computeroutput>small</computeroutput> keyword. See for example the test file <ulink type="text" url="../../Tests/tst_basic.pro"><filename>tst_basic.pro</filename></ulink>:
-	<screen format="linespecific">
-  <prompt>&promptidl;</prompt> <userinput><command>tst_basic</command></userinput> <ulink url="./figpng/tst_basic.png">&showfig;</ulink>
-	</screen>
+</screen>
+    </para>
+  </callout>
+</calloutlist>
+</screenco>
+<command>scontour</command> is compatible with the positioning method associated with the <computeroutput>small</computeroutput> keyword. See for example the test file <link xl:href="../../Tests/tst_basic.pro"><filename>tst_basic.pro</filename></link>:
+<screen>
+  <prompt>&promptidl;</prompt> <userinput><command>tst_basic</command></userinput> <link xl:href="./figpng/tst_basic.png">&showfig;</link>
+</screen>
       </para>
       </sect3>
 
-      <sect3 id="tvplus">
-	<title>
-	  Quick look and explore 2D arrays: tvplus
-	</title>
-	<para>
-	  <command>tvplus</command> is a enhanced version of <command>tvscl</command> and allow you to have a quick look and perform basic exploration of 2D arrays.
-	  <screen format="linespecific">
-  <prompt>&promptidl;</prompt> <userinput><command>tvplus, dist(20)</command></userinput> <ulink url="./figpng/tvplus.png">&showfig;</ulink>
+      <sect3 xml:id="tvplus">
+<title> Quick look and explore 2D arrays: tvplus </title>
+<para>
+  <command>tvplus</command> is a enhanced version of <command>tvscl</command> and allow you to have a quick look and perform basic exploration of 2D arrays.
+  <screen>
+  <prompt>&promptidl;</prompt> <userinput><command>tvplus, dist(20)</command></userinput> <link xl:href="./figpng/tvplus.png">&showfig;</link>
   <computeroutput>left button  : mouse position and associated array value</computeroutput>
   <computeroutput>middle button: use it twice to define a zoom box</computeroutput>
@@ -329,58 +336,50 @@
   <computeroutput>(x, y) = (  5,   5), value = 7.07107</computeroutput>
   <computeroutput>(x, y) = ( 12,   8), value = 11.3137</computeroutput>
-	  </screen>
-	  For more informations on <command>tvplus</command>, try:
-	  <screen format="linespecific">
+  </screen>
+  For more informations on <command>tvplus</command>, try:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>xhelp, 'tvplus'</command></userinput>
-	  </screen>
-	  To see the source code of <command>tvplus</command>, try:
-	  <screen format="linespecific">
+  </screen>
+  To see the source code of <command>tvplus</command>, try:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>xfile, 'tvplus'</command></userinput>
-	  </screen>
-	  <note><title>New Feature</title><para>
-	  If you use an IDL 6.2 or later revision, you can simply get the help of any command by typing ?<replaceable>command_name</replaceable>, for example:
-	  <screen format="linespecific">
+  </screen>
+  <note><title>New Feature</title><para>
+  If you use an IDL 6.2 or later revision, you can simply get the help of any command by typing ?<replaceable>command_name</replaceable>, for example:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>?tvplus</command></userinput>
-	  </screen>
-	  </para></note>
-	</para>
+  </screen>
+  </para></note>
+</para>
       </sect3>
 
-      <sect3 id="pltv">
-	<title>
-	  Formal quick look at 2D arrays: pltv
-	</title>
-	<para>
-	  <command>pltv</command> is a mix between <link linkend="tvplus">tvplus</link> and <link linkend="plt">plt</link> and allow you to have formal quick look of 2D arrays.
-	  <screen format="linespecific">
-  <prompt>&promptidl;</prompt> <userinput><command>pltv, dist(20)</command></userinput> <ulink url="./figpng/pltv.png">&showfig;</ulink>
-	  </screen>
-	</para>
+      <sect3 xml:id="pltv">
+<title> Formal quick look at 2D arrays: pltv </title>
+<para>
+  <command>pltv</command> is a mix between <link linkend="tvplus">tvplus</link> and <link linkend="plt">plt</link> and allow you to have formal quick look of 2D arrays.
+  <screen>
+  <prompt>&promptidl;</prompt> <userinput><command>pltv, dist(20)</command></userinput> <link xl:href="./figpng/pltv.png">&showfig;</link>
+  </screen>
+</para>
       </sect3>
     </sect2>
   </sect1>
 
-  <sect1 id="gridded_data">
-    <title>
-      Explore gridded data (model outputs and observations)
-    </title>
+  <sect1 xml:id="gridded_data">
+    <title> Explore gridded data (model outputs and observations) </title>
     <para>
       This section briefly describes the main functionalities offered by SAXO to explore gridded data on regular or irregular grid.
     </para>
 
-    <sect2 id="load_grid">
-      <title>
-	Load the data grid
-      </title>
-      <para>
-	As we focus in this section on the gridded data, we must first load the grid informations before reading and plotting the data. Loading the grid independently of the data allow you to reload the grid only when it is strictly necessary and not every time you access the data. In <filename class="directory"><envar>${HOME}</envar>/SAXO_DIR/Tests/</filename>, we provide several examples to load a grid.
-      </para>
-      <sect3 id="load_fromdata">
-	<title>
-	  Easiest solution: load data grid (regular or not) directly from the data file
-	</title>
-	<para>
-	  Example of Levitus temperature on a regular 1x1 grid.
-	  <screen format="linespecific">
+    <sect2 xml:id="load_grid">
+      <title> Load the data grid </title>
+      <para>
+As we focus in this section on the gridded data, we must first load the grid informations before reading and plotting the data. Loading the grid independently of the data allow you to reload the grid only when it is strictly necessary and not every time you access the data. In <filename class="directory">${HOME}/SAXO_DIR/Tests/</filename>, we provide several examples to load a grid.
+      </para>
+      <sect3 xml:id="load_fromdata">
+<title> Easiest solution: load data grid (regular or not) directly from the data file </title>
+<para>
+  Example of Levitus temperature on a regular 1x1 grid.
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>@tst_initlev</command></userinput>
   <computeroutput>% Compiled module: INITNCDF.</computeroutput>
@@ -397,22 +396,22 @@
   <computeroutput>% Compiled module: DIFFERENT.</computeroutput>
   <computeroutput>% Compiled module: DEFINETRI.</computeroutput>
-	  </screen>
-	  This <ulink type="text" url="../../Tests/tst_initlev.pro"><command>@tst_initlev</command></ulink> command allows us to define:
-	  <itemizedlist>
-	    <listitem><simpara>domain dimensions, stored in <varname>jpi, jpj and jpk</varname></simpara></listitem>
-	    <listitem><simpara>points abscissa, stored in 2D array <varname></varname>glamt</simpara></listitem>
-	    <listitem><simpara>points ordinates, stored in 2D array <varname></varname>gphit</simpara></listitem>
-	    <listitem><simpara>points depths, stored in 1D array <varname></varname>gdept</simpara></listitem>
-	    <listitem><simpara>cells corners abscissa, stored in 2D array <varname></varname>glamf</simpara></listitem>
-	    <listitem><simpara>cells corners ordinates, stored in 2D array <varname></varname>gphif</simpara></listitem>
-	    <listitem><simpara>cells upper boundary depth, stored in 1D array <varname></varname>gdepw</simpara></listitem>
-	    <listitem><simpara>land-sea mask, stored in <varname>tmask</varname></simpara></listitem>
-	    <listitem><simpara>the cells size in the longitudinal direction, stored in 2D array <varname></varname>e1t</simpara></listitem>
-	    <listitem><simpara>the cells size in the latitudinal direction, stored in 2D array <varname></varname>e2t</simpara></listitem>
-	    <listitem><simpara>the cells size in the vertical direction, stored in 1D array <varname></varname>e3t</simpara></listitem>
-	    <listitem><simpara>the triangulation used to fill the land points, stored in <varname></varname>triangles_list</simpara></listitem>
-	  </itemizedlist>
-
-	  <screen format="linespecific">
+  </screen>
+  This <link xl:href="../../Tests/tst_initlev.pro"><command>@tst_initlev</command></link> command allows us to define:
+  <itemizedlist>
+    <listitem><simpara>domain dimensions, stored in <varname>jpi, jpj and jpk</varname></simpara></listitem>
+    <listitem><simpara>points abscissa, stored in 2D array <varname></varname>glamt</simpara></listitem>
+    <listitem><simpara>points ordinates, stored in 2D array <varname></varname>gphit</simpara></listitem>
+    <listitem><simpara>points depths, stored in 1D array <varname></varname>gdept</simpara></listitem>
+    <listitem><simpara>cells corners abscissa, stored in 2D array <varname></varname>glamf</simpara></listitem>
+    <listitem><simpara>cells corners ordinates, stored in 2D array <varname></varname>gphif</simpara></listitem>
+    <listitem><simpara>cells upper boundary depth, stored in 1D array <varname></varname>gdepw</simpara></listitem>
+    <listitem><simpara>land-sea mask, stored in <varname>tmask</varname></simpara></listitem>
+    <listitem><simpara>the cells size in the longitudinal direction, stored in 2D array <varname></varname>e1t</simpara></listitem>
+    <listitem><simpara>the cells size in the latitudinal direction, stored in 2D array <varname></varname>e2t</simpara></listitem>
+    <listitem><simpara>the cells size in the vertical direction, stored in 1D array <varname></varname>e3t</simpara></listitem>
+    <listitem><simpara>the triangulation used to fill the land points, stored in <varname></varname>triangles_list</simpara></listitem>
+  </itemizedlist>
+
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>help, jpi,jpj,jpk</command></userinput>
   <computeroutput>JPI (LOCAL_COORD)   LONG      =          360</computeroutput>
@@ -437,120 +436,110 @@
   <prompt>&promptidl;</prompt> <userinput><command>tvplus, glamt*tmask[*,*,0]</command></userinput>
   <prompt>&promptidl;</prompt> <userinput><command>tvplus, gphit*tmask[*,*,0]</command></userinput>
-	  </screen>
-	  We provide other initialization methods/examples
-	  <itemizedlist>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_short.pro">@tst_initorca2_short</ulink> : ORCA2 example</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_short.pro">@tst_initorca05_short</ulink> : ORCA05 example</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initlev_stride.pro">@tst_initlev_stride</ulink> : same as @tst_initlev but we skip on point over 2 in x and y direction</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_short_stride.pro">@tst_initorca2_short_stride</ulink> : ORCA2 with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_short_stride.pro">@tst_initorca05_short_stride</ulink> : ORCA05 with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initlev_index.pro">@tst_initlev_index</ulink> : in that case we load the grid using points index as axis instead of the longitude/latitude position</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</ulink> : load ORCA2 as it see by the model</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</ulink> : load ORCA05 as it see by the model</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initlev_index_stride.pro">@tst_initlev_index_stride</ulink> : @tst_initlev_index with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</ulink> : ORCA2 in index with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</ulink> : ORCA05 in index with stride</simpara></listitem>
-	  </itemizedlist>
-	</para>
+  </screen>
+  We provide other initialization methods/examples
+  <itemizedlist>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_short.pro">@tst_initorca2_short</link> : ORCA2 example</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_short.pro">@tst_initorca05_short</link> : ORCA05 example</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initlev_stride.pro">@tst_initlev_stride</link> : same as @tst_initlev but we skip on point over 2 in x and y direction</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_short_stride.pro">@tst_initorca2_short_stride</link> : ORCA2 with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_short_stride.pro">@tst_initorca05_short_stride</link> : ORCA05 with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initlev_index.pro">@tst_initlev_index</link> : in that case we load the grid using points index as axis instead of the longitude/latitude position</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</link> : load ORCA2 as it see by the model</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</link> : load ORCA05 as it see by the model</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initlev_index_stride.pro">@tst_initlev_index_stride</link> : @tst_initlev_index with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</link> : ORCA2 in index with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</link> : ORCA05 in index with stride</simpara></listitem>
+  </itemizedlist>
+</para>
       </sect3>
-      <sect3 id="load_meshmask">
-	<title>
-	  Load the grid from OPA <filename>meshmask</filename> file
-	</title>
-	<para>
-	  When the grid is really irregular (its abscissa and ordinate cannot be descried by a vector), loading the grid directly from the data forces us to make an approximation when computing the grid corners position and the cells size. In that case, it can be preferable to load the grid from the meshmask file created by OPA. As OPA use a Arakawa-C discretization, loading the grid from the meshmask will also define all parameters related to the U, V and F grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a simple <link linkend="load_fromdata">grid definition from the data itself</link> (with <filename>initncdf</filename> or <filename>computegrid</filename>), adding the keyword /FULLCGRID leads also to the definition of all U, V and F grids parameters. There is the examples to load ORCA grids from OPA meshmask.
-	  <itemizedlist>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2.pro">@tst_initorca2</ulink> : ORCA2</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05.pro">@tst_initorca05</ulink> : ORCA05</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_stride.pro">@tst_initorca2_stride</ulink> : ORCA2 with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_stride.pro">@tst_initorca05_stride</ulink> : ORCA05 with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</ulink> : load ORCA2 as it see by the model</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</ulink> : load ORCA05 as it see by the model</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</ulink> : ORCA2 in index with stride</simpara></listitem>
-	    <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</ulink> : ORCA05 in index with stride</simpara></listitem>
-	  </itemizedlist>
-	</para>
+      <sect3 xml:id="load_meshmask">
+<title> Load the grid from OPA <filename>meshmask</filename> file </title>
+<para>
+  When the grid is really irregular (its abscissa and ordinate cannot be descried by a vector), loading the grid directly from the data forces us to make an approximation when computing the grid corners position and the cells size. In that case, it can be preferable to load the grid from the meshmask file created by OPA. As OPA use a Arakawa-C discretization, loading the grid from the meshmask will also define all parameters related to the U, V and F grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a simple <link linkend="load_fromdata">grid definition from the data itself</link> (with <filename>initncdf</filename> or <filename>computegrid</filename>), adding the keyword /FULLCGRID leads also to the definition of all U, V and F grids parameters. There is the examples to load ORCA grids from OPA meshmask.
+  <itemizedlist>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2.pro">@tst_initorca2</link> : ORCA2</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05.pro">@tst_initorca05</link> : ORCA05</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_stride.pro">@tst_initorca2_stride</link> : ORCA2 with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_stride.pro">@tst_initorca05_stride</link> : ORCA05 with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</link> : load ORCA2 as it see by the model</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</link> : load ORCA05 as it see by the model</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</link> : ORCA2 in index with stride</simpara></listitem>
+    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</link> : ORCA05 in index with stride</simpara></listitem>
+  </itemizedlist>
+</para>
         </sect3>
     </sect2>
 
-    <sect2 id="plt">
-      <title>
-	Horizontal plots and maps
-      </title>
-	<para>
-	  A quick presentation of horizontal plots and maps is shown in <ulink type="text" url="../../Tests/tst_plt.pro">tst_plt</ulink>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
-	  <screen format="linespecific">
+    <sect2 xml:id="plt">
+      <title> Horizontal plots and maps </title>
+<para>
+  A quick presentation of horizontal plots and maps is shown in <link xl:href="../../Tests/tst_plt.pro">tst_plt</link>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>tst_plt</command></userinput>
-	  </screen>
-	</para>
-	<simpara><emphasis>Beware, the command is <command>tst_plt</command> and not <command>@tst_plt</command> as <filename>tst_plt.pro</filename> is a procedure and not an include.</emphasis></simpara>
-	<para>
-	  See the results with
-	  <itemizedlist>
-	  <listitem><simpara><command>@tst_initlev</command>&figsplt_lev;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2</command>&figsplt_orca2;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05</command>&figsplt_orca05;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initlev_stride</command>&figsplt_lev_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2_stride</command>&figsplt_orca2_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05_stride</command>&figsplt_orca05_stride;</simpara></listitem>
-	  </itemizedlist>
-	</para>
+  </screen>
+</para>
+<simpara><emphasis>Beware, the command is <command>tst_plt</command> and not <command>@tst_plt</command> as <filename>tst_plt.pro</filename> is a procedure and not an include.</emphasis></simpara>
+<para>
+  See the results with
+  <itemizedlist>
+  <listitem><simpara><command>@tst_initlev</command>&figsplt_lev;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2</command>&figsplt_orca2;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05</command>&figsplt_orca05;</simpara></listitem>
+  <listitem><simpara><command>@tst_initlev_stride</command>&figsplt_lev_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2_stride</command>&figsplt_orca2_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05_stride</command>&figsplt_orca05_stride;</simpara></listitem>
+  </itemizedlist>
+</para>
     </sect2>
 
-    <sect2 id="pltz">
-      <title>
-	Vertical sections
-      </title>
-	<para>
-	  A quick presentation of vertical sections is shown in <ulink type="text" url="../../Tests/tst_pltz.pro">tst_pltz</ulink>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
-	  <screen format="linespecific">
+    <sect2 xml:id="pltz">
+      <title> Vertical sections </title>
+<para>
+  A quick presentation of vertical sections is shown in <link xl:href="../../Tests/tst_pltz.pro">tst_pltz</link>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>tst_pltz</command></userinput>
-	  </screen>
-	</para>
-	  <simpara><emphasis>Beware, the command is <command>tst_pltz</command> and not <command>@tst_pltz</command> as <filename>tst_pltz.pro</filename> is a procedure and not an include.</emphasis></simpara>
-	<para>
-	  See the results with
-	  <itemizedlist>
-	  <listitem><simpara><command>@tst_initlev</command>&figspltz_lev;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2</command>&figspltz_orca2;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05</command>&figspltz_orca05;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initlev_stride</command>&figspltz_lev_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltz_orca2_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltz_orca05_stride;</simpara></listitem>
-	  </itemizedlist>
-	</para>
+  </screen>
+</para>
+  <simpara><emphasis>Beware, the command is <command>tst_pltz</command> and not <command>@tst_pltz</command> as <filename>tst_pltz.pro</filename> is a procedure and not an include.</emphasis></simpara>
+<para>
+  See the results with
+  <itemizedlist>
+  <listitem><simpara><command>@tst_initlev</command>&figspltz_lev;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2</command>&figspltz_orca2;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05</command>&figspltz_orca05;</simpara></listitem>
+  <listitem><simpara><command>@tst_initlev_stride</command>&figspltz_lev_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltz_orca2_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltz_orca05_stride;</simpara></listitem>
+  </itemizedlist>
+</para>
     </sect2>
 
-    <sect2 id="pltt">
-      <title>
-	Hovmoellers and time series
-      </title>
-	<para>
-	  A quick presentation of hovmoellers and time series is shown in <ulink type="text" url="../../Tests/tst_pltt.pro">tst_pltt</ulink>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
-	  <screen format="linespecific">
+    <sect2 xml:id="pltt">
+      <title> Hovmoellers and time series </title>
+<para>
+  A quick presentation of hovmoellers and time series is shown in <link xl:href="../../Tests/tst_pltt.pro">tst_pltt</link>. After loading any of the grid (for example with one of the <link linkend="load_grid">above examples</link>). Just try:
+  <screen>
   <prompt>&promptidl;</prompt> <userinput><command>tst_pltt</command></userinput>
-	  </screen>
-	</para>
-	  <simpara><emphasis>Beware, the command is <command>tst_pltt</command> and not <command>@tst_pltt</command> as <filename>tst_pltt.pro</filename> is a procedure and not an include.</emphasis></simpara>
-	<para>
-	  See the results with
-	  <itemizedlist>
-	  <listitem><simpara><command>@tst_initlev</command>&figspltt_lev;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2</command>&figspltt_orca2;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05</command>&figspltt_orca05;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initlev_stride</command>&figspltt_lev_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltt_orca2_stride;</simpara></listitem>
-	  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltt_orca05_stride;</simpara></listitem>
-	  </itemizedlist>
-	</para>
+  </screen>
+</para>
+  <simpara><emphasis>Beware, the command is <command>tst_pltt</command> and not <command>@tst_pltt</command> as <filename>tst_pltt.pro</filename> is a procedure and not an include.</emphasis></simpara>
+<para>
+  See the results with
+  <itemizedlist>
+  <listitem><simpara><command>@tst_initlev</command>&figspltt_lev;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2</command>&figspltt_orca2;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05</command>&figspltt_orca05;</simpara></listitem>
+  <listitem><simpara><command>@tst_initlev_stride</command>&figspltt_lev_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltt_orca2_stride;</simpara></listitem>
+  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltt_orca05_stride;</simpara></listitem>
+  </itemizedlist>
+</para>
     </sect2>
 
-    <sect2 id="plt1d">
-      <title>
-	1D plots
-      </title>
+    <sect2 xml:id="plt1d">
+      <title> 1D plots </title>
  	<para>
-	  To be continued &hellip;
-	</para>
+  To be continued &hellip;
+</para>
    </sect2>
 
Index: trunk/SRC/Documentation/xmldoc/firststeps_pre.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/firststeps_pre.sh	(revision 345)
+++ trunk/SRC/Documentation/xmldoc/firststeps_pre.sh	(revision 345)
@@ -0,0 +1,139 @@
+#! /bin/sh
+#
+# module :
+# ++ working on firststeps.xml before processing for HTML and wiki
+#
+# update :
+# $Id$
+# fplod 2008-04-15T10:53:26Z aedon.locean-ipsl.upmc.fr (Darwin)
+# creation from makehtml.sh
+# adapation to docbook 5.0
+#
+set -u
+set -o posix
+#
+# figures lists
+cd ./figpng
+#
+figsplt_lev=""
+for i in tst_plt_lev_[0-9][0-9].png
+do
+  figsplt_lev="${figsplt_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_lev=""
+for i in tst_pltz_lev_[0-9][0-9].png
+do
+  figspltz_lev="${figspltz_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_lev=""
+for i in tst_pltt_lev_[0-9][0-9].png
+do
+  figspltt_lev="${figspltt_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+#
+figsplt_orca2=""
+for i in tst_plt_orca2_[0-9][0-9].png
+do
+  figsplt_orca2="${figsplt_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_orca2=""
+for i in tst_pltz_orca2_[0-9][0-9].png
+do
+  figspltz_orca2="${figspltz_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_orca2=""
+for i in tst_pltt_orca2_[0-9][0-9].png
+do
+  figspltt_orca2="${figspltt_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+#
+figsplt_orca05=""
+for i in tst_plt_orca05_[0-9][0-9].png
+do
+  figsplt_orca05="${figsplt_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_orca05=""
+for i in tst_pltz_orca05_[0-9][0-9].png
+do
+  figspltz_orca05="${figspltz_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_orca05=""
+for i in tst_pltt_orca05_[0-9][0-9].png
+do
+  figspltt_orca05="${figspltt_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+##
+#
+figsplt_lev_stride=""
+for i in tst_plt_lev_stride_[0-9][0-9].png
+do
+  figsplt_lev_stride="${figsplt_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_lev_stride=""
+for i in tst_pltz_lev_stride_[0-9][0-9].png
+do
+  figspltz_lev_stride="${figspltz_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_lev_stride=""
+for i in tst_pltt_lev_stride_[0-9][0-9].png
+do
+  figspltt_lev_stride="${figspltt_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+#
+figsplt_orca2_stride=""
+for i in tst_plt_orca2_stride_[0-9][0-9].png
+do
+  figsplt_orca2_stride="${figsplt_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_orca2_stride=""
+for i in tst_pltz_orca2_stride_[0-9][0-9].png
+do
+  figspltz_orca2_stride="${figspltz_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_orca2_stride=""
+for i in tst_pltt_orca2_stride_[0-9][0-9].png
+do
+  figspltt_orca2_stride="${figspltt_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+#
+figsplt_orca05_stride=""
+for i in tst_plt_orca05_stride_[0-9][0-9].png
+do
+  figsplt_orca05_stride="${figsplt_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltz_orca05_stride=""
+for i in tst_pltz_orca05_stride_[0-9][0-9].png
+do
+  figspltz_orca05_stride="${figspltz_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+figspltt_orca05_stride=""
+for i in tst_pltt_orca05_stride_[0-9][0-9].png
+do
+  figspltt_orca05_stride="${figspltt_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>"
+done
+##
+cd .. # ie <working space of saxo>/SRC/Documentation/xmldoc
+#
+rm firststeps_sed.xml 2> /dev/null
+sed -e s/"\&figsplt_lev\;"/"${figsplt_lev}"/g \
+-e s/"\&figsplt_orca2\;"/"${figsplt_orca2}"/g \
+-e s/"\&figsplt_orca05\;"/"${figsplt_orca05}"/g \
+-e s/"\&figspltz_lev\;"/"${figspltz_lev}"/g \
+-e s/"\&figspltz_orca2\;"/"${figspltz_orca2}"/g \
+-e s/"\&figspltz_orca05\;"/"${figspltz_orca05}"/g \
+-e s/"\&figspltt_lev\;"/"${figspltt_lev}"/g \
+-e s/"\&figspltt_orca2\;"/"${figspltt_orca2}"/g \
+-e s/"\&figspltt_orca05\;"/"${figspltt_orca05}"/g \
+-e s/"\&figsplt_lev_stride\;"/"${figsplt_lev_stride}"/g \
+-e s/"\&figsplt_orca2_stride\;"/"${figsplt_orca2_stride}"/g \
+-e s/"\&figsplt_orca05_stride\;"/"${figsplt_orca05_stride}"/g \
+-e s/"\&figspltz_lev_stride\;"/"${figspltz_lev_stride}"/g \
+-e s/"\&figspltz_orca2_stride\;"/"${figspltz_orca2_stride}"/g \
+-e s/"\&figspltz_orca05_stride\;"/"${figspltz_orca05_stride}"/g \
+-e s/"\&figspltt_lev_stride\;"/"${figspltt_lev_stride}"/g \
+-e s/"\&figspltt_orca2_stride\;"/"${figspltt_orca2_stride}"/g \
+-e s/"\&figspltt_orca05_stride\;"/"${figspltt_orca05_stride}"/g \
+firststeps.xml > firststeps_sed.xml
+#
+# exit
+exit 0
Index: trunk/SRC/Documentation/xmldoc/getsaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/getsaxo.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/getsaxo.xml	(revision 345)
@@ -1,20 +1,31 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
-<!ENTITY hellip	"&#x2026;">
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE article [
+<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
+%isolat1;
+<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
+%isolat2;
+<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
+%isogrk3;
+<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
+%isopub;
+<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
+%isotech;
+<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
+%isonum;
 <!ENTITY promptidl "idl&gt;">
 ]>
-<!--
--->
-<article lang="en">
-  <title>
-    Get <application>SAXO</application>
-  </title>
-  
-  <articleinfo>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="getsaxo">
+
+  <title>Get <application>SAXO</application></title>
+
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -28,24 +39,27 @@
 	<revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+    </revhistory>
    <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
   <!--	1st part -->
 
-  <sect1 id="create_saxo_env">
-    <title>
-      Create <application>SAXO</application> environment
-    </title>
+  <sect1 xml:id="create_saxo_env">
+    <title> Create <application>SAXO</application> environment </title>
     <para>
-      To simplify the explanation, we suppose that we install <application>SAXO</application> in your <filename class='directory'><envar>${HOME}</envar></filename>. 
+      To simplify the explanation, we suppose that we install <application>SAXO</application> in your <filename class='directory'>${HOME}</filename>.
       We need to create 2 directories:
       <itemizedlist>
 	<listitem>
-         <simpara><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> that will contain the source files of <application>SAXO</application>. It should not be modified by the user to simplify later updates
+         <simpara><filename class='directory'>${HOME}/SAXO_DIR</filename> that will contain the source files of <application>SAXO</application>. It should not be modified by the user to simplify later updates
          </simpara>
         </listitem>
 	<listitem>
-         <simpara><filename class='directory'><envar>${HOME}</envar>/My_IDL</filename> that will contain user personal files (including modified <application>SAXO</application> files, if needed).
+         <simpara><filename class='directory'>${HOME}/My_IDL</filename> that will contain user personal files (including modified <application>SAXO</application> files, if needed).
          </simpara>
        </listitem>
@@ -53,6 +67,6 @@
     </para>
     <para>
-      <screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+      <screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput>
   <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>My_IDL</parameter></userinput>
       </screen>
@@ -62,15 +76,11 @@
   <!--	2nd part -->
 
- <sect1 id="get_saxo_files">
-    <title>
-      Get <application>SAXO</application> files
-    </title>
+ <sect1 xml:id="get_saxo_files">
+    <title> Get <application>SAXO</application> files </title>
 
   <!--	2.1 -->
 
-    <sect2 id="saxo_local">
-      <title>
-	If you work at IDRIS, IPSL or LOCEAN
-      </title>
+    <sect2 xml:id="saxo_local">
+      <title> If you work at IDRIS, IPSL or LOCEAN </title>
       <para>
 	<application>SAXO</application> is already installed at
@@ -89,9 +99,9 @@
          </listitem>
 	</itemizedlist>
-	If you can access one of theses directories, there is no need to re-install <application>SAXO</application> again! In that case, you only have to link <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> to the appropriate directory:
+	If you can access one of theses directories, there is no need to re-install <application>SAXO</application> again! In that case, you only have to link <filename class='directory'>${HOME}/SAXO_DIR</filename> to the appropriate directory:
 	<variablelist>
 	  <varlistentry><term><emphasis role="bold">IDRIS</emphasis></term>
 	  <listitem><screen>
-  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/rech/eee/reee217/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/rech/eee/reee217/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput>
 	  </screen>
          </listitem>
@@ -99,5 +109,5 @@
 	  <varlistentry><term><emphasis role="bold">IPSL</emphasis></term>
 	  <listitem><screen>
-  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/smlod/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/smlod/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput>
 	  </screen>
            </listitem>
@@ -105,5 +115,5 @@
 	  <varlistentry><term><emphasis role="bold">LOCEAN</emphasis></term>
 	  <listitem><screen>
-  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/usr/home/smasson/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/usr/home/smasson/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput>
 	  </screen>
            </listitem>
@@ -115,16 +125,12 @@
   <!--	2.2 -->
 
-    <sect2 id="saxo_svn">
-      <title>
-	If <ulink url="http://subversion.tigris.org/"><application> Subversion (svn)</application></ulink> is installed on your machine
-      </title>
+    <sect2 xml:id="saxo_svn">
+      <title> If <link xl:href="http://subversion.tigris.org/"><application> Subversion (svn)</application></link> is installed on your machine </title>
  <!--	2.2.1 -->
-      <sect3 id="saxo_svn_users">
-	<title>
-	  Regular users
-	</title>
+      <sect3 xml:id="saxo_svn_users">
+	<title> Regular users </title>
       <para>
 	The <emphasis role="bold">complete</emphasis> latest revision (source + tests data files: &szallsvn; Mb) can be checked out with the following command executed in your <envar>${HOME}</envar>:
-	<screen format="linespecific">
+	<screen>
   <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/</parameter> <parameter>SAXO_DIR</parameter></userinput>
 	</screen>
@@ -132,5 +138,5 @@
       <para>
 	The latest revision of the <emphasis role="bold">source files</emphasis> (&szsrcsvn; Mb) can be checked out with the following command:
-	<screen format="linespecific">
+	<screen>
   <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/SRC</parameter> <parameter>SAXO_DIR/SRC</parameter></userinput>
 	</screen>
@@ -138,5 +144,5 @@
       <para>
 	The latest revision of the <emphasis role="bold">NetCDF data files</emphasis> (&szdatasvn; Mb) used by the test programs can be checked out with the following command:
-	<screen format="linespecific">
+	<screen>
   <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA</parameter> <parameter>SAXO_DIR/DATA</parameter></userinput>
 	</screen>
@@ -144,11 +150,9 @@
       </sect3>
 <!--	2.2.2 -->
-      <sect3 id="saxo_svn_contributors">
-	<title>
-	  Contributors
-	</title>
+      <sect3 xml:id="saxo_svn_contributors">
+	<title> Contributors </title>
       <para>
 	<emphasis role="bold">Contributors</emphasis> should better use the following command (and replace login by your own login):
-	<screen  format="linespecific">
+	<screen >
   <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>svn+ssh://<replaceable>login</replaceable>@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/</parameter> <parameter>SAXO_DIR</parameter></userinput>
 	</screen>
@@ -159,21 +163,17 @@
   <!--	2.3 -->
 
-    <sect2 id="saxo_tar">
-      <title>
-	Get <application>SAXO</application> from a tar file
-      </title>
+    <sect2 xml:id="saxo_tar">
+      <title> Get <application>SAXO</application> from a tar file </title>
   <!--	2.3.1 -->
-      <sect3 id="saxo_src_tar">
-	<title>
-	  Get <application>SAXO</application> source files (&szsrc; Mb)
-	</title>
+      <sect3 xml:id="saxo_src_tar">
+	<title> Get <application>SAXO</application> source files (&szsrc; Mb) </title>
 	<para>
-	  Create your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> directory &hellip;
-	  <screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+	  Create your <filename class='directory'>${HOME}/SAXO_DIR</filename> directory &hellip;
+	  <screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput>
   <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>SAXO_DIR</parameter></userinput>
   <prompt>$</prompt> <userinput><command>cd</command> <parameter>SAXO_DIR</parameter></userinput>
 	  </screen>
-	  &hellip; and download it the latest version of the sources tar file: <ulink url="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_&date;.tar.gz">SAXO_SRC_&date;.tar.gz</ulink> (&szsrc; Mb). This tar.gz file could also be downloaded with 
+	  &hellip; and download it the latest version of the sources tar file: <link xl:href="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_&date;.tar.gz">SAXO_SRC_&date;.tar.gz</link> (&szsrc; Mb). This tar.gz file could also be downloaded with
 	<variablelist>
 	  <varlistentry><term><command>wget</command></term>
@@ -191,6 +191,6 @@
 	</variablelist>	
 	Untar the file
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+	<screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}/SAXO_DIR</parameter></userinput>
   <prompt>$</prompt> <userinput><command>tar</command> <option>xvfz</option> <parameter>SAXO_SRC_&date;.tar.gz</parameter></userinput>
   <prompt>$</prompt> <userinput><command>rm</command> <parameter>SAXO_SRC_&date;.tar.gz</parameter></userinput>
@@ -200,13 +200,11 @@
       </sect3>
   <!--	2.3.2 -->
-      <sect3 id="saxo_data_tar">
-	<title>
-	  Get <application>SAXO</application> tests data files (&szdata; Mb)
-	</title>
+      <sect3 xml:id="saxo_data_tar">
+	<title> Get <application>SAXO</application> tests data files (&szdata; Mb) </title>
 	<para>
-	If you want to use the tests programs, you need to download the data tests files (<filename>SAXO_DATA_&date2;.tar.gz</filename>), You may download theses files in 
+	If you want to use the tests programs, you need to download the data tests files (<filename>SAXO_DATA_&date2;.tar.gz</filename>), You may download theses files in
 	<itemizedlist>
 	  <listitem>
-           <simpara><filename class='directory'><envar>${HOME}</envar>/My_IDL</filename>. This is the easiest solution but it could be inconvenient if your <envar>${HOME}</envar> disk space is limited.
+           <simpara><filename class='directory'>${HOME}/My_IDL</filename>. This is the easiest solution but it could be inconvenient if your <envar>${HOME}</envar> disk space is limited.
            </simpara>
           </listitem>
@@ -216,11 +214,11 @@
           </listitem>
 	</itemizedlist>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+	<screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput>
   <prompt>$</prompt> <userinput><command>mkdir</command> <parameter><replaceable>CHOSEN_DIR</replaceable></parameter></userinput>
   <prompt>$</prompt> <userinput><command>cd</command> <parameter><replaceable>CHOSEN_DIR</replaceable></parameter></userinput>
 	</screen>
-	Download <ulink url="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.tar.gz">SAXO_DATA_&date2;.tar.gz</ulink> (&szdata; Mb)
-	&hellip; or with 
+	Download <link xl:href="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.tar.gz">SAXO_DATA_&date2;.tar.gz</link> (&szdata; Mb)
+	&hellip; or with
 	<variablelist>
 	  <varlistentry><term><command>wget</command></term>
@@ -242,14 +240,12 @@
   </sect1>
   <!--	3 -->
-    <sect1 id="generate_init">
-      <title>
-	Generate your init.pro file
-      </title>
+    <sect1 xml:id="generate_init">
+      <title> Generate your init.pro file </title>
       <para>
 	To use <application>SAXO</application>, we need to build an IDL script that we usually call "<filename>init.pro</filename>". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to <application>SAXO</application>. Once it has been created, <filename>init.pro</filename> should the first executed command when starting IDL session.
       </para>
       <para>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR/SRC</parameter></userinput>
+	<screen>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}/SAXO_DIR/SRC</parameter></userinput>
   <prompt>$</prompt> <userinput><command>idl</command></userinput>
   <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput>
@@ -266,9 +262,9 @@
 	<itemizedlist>
 	  <listitem>
-           <simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/My_IDL</filename>
-           </simpara>
-          </listitem>
-	  <listitem>
-           <simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename>
+           <simpara>give the path of <filename class='directory'>${HOME}/My_IDL</filename>
+           </simpara>
+          </listitem>
+	  <listitem>
+           <simpara>give the path of <filename class='directory'>${HOME}/SAXO_DIR</filename>
            </simpara>
           </listitem>
@@ -322,5 +318,5 @@
           </listitem>
 	</itemizedlist>
-	<screen format="linespecific">
+	<screen>
    <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
    <computeroutput>% Compiled module: XMANAGER.</computeroutput>
@@ -335,12 +331,12 @@
    <prompt>&promptidl;</prompt> <userinput><command>exit</command></userinput>
 	</screen>
-	There is an example of the kind of <ulink url="idlfiles/init_example.pro"> <filename>init.pro</filename></ulink> you should get.
+	There is an example of the kind of <link xl:href="idlfiles/init_example.pro"> <filename>init.pro</filename></link> you should get.
       </para>
     </sect1>
-<sect1 id="aftergetsaxo">
+<sect1 xml:id="aftergetsaxo">
 <title>After this</title>
 <para>
-You are now ready to do your 
-<ulink url="./firststeps.html">First steps with SAXO</ulink>.
+You are now ready to do your
+<link xl:href="./firststeps.html">First steps with SAXO</link>.
 </para>
 </sect1>
Index: trunk/SRC/Documentation/xmldoc/getsaxo_pre.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/getsaxo_pre.sh	(revision 345)
+++ trunk/SRC/Documentation/xmldoc/getsaxo_pre.sh	(revision 345)
@@ -0,0 +1,70 @@
+#! /bin/sh
+#
+# module :
+# ++ working on getsaxo.xml before processing for HTML and wiki
+#
+# update :
+# $Id$
+#
+# fplod 2008-04-15T10:53:26Z aedon.locean-ipsl.upmc.fr (Darwin)
+# creation from makehtml.sh
+# adapation to docbook 5.0
+#
+set -u
+set -o posix
+#
+case $( whoami ) in
+    smasson)
+        lgforge=smasson
+    ;;
+    floseb)
+        lgforge=smasson
+    ;;
+    *)
+        lgforge=saxo
+    ;;
+esac
+#
+# size of SRC and DATA with .svn
+szallsvn=$( du -sh ../../.. | awk '{print $1}' )
+szallsvn=${szallsvn%*M}
+# size of SRC with .svn
+szsrcsvn=$( du -sh ../../../SRC | awk '{print $1}' )
+szsrcsvn=${szsrcsvn%*M}
+# size of DATA with .svn
+szdatasvn=$( du -sh ../../../DATA | awk '{print $1}' )
+szdatasvn=${szdatasvn%*M}
+#
+echo "iii : you will be asked ${lgforge}@forge.ipsl.jussieu.fr passwd two times"
+#
+# find the most recent SAXO_SRC_yyyymmddrxxx.tar.gz in
+# /ipsl/forge/projets/saxo/download/
+infosrc=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_SRC_*.tar.gz  | head -n 1)
+filesrc=$(echo ${infosrc} | awk '{print $NF}')
+szsrc=$(echo ${infosrc} | awk '{print $5}')
+#
+# ndate is the date in the file SAXO_SRC_*.tar.gz
+ndate=${filesrc##*_}
+ndate=${ndate%.tar.gz}
+#
+# find the most recent SAXO_DATA_yyyymmddrxxx.tar.gz in
+# /ipsl/forge/projets/saxo/download/
+infodata=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_DATA_*.tar.gz | head -n 1)
+filedata=$(echo ${infodata} | awk '{print $NF}')
+szdata=$(echo ${infodata} | awk '{print $5}')
+#
+# ndate2 is the date in the file SAXO_DATA_*.tar.gz
+ndate2=${filedata##*_}
+ndate2=${ndate2%.tar.gz}
+#
+sed -e s/"\&date\;"/${ndate}/g \
+    -e s/"\&date2\;"/${ndate2}/g \
+    -e s/"\&szsrc\;"/${szsrc}/g \
+    -e s/"\&szdata\;"/${szdata}/g \
+    -e s/"\&szallsvn\;"/${szallsvn}/g \
+    -e s/"\&szsrcsvn\;"/${szsrcsvn}/g \
+    -e s/"\&szdatasvn\;"/${szdatasvn}/g \
+    getsaxo.xml > getsaxo_sed.xml
+#
+# exit
+exit 0
Index: trunk/SRC/Documentation/xmldoc/infoupdatecm.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/infoupdatecm.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/infoupdatecm.xml	(revision 345)
@@ -1,14 +1,14 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[]>
-<!--
--->
-<article>
-<title>Commons update</title> 
-  <articleinfo>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="infoupdatecm">
+<title>Commons update</title>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -22,9 +22,14 @@
         <revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
-<sect1 id="intro">
+<sect1 xml:id="intro">
 <title>Introduction</title>
 <para>
@@ -35,5 +40,5 @@
 </para>
 </sect1>
-<sect1 id="disappeared">
+<sect1 xml:id="disappeared">
 <title>Commons disappeared</title>
 <para>
@@ -62,5 +67,5 @@
 </para>
 </sect1>
-<sect1 id="translation">
+<sect1 xml:id="translation">
 <title>Commons translations</title>
 <para>
@@ -77,11 +82,14 @@
 </row>
 </thead>
-<tbody>
 <!-- rows from updateold.pro -->
-</tbody>
+<xi:include href="rowscm.xml" parse="xml">
+ <xi:fallback>
+  <para><emphasis>manque fichier rowscm.xml</emphasis></para>
+ </xi:fallback>
+</xi:include>
 </tgroup>
 </informaltable>
 </sect1>
-<sect1 id="otherkind">
+<sect1 xml:id="otherkind">
 <title>Commons transformations</title>
 <para>
Index: trunk/SRC/Documentation/xmldoc/infoupdatekwd.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/infoupdatekwd.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/infoupdatekwd.xml	(revision 345)
@@ -1,14 +1,14 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[]>
-<!--
--->
-<article>
-<title>Keywords translation</title> 
-  <articleinfo>
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="infoupdatekwd">
+<title>Keywords translation</title>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -22,9 +22,14 @@
         <revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
-<sect1 id="intro">
+<sect1 xml:id="intro">
 <title>Introduction</title>
 <para>
@@ -35,5 +40,5 @@
 </para>
 </sect1>
-<sect1 id="translation">
+<sect1 xml:id="translation">
 <title>Keywords translations</title>
 <para>
@@ -50,7 +55,10 @@
 </row>
 </thead>
-<tbody>
 <!-- rows from updatekwd.pro -->
-</tbody>
+<xi:include href="rowskwd.xml" parse="xml">
+ <xi:fallback>
+  <para><emphasis>manque fichier rowskwd.xml</emphasis></para>
+ </xi:fallback>
+</xi:include>
 </tgroup>
 </informaltable>
Index: trunk/SRC/Documentation/xmldoc/mailing.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/mailing.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/mailing.xml	(revision 345)
@@ -1,14 +1,14 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[]>
-<!--
--->
-<article>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en"
+xml:id="mailing">
+
 <title>SAXO Mailing lists</title>
-  <articleinfo>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -17,4 +17,9 @@
     </keywordset>
     <revhistory>
+      <revision>
+        <revnumber>0.2</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
       <revision>
         <revnumber>0.1</revnumber>
@@ -27,34 +32,34 @@
         <revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
-<sect1 id="saxo-users">
+<sect1 xml:id="saxo-users">
 <title>saxo-users@forge.ipsl.jussieu.fr</title>
 <itemizedlist>
 <listitem>
 <para>
-<ulink url="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-users/">Subscription</ulink>
+<link xl:href="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-users/">Subscription</link>
 </para>
 </listitem>
 <listitem>
 <para>
-<ulink url="http://forge.ipsl.jussieu.fr/pipermail/saxo-users/">Archives</ulink>
+<link xl:href="http://forge.ipsl.jussieu.fr/pipermail/saxo-users/">Archives</link>
 </para>
 </listitem>
 </itemizedlist>
 </sect1>
-<sect1 id="saxo-dev">
+<sect1 xml:id="saxo-dev">
 <title>saxo-dev@forge.ipsl.jussieu.fr</title>
 <itemizedlist>
 <listitem>
 <para>
-<ulink url="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-dev/">Subscription</ulink>
+<link xl:href="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-dev/">Subscription</link>
 </para>
 </listitem>
 <listitem>
 <para>
-<ulink url="http://forge.ipsl.jussieu.fr/pipermail/saxo-dev/">Archives</ulink>
+<link xl:href="http://forge.ipsl.jussieu.fr/pipermail/saxo-dev/">Archives</link>
 </para>
 </listitem>
Index: trunk/SRC/Documentation/xmldoc/makefile
===================================================================
--- trunk/SRC/Documentation/xmldoc/makefile	(revision 345)
+++ trunk/SRC/Documentation/xmldoc/makefile	(revision 345)
@@ -0,0 +1,534 @@
+#
+# module :
+# generation of documentations from XML files (and some IDL files) in HTML and
+# wiki forms
+#
+# original location :
+# /Users/fplod/SAXO_DIR_ws/SRC/Documentation/xmldoc/makefile sur aedon.locean-ipsl.upmc.fr
+#
+# update :
+# ++ wiki production not ready
+# $Id$
+# fplod 2008-04-15T15:37:59Z aedon.locean-ipsl.upmc.fr (Darwin)
+# java is not ok now :
+# http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl; Ligne #53; Colonne #35; XSLT Error (javax.xml.transform.TransformerConfigurationException): javax.xml.transform.TransformerException: javax.xml.transform.TransformerException: Had IO Exception with stylesheet file: keywords.xsl
+# replaced by xsltproc which is now ok for callouts
+# fplod 2008-04-15T08:10:09Z aedon.locean-ipsl.upmc.fr (Darwin)
+# add xml validation using xmlstarlet
+# fplod 2007-06-27T10:07:59Z aedon.locean-ipsl.upmc.fr (Darwin)
+# creation in order to replace makehtml.sh
+#
+PRODUCT = \
+saxo
+
+DIRBASE = \
+./
+
+DIRSRC = \
+$(DIRBASE)
+
+DIRTMP = \
+./
+
+DIRWWW = \
+./
+
+DIRWIKI = \
+./wiki/
+
+help :
+	@echo "\$$ make clean"
+	@echo "\$$ make all"
+	@echo "\$$ make dbkcheck"
+	@echo "++ check link"
+	@echo "++ depot html et wiki"
+
+clean :
+	-@rm -f $(DIRTMP)/*_full.xml
+	-@rm -f $(DIRTMP)/err_xmlstarlet_xsd
+	-@rm -f $(DIRTMP)/rowscm.xml
+	-@rm -f $(DIRTMP)/rowskwd.xml
+	-@rm -f $(DIRTMP)/all_plots.xml
+
+dbkcheck :
+	@-rm $(DIRTMP)/err_xmlstarlet_xsd 2> /dev/null
+	@for file in $(DIRTMP)/*_full.xml all_plots.xml; do \
+	xml val --err \
+	--xsd http://www.docbook.org/xml/5.0/xsd/docbook.xsd \
+	$${file} 1>> $(DIRTMP)/err_xmlstarlet_xsd 2>&1; done
+	@echo "check for valid diag for each file in $(DIRTMP)/err_xmlstarlet_xsd"
+
+all : \
+html \
+tracwiki
+
+html : \
+$(DIRWWW)/getsaxo.html \
+$(DIRWWW)/websaxo.html \
+$(DIRWWW)/whatsnew.html \
+$(DIRWWW)/updatesaxo.html \
+$(DIRWWW)/whatissaxo.html \
+$(DIRWWW)/faqsaxo.html \
+$(DIRWWW)/infoupdatekwd.html \
+$(DIRWWW)/infoupdatecm.html \
+$(DIRWWW)/mailing.html \
+$(DIRWWW)/tiplink.html \
+$(DIRWWW)/mini_notice.html \
+$(DIRWWW)/firststeps.html \
+$(DIRWWW)/all_plots.html
+
+tracwiki : \
+$(DIRWIKI)/AllPlots \
+$(DIRWIKI)/GetSaxo \
+$(DIRWIKI)/WebSaxo \
+$(DIRWIKI)/FaqSaxo \
+$(DIRWIKI)/Firststeps \
+$(DIRWIKI)/InfoUpdateKwd \
+$(DIRWIKI)/InfoUpdateCm \
+$(DIRWIKI)/Mailing \
+$(DIRWIKI)/MiniNotice \
+$(DIRWIKI)/Tiplink \
+$(DIRWIKI)/WhatisSaxo \
+$(DIRWIKI)/UpdateSaxo \
+$(DIRWIKI)/WhatsNew
+	@echo "Do not forget to import wiki pages"
+	@echo "$ scp $(DIRWIKI) $(PRODUCT)@forge.ipsl.jussieu.fr:/tmp/"
+	@echo "$ ssh $(PRODUCT)@forge.ipsl.jussieu.fr trac-admin /ipsl/forge/projets/$(PRODUCT)/trac wiki import notes /tmp/$(PRODUCT)"
+	@echo "$ ssh $(PRODUCT)@forge.ipsl.jussieu.fr rm /tmp/$(PRODUCT)"
+	@echo "++ $ ssh $(PRODUCT)@forge.ipsl.jussieu.fr trac-admin /ipsl/forge/projets/$(PRODUCT)/trac wiki load /tmp/wiki/$(PRODUCT)/"
+
+
+$(DIRWIKI)/WebSaxo: \
+$(DIRTMP)/websaxo_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/websaxo_full.xml
+
+$(DIRWWW)/websaxo.html : \
+$(DIRTMP)/websaxo_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/websaxo_full.xml
+
+$(DIRTMP)/websaxo_full.xml : \
+$(DIRSRC)/websaxo.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/websaxo.xml
+
+$(DIRWIKI)/FaqSaxo: \
+$(DIRTMP)/faqsaxo_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/faqsaxo_full.xml
+
+$(DIRWWW)/faqsaxo.html : \
+$(DIRTMP)/faqsaxo_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/faqsaxo_full.xml
+
+$(DIRTMP)/faqsaxo_full.xml : \
+$(DIRSRC)/faqsaxo.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/faqsaxo.xml
+
+$(DIRWIKI)/GetSaxo: \
+$(DIRTMP)/getsaxo_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/getsaxo_full.xml
+
+$(DIRWWW)/getsaxo.html : \
+$(DIRTMP)/getsaxo_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/getsaxo_full.xml
+
+$(DIRTMP)/getsaxo_full.xml : \
+$(DIRSRC)/getsaxo.xml \
+$(DIRSRC)/getsaxo_pre.sh
+	@$(DIRSRC)/getsaxo_pre.sh
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRTMP)/getsaxo_sed.xml
+
+$(DIRWIKI)/Firststeps : \
+$(DIRTMP)/firststeps_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/firststeps_full.xml
+
+$(DIRWWW)/firststeps.html : \
+$(DIRTMP)/firststeps_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/firststeps_full.xml
+
+$(DIRWIKI)/AllPlots: \
+$(DIRTMP)/all_plots.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/all_plots.xml
+
+$(DIRWWW)/all_plots.html : \
+$(DIRTMP)/all_plots.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/all_plots.xml
+
+
+$(DIRTMP)/all_plots.xml : \
+$(DIRSRC)/all_plots_docbook.xsl \
+$(DIRTMP)/firststeps_full.xml
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/all_plots_docbook.xsl \
+	$(DIRTMP)/firststeps_full.xml
+
+$(DIRTMP)/firststeps_full.xml : \
+$(DIRSRC)/firststeps.xml \
+$(DIRSRC)/firststeps_pre.sh
+	@$(DIRSRC)/firststeps_pre.sh
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRTMP)/firststeps_sed.xml
+	@rm $(DIRTMP)/firststeps_sed.xml 2> /dev/null
+
+$(DIRWIKI)/Mailing : \
+$(DIRTMP)/mailing_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/mailing_full.xml
+
+$(DIRWWW)/mailing.html : \
+$(DIRTMP)/mailing_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/mailing_full.xml
+
+$(DIRTMP)/mailing_full.xml : \
+$(DIRSRC)/mailing.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/mailing.xml
+
+$(DIRWIKI)/MiniNotice : \
+$(DIRTMP)/mini_notice_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/mini_notice_full.xml
+
+$(DIRWWW)/mini_notice.html : \
+$(DIRTMP)/mini_notice_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/mini_notice_full.xml
+
+$(DIRTMP)/mini_notice_full.xml : \
+$(DIRSRC)/mini_notice.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/mini_notice.xml
+
+$(DIRWIKI)/Tiplink : \
+$(DIRTMP)/tiplink_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/tiplink_full.xml
+
+$(DIRWWW)/tiplink.html : \
+$(DIRTMP)/tiplink_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/tiplink_full.xml
+
+$(DIRTMP)/tiplink_full.xml : \
+$(DIRSRC)/tiplink.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/tiplink.xml
+
+$(DIRWIKI)/InfoUpdateCm : \
+$(DIRTMP)/infoupdatecm_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/infoupdatecm_full.xml
+
+$(DIRWWW)/infoupdatecm.html : \
+$(DIRTMP)/infoupdatecm_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/infoupdatecm_full.xml
+
+$(DIRTMP)/infoupdatecm_full.xml : \
+$(DIRSRC)/infoupdatecm.xml \
+$(DIRTMP)/rowscm.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/infoupdatecm.xml
+
+$(DIRWIKI)/InfoUpdateKwd : \
+$(DIRTMP)/infoupdatekwd_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/infoupdatekwd_full.xml
+
+$(DIRWWW)/infoupdatekwd.html : \
+$(DIRTMP)/infoupdatekwd_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/infoupdatekwd_full.xml
+
+$(DIRTMP)/infoupdatekwd_full.xml : \
+$(DIRTMP)/infoupdatekwd.xml \
+$(DIRTMP)/rowskwd.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRTMP)/infoupdatekwd.xml
+
+$(DIRTMP)/rowscm.xml : \
+../../ForOldVersion/updateold.pro
+	@echo "<tbody>" > $@
+	@grep "IF NOT key_forgetold AND n_elements(\(.* = .*\)" ../../ForOldVersion/updateold.pro | \
+	sort | \
+	sed -e "s/\(^.* THEN \)\(.*\)\( = \)\(.*\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" >> $@
+	@echo "</tbody>" >> $@
+
+$(DIRTMP)/rowskwd.xml : \
+../../ForOldVersion/updatekwd.pro
+	@echo "<tbody>" > $@
+	@grep "^  old = \[old, .* new = \[new" ../../ForOldVersion/updatekwd.pro | \
+	sort | \
+	sed -e "s/\( old = \[old, '\)\(.*\)\('\] *& new = \[new, '\)\(.*\)\('\]\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" >> $@
+
+	@echo "</tbody>" >> $@
+
+$(DIRWIKI)/WhatisSaxo : \
+$(DIRTMP)/whatissaxo_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/whatissaxo_full.xml
+
+$(DIRWWW)/whatissaxo.html : \
+$(DIRTMP)/whatissaxo_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/whatissaxo_full.xml
+
+$(DIRTMP)/whatissaxo_full.xml : \
+$(DIRSRC)/whatissaxo.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/whatissaxo.xml
+
+$(DIRWIKI)/WhatsNew : \
+$(DIRTMP)/whatsnew_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/whatsnew_full.xml
+
+$(DIRWWW)/whatsnew.html : \
+$(DIRTMP)/whatsnew_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/whatsnew_full.xml
+	
+$(DIRTMP)/whatsnew_full.xml : \
+$(DIRSRC)/whatsnew.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/whatsnew.xml
+
+$(DIRWIKI)/UpdateSaxo : \
+$(DIRTMP)/updatesaxo_full.xml \
+$(DIRSRC)/main_tracwiki.xsl
+	@xsltproc \
+	--output $@ \
+	$(DIRSRC)/main_tracwiki.xsl \
+	$(DIRTMP)/updatesaxo_full.xml
+
+$(DIRWWW)/updatesaxo.html : \
+$(DIRTMP)/updatesaxo_full.xml \
+$(DIRSRC)/saxo_html.xsl \
+$(DIRSRC)/style.css \
+$(DIRSRC)/$(PRODUCT).css
+	@xsltproc \
+	--param html.stylesheet "'style.css $(PRODUCT).css'" \
+	--param css.decoration 1 \
+	--param link.mailto.url "'mailto:saxo-dev_at_forge.ipsl.jussieu.fr'" \
+	--param section.autolabel 1 \
+	--output $@ \
+	$(DIRSRC)/saxo_html.xsl \
+	$(DIRTMP)/updatesaxo_full.xml
+	
+$(DIRTMP)/updatesaxo_full.xml : \
+$(DIRSRC)/updatesaxo.xml
+	@xmllint \
+	--xinclude \
+	--encode utf-8 \
+	--noent \
+	--output $@ \
+	$(DIRSRC)/updatesaxo.xml
+
+$(DIRTMP)/titlepage.main.xsl : \
+$(DIRSRC)/titlepage.main.xml
+	@xsltproc \
+	--output $@ \
+	http://docbook.sourceforge.net/release/xsl/current/template/titlepage.xsl \
+	$(DIRSRC)/titlepage.main.xml
+	$(DIRSRC)/titlepage.main.xml
Index: trunk/SRC/Documentation/xmldoc/makehtml.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/makehtml.sh	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/makehtml.sh	(revision 345)
@@ -8,4 +8,6 @@
 # released on 1 September 2005) doesn't handle carriage returns
 #
+# fplod 2008-04-16T09:02:05Z aedon.locean-ipsl.upmc.fr (Darwin)
+# this file is not used anymore. see makefile.
 # fplod 2007-06-27T11:54:26Z aedon.locean-ipsl.upmc.fr (Darwin)
 # replacing saxon by xalan because of better results on callouts
Index: trunk/SRC/Documentation/xmldoc/mini_notice.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/mini_notice.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/mini_notice.xml	(revision 345)
@@ -1,10 +1,25 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
-<!ENTITY hellip	"&#x2026;">
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article [
+<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
+%isolat1;
+<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
+%isolat2;
+<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
+%isogrk3;
+<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
+%isopub;
+<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
+%isotech;
+<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
+%isonum;
 <!ENTITY promptidl "idl&gt;">
 ]
 >
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="mini_notice">
 <!--
 
@@ -19,14 +34,11 @@
 
 -->
-<article lang="en">
-<title>
-Mini Guide for Basic Commands in the XXX Program
-</title>
-  <articleinfo>
+<title> Mini Guide for Basic Commands in the XXX Program </title>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Albert</firstname><surname>Fisher</surname></author>
-      <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Steve</firstname><surname>Navarro</surname></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Albert</firstname> <surname>Fisher</surname></personname></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Steve</firstname> <surname>Navarro</surname></personname></author>
     </authorgroup>
     <keywordset>
@@ -61,14 +73,20 @@
         <revremark>Review by Sébastien Masson</revremark>
       </revision>
+      <revision>
+        <revnumber>1.2</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+
      </revhistory>
      <pubdate>$Id$</pubdate>
-  </articleinfo>
-
-
-<sect1 id="launchxxx"><title>Launching XXX</title>
+  </info>
+
+
+<sect1 xml:id="launchxxx"><title>Launching XXX</title>
 
 <para>
 There is several ways to launch XXX which we will detail in the next sections:
-  <screen format="linespecific">
+  <screen>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput>
@@ -82,15 +100,15 @@
 </para>
 
-<sect2 id="launch_xxx_1"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput></title>
+<sect2 xml:id="launch_xxx_1"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput></title>
   <para>
     A window will open with 3 parts to consider.
-<figure id="fig_xxx_0101">
+<figure xml:id="fig_xxx_0101">
 <title>Window xxx 1</title>
-<mediaobjectco>
+<mediaobject>
 <imageobjectco>
 <areaspec units="calspair">
-<area id="datafile" coords="500,1715 9326,3074"/>
-<area id="initmethod" coords="1500,3268 8326,4919"/>
-<area id="initprogram" coords="57,5145 9961,8996"/>
+<area xml:id="datafile" coords="500,1715 9326,3074"/>
+<area xml:id="initmethod" coords="1500,3268 8326,4919"/>
+<area xml:id="initprogram" coords="57,5145 9961,8996"/>
 </areaspec>
 <imageobject>
@@ -112,31 +130,29 @@
 <textobject>[plot figpng/xxx_0101.png]</textobject>
 -->
-</mediaobjectco>
+</mediaobject>
 </figure>
   </para>
 
-<sect3 id="datafiletxt"><title>Data file name</title>
+<sect3 xml:id="datafiletxt"><title>Data file name</title>
   <para>
     The name of the data file. It can be typed directly in the window provided, or selected with the help of the <guibutton>browse</guibutton> button.
   </para>
 </sect3>
-<sect3 id="initmethodtxt"><title>Grid initialization method</title>
+<sect3 xml:id="initmethodtxt"><title>Grid initialization method</title>
   <para>
-    For visualising grilled data, you need to <ulink url="./firststeps.html#load_grid">define the grid</ulink> on which are located the data. By default, "automatic grid construction with initncdf.pro" is checked. This means that the grid will be defined by using the informations contained in the data file (through the IDL prodecure <command>initncdf</command>) without needing any other auxiliary file. If you checked "grid construction with other IDL batch or procedure", this means that you don't want to use the default <command>initncdf</command> procedure to define the grid and you will provide your own IDL procedure or the so-called IDL batch file (a file which is called by using @, see IDL documentation).
+    For visualising grilled data, you need to <link xl:href="./firststeps.html#load_grid">define the grid</link> on which are located the data. By default, "automatic grid construction with initncdf.pro" is checked. This means that the grid will be defined by using the informations contained in the data file (through the IDL prodecure <command>initncdf</command>) without needing any other auxiliary file. If you checked "grid construction with other IDL batch or procedure", this means that you don't want to use the default <command>initncdf</command> procedure to define the grid and you will provide your own IDL procedure or the so-called IDL batch file (a file which is called by using @, see IDL documentation).
   </para>
 </sect3>
-<sect3 id="initprogramtxt"><title>Grid initialization parameters</title>
+<sect3 xml:id="initprogramtxt"><title>Grid initialization parameters</title>
   <para>
     This third part allows you to specify the name, the argument and the keywords of the routine you want to use to initialize the grid.
 By default the name of the procedure is <command>initncdf</command>, its argument will be automatically defined so you cannot change them. If you If you checked "grid construction with other IDL batch or procedure", you have to select the name of the IDL procedure or batch file and its suitable arguments and keywords. Note that if you select an IDL batch file you cannot give any parameter or keyword.
-    <figure id="fig_xxx_0102">
+    <figure xml:id="fig_xxx_0102">
       <title>Window xxx 1</title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0102.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0102.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
   </para>
@@ -147,15 +163,17 @@
   </para>
 <para>
-  <figure id="fig_xxx_0103">
+  <figure xml:id="fig_xxx_0103">
       <title>Oceania at 125 meters of depth with proper grid initialization</title>
-	<imageobject>
-	  <imagedata fileref="figpng/xxx_0103.png"/>
-	</imageobject>
-  </figure>
-</para>
-</sect3>
-</sect2>
-
-<sect2 id="launch_xxx_2"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput></title>
+<mediaobject>
+<imageobject>
+  <imagedata fileref="figpng/xxx_0103.png"/>
+</imageobject>
+      </mediaobject>
+  </figure>
+</para>
+</sect3>
+</sect2>
+
+<sect2 xml:id="launch_xxx_2"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput></title>
 <para>
 This is the same as the simple <link linkend="launch_xxx_1"><prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput></link> except that once the xxx window open, you will have 2 separate windows (command and plotting window) instead of one.
@@ -163,5 +181,5 @@
 </sect2>
 
-<sect2 id="launch_xxx_3"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_3"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></title>
 <para>
 In that case xxx window will open directly in the same state as it was when the file "file.dat" was created. see <link linkend="restore">+++++++</link>
@@ -169,8 +187,8 @@
 </sect2>
 
-<sect2 id="launch_xxx_4"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_4"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter></userinput></title>
 <para>
 In this case, the xxx window directly open the data file 'file.nc' and build the grid automatically with the IDL procedure <command>initncdf</command>. For example:
-  <screen format="linespecific">
+  <screen>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</parameter></userinput>
   </screen>
@@ -178,8 +196,8 @@
 </sect2>
 
-<sect2 id="launch_xxx_5"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_5"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput></title>
 <para>
 In this case, the xxx window directly open the data file 'file.nc', build the grid automatically with the IDL procedure <command>initncdf</command> and use the keywords <userinput><parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput> in the call of <command>initncdf</command>. For example:
-  <screen format="linespecific">
+  <screen>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</parameter>, <parameter>useasmask = 'votemper'</parameter>, <parameter>missing_value = 31.0720</parameter></userinput>
   </screen>
@@ -187,8 +205,8 @@
 </sect2>
 
-<sect2 id="launch_xxx_6"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_6"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter></userinput></title>
 <para>
 In this case, the xxx window directly open the data file 'file.nc' and build the grid directly with the IDL procedure or batch file <command>initgrid</command>
-  <screen format="linespecific">
+  <screen>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc'</parameter>, <parameter>'tst_initorca2'</parameter></userinput>
   </screen>
@@ -196,5 +214,5 @@
 </sect2>
 
-<sect2 id="launch_xxx_7"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter>, <parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_7"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter>, <parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput></title>
 <para>
 In this case, the xxx window directly open the data file 'file.nc', build the grid directly with the IDL procedure <command>initgrid</command> and use the keywords <userinput><parameter>keywd1 = &hellip;</parameter>, <parameter>keywd2 = &hellip;</parameter></userinput> in the call of <command>initgrid</command>.
@@ -202,5 +220,5 @@
 </sect2>
 
-<sect2 id="launch_xxx_8"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter>, <parameter>'arg1, arg2, &hellip;'</parameter></userinput></title>
+<sect2 xml:id="launch_xxx_8"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter>, <parameter>'arg1, arg2, &hellip;'</parameter></userinput></title>
 <para>
 In this case, the xxx window directly open the data file 'file.nc', build the grid directly with the IDL procedure <command>initgrid</command> and use the string <userinput><parameter>'arg1, arg2, &hellip;'</parameter></userinput> to specify the input arguments in the call of <command>initgrid</command>.
@@ -210,5 +228,5 @@
 </sect1>
 
-<sect1 id="wigdets"><title>Description of XXX window</title>
+<sect1 xml:id="wigdets"><title>Description of XXX window</title>
 
 <para>
@@ -220,19 +238,19 @@
 ce produit klickety est installable via fink sous mac
  -->
-<figure id="fig_xxx_0201">
+<figure xml:id="fig_xxx_0201">
 <title>Window xxx 2</title>
-<mediaobjectco>
+<mediaobject>
 <imageobjectco>
 <areaspec units="calspair">
-<area id="plottype" coords="69,380 2261,809"/>
-<area id="menu" coords="2517,380 7575,841"/>
-<area id="ok" coords="116,936 1025,1365"/>
-<area id="pagelayout" coords="1631,936 4498,1365"/>
-<area id="variableslist" coords="4871,952 7529,1349"/>
-<area id="fileslist" coords="46,1507 8018,1857"/>
-<area id="commandtext" coords="46,2000 8065,2539"/>
-<area id="calendar" coords="46,2682 4941,3428"/>
-<area id="domdef" coords="372,3603 7179,7095"/>
-<area id="specifications" coords="23,7269 8041,9206"/>
+<area xml:id="plottype" coords="69,380 2261,809"/>
+<area xml:id="menu" coords="2517,380 7575,841"/>
+<area xml:id="ok" coords="116,936 1025,1365"/>
+<area xml:id="pagelayout" coords="1631,936 4498,1365"/>
+<area xml:id="variableslist" coords="4871,952 7529,1349"/>
+<area xml:id="fileslist" coords="46,1507 8018,1857"/>
+<area xml:id="commandtext" coords="46,2000 8065,2539"/>
+<area xml:id="calendar" coords="46,2682 4941,3428"/>
+<area xml:id="domdef" coords="372,3603 7179,7095"/>
+<area xml:id="specifications" coords="23,7269 8041,9206"/>
 </areaspec>
 <imageobject>
@@ -275,16 +293,18 @@
 <textobject>[plot figpng/xxx_0201.png]</textobject>
 -->
-</mediaobjectco>
+</mediaobject>
 </figure>
 </para>
 
-<sect2 id="plottypetxt"><title>Plot type list</title>
+<sect2 xml:id="plottypetxt"><title>Plot type list</title>
 <para>Allows specification of the type of plot desired.</para>
 <para>
-    <figure id="fig_xxx_0202">
+    <figure xml:id="fig_xxx_0202">
       <title>Different plot types available</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0202.png"/>
-	  </imageobject>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0202.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -296,12 +316,14 @@
 </sect2>
 
-<sect2 id="menutxt"><title>The menu bar made up of 3 sub-menus</title>
-<sect3 id="filesubmenu"><title><guibutton>File</guibutton> sub-menu</title>
-<para>
-    <figure id="fig_xxx_0203">
+<sect2 xml:id="menutxt"><title>The menu bar made up of 3 sub-menus</title>
+<sect3 xml:id="filesubmenu"><title><guibutton>File</guibutton> sub-menu</title>
+<para>
+    <figure xml:id="fig_xxx_0203">
       <title>The File menu</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0203.png"/>
-	  </imageobject>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0203.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -311,16 +333,18 @@
 The new file can be on a different grid, with different variables, with a different time base &hellip;
 </para></listitem>
-<listitem><para><menuchoice><guisubmenu>New XXX:</guisubmenu></menuchoice> to open a second XXX window identical to the first one.</para></listitem>
+<listitem><para><menuchoice><guisubmenu>New XXX:</guisubmenu></menuchoice> to open a second XXX window xml:identical to the first one.</para></listitem>
 <listitem><para><menuchoice><guisubmenu>Quit:</guisubmenu></menuchoice> to close the XXX window.</para></listitem>
 </itemizedlist>
 </para>
 </sect3>
-<sect3 id="saveassubmenu"><title><guibutton>Save As</guibutton> sub-menu</title>
-<para>
-    <figure id="fig_xxx_0204">
+<sect3 xml:id="saveassubmenu"><title><guibutton>Save As</guibutton> sub-menu</title>
+<para>
+    <figure xml:id="fig_xxx_0204">
       <title>The Save As menu</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0204.png"/>
-	  </imageobject>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0204.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -334,30 +358,32 @@
 <listitem><para><menuchoice><guisubmenu>Gif:</guisubmenu></menuchoice> to save a gif of the plotting window.</para></listitem>
 <listitem><para><menuchoice><guisubmenu>IDL procedure:</guisubmenu></menuchoice> to save the command history that has created the plot in an IDL procedure that can be re-executed later. For example if I save the commands in <filename>xxx_figure.pro</filename> file, when ever I want, I can then launch a new IDL session and type:
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>@init</userinput>
 <prompt>&promptidl;</prompt> <userinput>xxx_figure</userinput>
 </screen>
 and I'll obtain the saved figure.
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>xxx_figure,/post</userinput>
 </screen>
 or
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>@ps</userinput>
 </screen>
 will then create a Postscript file of the figure.
 </para></listitem>
-<listitem><para id='restore'><menuchoice><guisubmenu>RESTORE kwd of xxx:</guisubmenu></menuchoice> to save the xxx widget (all buttons and parameters stored in memory &hellip;) in a binary file in order to quit xxx and relaunch it later with <link linkend="launch_xxx_3"><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></link> and get exactly the same configuration.</para></listitem>
+<listitem><para xml:id='restore'><menuchoice><guisubmenu>RESTORE kwd of xxx:</guisubmenu></menuchoice> to save the xxx widget (all buttons and parameters stored in memory &hellip;) in a binary file in order to quit xxx and relaunch it later with <link linkend="launch_xxx_3"><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></link> and get exactly the same configuration.</para></listitem>
 <listitem><para><menuchoice><guisubmenu>Print to prompt:</guisubmenu></menuchoice> lists in the IDL window the command history that created the last plot. Useful primarily for debugging&hellip;</para></listitem>
 </itemizedlist>
 </para>
 </sect3>
-<sect3 id="flagsubmenu"><title><guisubmenu>Flag options</guisubmenu> sub-menu</title>
-<para>
-    <figure id="fig_xxx_0205">
+<sect3 xml:id="flagsubmenu"><title><guisubmenu>Flag options</guisubmenu> sub-menu</title>
+<para>
+    <figure xml:id="fig_xxx_0205">
       <title>The Flag Option menu</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0205.png"/>
-	  </imageobject>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0205.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -378,114 +404,134 @@
 </sect2>
 
-<sect2 id="oktxt"><title>OK button</title>
+<sect2 xml:id="oktxt"><title>OK button</title>
 <para>Click on this <guibutton>OK</guibutton> button is required to make a new plot appear</para>
 </sect2>
 
-<sect2 id="pagelayouttxt"><title>Page Layout</title>
+<sect2 xml:id="pagelayouttxt"><title>Page Layout</title>
 <para>Specify the number of columns and rows for plots on the sheet of paper.</para>
 <para>
-    <figure id="fig_xxx_0206">
+    <figure xml:id="fig_xxx_0206">
       <title>Number of Column</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0206.png"/>
-	  </imageobject>
-    </figure>
-</para>
-<para>
-    <figure id="fig_xxx_0206a">
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0206.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0206a">
       <title>Example: For 2 columns and 2 rows</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0206a.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</sect2>
-
-<sect2 id="variableslisttxt"><title>List of variables</title>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0206a.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</sect2>
+
+<sect2 xml:id="variableslisttxt"><title>List of variables</title>
 <para>You can choose the variable to work on.</para>
 <para>
-    <figure id="fig_xxx_0207">
+    <figure xml:id="fig_xxx_0207">
       <title>Example of different Variables available</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0207.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</sect2>
-
-<sect2 id="fileslisttxt"><title>List of open files</title>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0207.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</sect2>
+
+<sect2 xml:id="fileslisttxt"><title>List of open files</title>
 <para>You can choose the file to work on.</para>
 <para>
-    <figure id="fig_xxx_0208">
+    <figure xml:id="fig_xxx_0208">
       <title>Example of list of open files</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0208.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</sect2>
-
-<sect2 id="commandtexttxt"><title><guimenuitem>Command text</guimenuitem><!--++ textarea--></title>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0208.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</sect2>
+
+<sect2 xml:id="commandtexttxt"><title><guimenuitem>Command text</guimenuitem><!--++ textarea--></title>
 <para>
 To specify in the widget part number 7 the computation you want to do on the data
 <note><para>In all cases bellow, the name given to a field (a, b, c, &hellip;) is of no importance.</para></note>
 </para>
-<sect3 id="commandtext1"><title>Linear calculation</title>
-<para>
-If you want to make basic linear computation (like difference between fields, add/multiply by a constant &hellip;). you can simply put the following commands: <screen format="linespecific">a - b</screen><screen format="linespecific">numb1*a</screen><screen format="linespecific">a + numb</screen> or any command with the following format <screen format="linespecific">numb1*a + numb2*b  + numb3*c &hellip; + numb</screen> where numb1, numb2, &hellip; correspond to numbers and a, b, c &hellip; will be the data to read.
-</para>
-</sect3>
-<sect3 id="commandtext1"><title>Any kind of computation</title>
-<para>
-If you want to make a computation more complicated than a basic linear you must put designate the data you want to read between <keycap>"</keycap><keycap>"</keycap> (with anything in between the "). For example: <screen format="linespecific">"a"^2</screen><screen format="linespecific">"a" - abs("b")</screen><screen format="linespecific">grad("a", 'x')</screen> &hellip;
-</para>
-</sect3>
-</sect2>
-
-<sect2 id="calendartxt"><title>Calendar</title>
+<sect3 xml:id="commandtext_linear"><title>Linear calculation</title>
+<para>
+If you want to make basic linear computation (like difference between fields, add/multiply by a constant &hellip;). you can simply put the following commands: <screen>a - b</screen><screen>numb1*a</screen><screen>a + numb</screen> or any command with the following format <screen>numb1*a + numb2*b  + numb3*c &hellip; + numb</screen> where numb1, numb2, &hellip; correspond to numbers and a, b, c &hellip; will be the data to read.
+</para>
+</sect3>
+<sect3 xml:id="commandtext_anykind"><title>Any kind of computation</title>
+<para>
+If you want to make a computation more complicated than a basic linear you must put designate the data you want to read between <keycap>"</keycap><keycap>"</keycap> (with anything in between the "). For example: <screen>"a"^2</screen><screen>"a" - abs("b")</screen><screen>grad("a", 'x')</screen> &hellip;
+</para>
+</sect3>
+</sect2>
+
+<sect2 xml:id="calendartxt"><title>Calendar</title>
 <para>
 The calendar is made up of two drop-lists, which allow specification of two dates, the beginning and end of a time series, or the period over which to average before plotting.</para>
 <para>
-    <figure id="fig_xxx_0301">
+    <figure xml:id="fig_xxx_0301">
       <title>Example: first plot in January, second plot is from January to December</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0301.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</sect2>
-
-<sect2 id="domdeftxt"><title>Define the domain</title>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0301.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</sect2>
+
+<sect2 xml:id="domdeftxt"><title>Define the domain</title>
 <para>
   A series of widgets that allow specification of the min/max limits of the domain in longitude/x-index, latitude/y-index, and depth in levels or meters.
-  <figure id="fig_xxx_0210">
+  <figure xml:id="fig_xxx_0210_domain">
     <title>Domain by default</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0210.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0401">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0401">
     <title>Change Domain area: zoom on Oceania</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0401.png"/>
-	  </imageobject>
-  </figure>
-  <figure id="fig_xxx_0402">
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0401.png"/>
+  </imageobject>
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0402">
     <title>This configuration give us:</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0402.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0403">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0403">
     <title>Change depth area: between depth 125 and 126</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0403.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0404">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0404">
     <title>temperature of the ocean at depth 125 meters without proper land/sea mask</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0404.png"/>
     </imageobject>
+      </mediaobject>
   </figure>
   As you can see, at this depth, we better define a land/sea mask when loading the grid. Cf <xref linkend="fig_xxx_0103"/>
@@ -493,63 +539,77 @@
 </sect2>
 
-<sect2 id="specificationstxt"><title>Specify your plot</title>
-
-<sect3 id="minmaxintervaltxt"><title>Specify min, max and contour interval</title>
-<para>
-  <figure id="fig_xxx_0501">
+<sect2 xml:id="specificationstxt"><title>Specify your plot</title>
+
+<sect3 xml:id="minmaxintervaltxt"><title>Specify min, max and contour interval</title>
+<para>
+  <figure xml:id="fig_xxx_0501">
     <title>min, max, and contour interval specifications</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0501.png"/>
     </imageobject>
+      </mediaobject>
   </figure>
   You can restore configuration by default by pressing the <menuchoice><guibutton>Default</guibutton></menuchoice> button.
-  <note><para>The path of the file <ulink type="text" url="../../ToBeReviewed/WIDGET/AUTOUR_de_XXX/definedefaultextra.pro"><filename>definedefaultextra.pro</filename></ulink> that defines the default values for each variable names is displayed when the cursor hovers over the button <menuchoice><guibutton>Default</guibutton></menuchoice>. This file contains a case statement based on the name of the variable and defining the min, max, contour interval and other keywords that should be used as default for the specified variable. You can copy this file in your own <filename class="directory"><envar>${HOME}</envar>/My_IDL/</filename> directory and easily modify it to suit your favorite default values.</para></note>
-</para>
-</sect3>
-
-<sect3 id="colortxt"><title>Specify the palette to be used</title>
+  <note><para>The path of the file <link xl:href="../../ToBeReviewed/WIDGET/AUTOUR_de_XXX/definedefaultextra.pro"><filename>definedefaultextra.pro</filename></link> that defines the default values for each variable names is displayed when the cursor hovers over the button <menuchoice><guibutton>Default</guibutton></menuchoice>. This file contains a case statement based on the name of the variable and defining the min, max, contour interval and other keywords that should be used as default for the specified variable. You can copy this file in your own <filename class="directory">${HOME}/My_IDL/</filename> directory and easily modify it to suit your favorite default values.</para></note>
+</para>
+</sect3>
+
+<sect3 xml:id="colortxt"><title>Specify the palette to be used</title>
 <para>For the color palette, you can either specify the name or go search for one among the palettes available.</para>
 <para>
-    <figure id="fig_xxx_0502">
+    <figure xml:id="fig_xxx_0502">
       <title>The Color menu</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0502.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</sect3>
-
-<sect3 id="kwdtxt"><title>Add any keyword</title>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0502.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</sect3>
+
+<sect3 xml:id="kwdtxt"><title>Add any keyword</title>
 <para>
   The <quote>keywords</quote> window allows specification of all desired keywords. There is a few examples of the use of this <quote>keywords</quote> window.
-  <figure id="fig_xxx_0209">
+  <figure xml:id="fig_xxx_0209">
     <title>Without any additional keyword</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0209.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0210a">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0210a">
     <title>Add <varname>/realcont</varname> keyword</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0210a.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0210">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0210_realcont">
     <title>Graphic with <varname>/realcont</varname> keyword</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0210.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0211a">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0211a">
     <title>Add <userinput>/realcont, map=[90,0,0], /ortho, cell_fill=2</userinput> keywords</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0211a.png"/>
     </imageobject>
-  </figure>
-  <figure id="fig_xxx_0211">
+      </mediaobject>
+  </figure>
+  <figure xml:id="fig_xxx_0211">
     <title>Graphic with <literal>/realcont, map=[90,0,0], /ortho, cell_fill=2</literal> keywords</title>
+<mediaobject>
     <imageobject>
       <imagedata fileref="figpng/xxx_0211.png"/>
     </imageobject>
+      </mediaobject>
   </figure>
 </para>
@@ -558,7 +618,7 @@
 </sect1>
 
-<sect1 id="mouseactions"><title>Mouse Actions</title>
-
-<sect2 id="mouse"><title>In the graphics window on a horizontal plot</title>
+<sect1 xml:id="mouseactions"><title>Mouse Actions</title>
+
+<sect2 xml:id="mouse"><title>In the graphics window on a horizontal plot</title>
 <para>
 Select a domain and select the horizontal plot (<constant>plt</constant>), vertical plot
@@ -586,67 +646,73 @@
 <para>
 <itemizedlist>
-<listitem><para>
-    <figure id="fig_mousell">
+<listitem>
+<para>
+    <figure xml:id="fig_mousell">
       <title><abbrev>LCL</abbrev>---><constant>plt</constant></title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mousell.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-<para>
-    <figure id="fig_xxx_0701">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mousell.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0701">
       <title>Horizontal Plot</title>
- 	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0701.png"/>
-	  </imageobject>
-    </figure>
-</para>
-
-</para></listitem>
-<listitem><para>
-    <figure id="fig_mouselm">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0701.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+
+</listitem>
+<listitem>
+<para>
+    <figure xml:id="fig_mouselm">
       <title><abbrev>LCM</abbrev>---><constant>pltz</constant></title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mouselm.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-<para>
-    <figure id="fig_xxx_0702">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mouselm.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0702">
       <title>Vertical Plot</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0702.png"/>
-	  </imageobject>
-    </figure>
-</para>
-
-</para></listitem>
-<listitem><para>
-    <figure id="fig_mouselr">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0702.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+
+</listitem>
+<listitem>
+<para>
+    <figure xml:id="fig_mouselr">
       <title><abbrev>LCR</abbrev>---><constant>pltt</constant></title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mouselr.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-<para>
-    <figure id="fig_xxx_0703">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mouselr.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0703">
       <title>Common hovmoeller for xt and yt cuts</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0703.png"/>
-	  </imageobject>
-    </figure>
-</para>
-
-</para></listitem>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0703.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+
+</listitem>
 </itemizedlist>
 </para>
@@ -655,5 +721,5 @@
 
 </sect2>
-<sect2 id="multipleplots"><title>Create multiple plots on the same sheet and make them interact</title>
+<sect2 xml:id="multipleplots"><title>Create multiple plots on the same sheet and make them interact</title>
 
 <para>
@@ -664,5 +730,5 @@
 <para>
 To create a plot in another frame double-click in the frame with the
-<mousebutton>middle</mousebutton> button (<abbrev><keycombo action="double-click"><mousebutton>DCM</mousebutton></keycombo></abbrev>).
+<mousebutton>middle</mousebutton> button (<keycombo action="double-click"><mousebutton>DCM</mousebutton></keycombo>).
 A black dotted frame will surround the designated frame, the <quote>target</quote> frame.
 A black frame will surround the first plot.
@@ -676,58 +742,62 @@
 <para>In summary: </para>
 <itemizedlist>
-<listitem><para>
-    <figure id="fig_mousedl">
+<listitem>
+<para>
+    <figure xml:id="fig_mousedl">
       <title><abbrev>DCL</abbrev>---><quote>reference</quote> frame</title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mousedl.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-<para>
-    <figure id="fig_xxx_0801">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mousedl.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0801">
       <title>The reference frame is selected</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0801.png"/>
-	  </imageobject>
-    </figure>
-</para>
-
-</para></listitem>
-<listitem><para>
-    <figure id="fig_mousedm">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0801.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+
+</listitem>
+<listitem>
+<para>
+    <figure xml:id="fig_mousedm">
       <title><abbrev>DCM</abbrev>---><quote>target</quote> frame</title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mousedm.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-<para>
-    <figure id="fig_xxx_0802">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mousedm.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+<para>
+    <figure xml:id="fig_xxx_0802">
       <title>The target frame is selected</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0802.png"/>
-	  </imageobject>
-    </figure>
-</para>
-</para></listitem>
-<listitem><para>
-    <figure id="fig_mousedr">
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0802.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+</para>
+</listitem>
+<listitem>
+<para>
+    <figure xml:id="fig_mousedr">
       <title><abbrev>DCR</abbrev>--->erase the frame</title>
-      <mediaobjectco>
-	<imageobjectco>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_mousedr.png"/>
-	  </imageobject>
-	</imageobjectco>
-      </mediaobjectco>
-    </figure>
-
-</para></listitem>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_mousedr.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
+
+</para>
+</listitem>
 </itemizedlist>
 <para>Here's a series of commands to show how this works.</para>
@@ -736,5 +806,5 @@
 <para>
 load xxx with the command:
-  <screen format="linespecific">
+  <screen>
     <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc'</parameter>, <parameter>'tst_initorca05'</parameter></userinput>
   </screen>
@@ -763,9 +833,11 @@
 </para>
 <para>
-    <figure id="fig_xxx_0901">
+    <figure xml:id="fig_xxx_0901">
       <title>Frame with four plot</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0901.png"/>
-	  </imageobject>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0901.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -785,12 +857,14 @@
 Add the keyword
 <literallayout>/nocontour</literallayout>
-<para>
-    <figure id="fig_xxx_0902a">
+</para>
+<para>
+    <figure xml:id="fig_xxx_0902a">
       <title>Command text area</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0902a.png"/>
-	  </imageobject>
-    </figure>
-</para>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0902a.png"/>
+  </imageobject>
+      </mediaobject>
+    </figure>
 </para>
 </step>
@@ -800,9 +874,11 @@
 </para>
 <para>
-    <figure id="fig_xxx_0902">
+    <figure xml:id="fig_xxx_0902">
       <title>The fourth plot with the keyword "nocontour"</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0902.png"/>
-	  </imageobject>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0902.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -833,9 +909,11 @@
 </para>
 <para>
-    <figure id="fig_xxx_0903">
+    <figure xml:id="fig_xxx_0903">
       <title>Frame with five plot</title>
-	  <imageobject>
-	    <imagedata fileref="figpng/xxx_0903.png"/>
-	  </imageobject>
+      <mediaobject>
+  <imageobject>
+    <imagedata fileref="figpng/xxx_0903.png"/>
+  </imageobject>
+      </mediaobject>
     </figure>
 </para>
@@ -844,5 +922,5 @@
 </sect2>
 </sect1>
-<sect1 id="crash"><title>What should I do when it breakdown</title>
+<sect1 xml:id="crash"><title>What should I do when it breakdown</title>
 
 <para>
@@ -851,5 +929,5 @@
 <para>
 In the IDL window type (as many time you click on a button since a problem occurs in xxx !!!),
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>retall</userinput>
 </screen>
@@ -858,5 +936,5 @@
 <para>
 in the IDL window, type
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>domdef</userinput>
 </screen>
@@ -880,5 +958,5 @@
 overflow.
 To clean up this memory:
-  <screen format="linespecific">
+  <screen>
 <prompt>&promptidl;</prompt> <userinput>ptr_free, ptr_valid()</userinput>
 </screen>
Index: trunk/SRC/Documentation/xmldoc/savesaxo.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/savesaxo.sh	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/savesaxo.sh	(revision 345)
@@ -3,4 +3,7 @@
 # update :
 # $Id$
+# fplod 2008-04-16T09:02:45Z aedon.locean-ipsl.upmc.fr (Darwin)
+# html files produced from DocBook files are now produced using makefile
+# instead of makehtml.sh
 # fplod 2007-08-21T09:29:04Z aedon.locean-ipsl.upmc.fr (Darwin)
 # follow changes of calling sequence of pro2href.sh
@@ -101,6 +104,6 @@
 set -u
 #
-docompileall=1
-dohtml=0
+docompileall=0
+dohtml=1
 dooldtest=0
 doidlwavedoc=0
@@ -208,14 +211,7 @@
 #
     cd ${memopwd}
-    for docxml in firststeps.xml getsaxo.xml mailing.xml websaxo.xml tiplink.xml updatesaxo.xml whatissaxo.xml whatsnew.xml infoupdatekwd.xml infoupdatecm.xml mini_notice.xml faqsaxo.xml
-    do
-      ./makehtml.sh $(basename ${docxml} .xml)
-      status=${?}
-      if [ ${status} -ne 0 ]
-      then
-       echo "eee : pb with makehtml.sh $(basename ${docxml} .xml)"
-       exit 1
-      fi
-    done
+    make clean
+    make html 
+    make dbkcheck
 fi
 #------------------------------------------------------------------
@@ -523,5 +519,5 @@
     scp ${localtarbase}/SAXO_*.tar.gz ${lgforge}@forge.ipsl.jussieu.fr:/ipsl/forge/projets/saxo/download/
     echo "iii : do not forget to update getsaxo.html"
-    echo "iii : \$ ./makehtml.sh getsaxo"
+    echo "iii : \$ make ./getsaxo.html"
     echo "iii : do not forget to clean ${localtarbase}"
 fi
Index: trunk/SRC/Documentation/xmldoc/saxo_html.xsl
===================================================================
--- trunk/SRC/Documentation/xmldoc/saxo_html.xsl	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/saxo_html.xsl	(revision 345)
@@ -1,3 +1,6 @@
 <?xml version='1.0' encoding='ISO-8859-1'?> 
+<xsl:stylesheet
+version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <!--
 module :
@@ -14,14 +17,13 @@
 et mettre pubdate
 -->
-<xsl:stylesheet  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  version="1.0"> 
 
 <!-- if there is some trouble with network, you can replace the following line
 by this one on Mac
+-->
 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
+
+<!-- for Mac without network 
+<xsl:import href="/sw/share/xml/xsl/docbook-xsl/html/docbook.xsl"/>
 -->
-
-
-<xsl:import href="/sw/share/xml/xsl/docbook-xsl/html/docbook.xsl"/>
-<!--
 <xsl:output method="xml"
 encoding="utf-8"
@@ -30,5 +32,4 @@
 doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
 doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/>
--->
 
 <xsl:include href="titlepage.saxo.xsl"/>
Index: trunk/SRC/Documentation/xmldoc/tiplink.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/tiplink.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/tiplink.xml	(revision 345)
@@ -1,15 +1,14 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[]>
-<!--
--->
+<?xml version="1.0" encoding="iso-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en"
+xml:id="tiplink">
 
-<article>
 <title>Tips and Links</title>
-  <articleinfo>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -19,14 +18,20 @@
     <revhistory>
       <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+
+      <revision>
         <revnumber>0.0</revnumber>
         <date>May 2006</date>
         <revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
 
-<sect1 id="tips">
+<sect1 xml:id="tips">
   <title>Tips</title>
   <para>
@@ -34,36 +39,34 @@
     <itemizedlist>
       <listitem><simpara>
-	<ulink url="http://www.dfanning.com/misc_tips/cursor_on_mac.html">Using the Cursor Command on a Macintosh</ulink>
+	<link xl:href="http://www.dfanning.com/misc_tips/cursor_on_mac.html">Using the Cursor Command on a Macintosh</link>
       </simpara></listitem>
       <listitem><simpara>
-	<ulink url="http://www.dfanning.com/widget_tips/mousewheel.html">Using the Mouse Wheel in UNIX Widgets</ulink>
+	<link xl:href="http://www.dfanning.com/widget_tips/mousewheel.html">Using the Mouse Wheel in UNIX Widgets</link>
       </simpara></listitem>
     </itemizedlist>
   </para>
   <para>
-    More can been find on <ulink url="http://www.dfanning.com/documents/tips.html"/>
+    More can been find on <link xl:href="http://www.dfanning.com/documents/tips.html"/>
   </para>
 </sect1>
 
-<sect1 id="links">
+<sect1 xml:id="links">
   <title>Links</title>
   <para>
     <itemizedlist>
       <listitem><simpara>
-	<ulink url="http://www.dfanning.com/">David Fanning</ulink> web page
+	<link xl:href="http://www.dfanning.com/">David Fanning</link> web page
       </simpara></listitem>
       <listitem><simpara>
-	<ulink url="http://www.talkaboutprogramming.com/group/comp.lang.idl-pvwave/">IDL-PVWAVE news group</ulink>
+	<link xl:href="http://www.talkaboutprogramming.com/group/comp.lang.idl-pvwave/">IDL-PVWAVE news group</link>
       </simpara></listitem>
       <listitem><simpara>
-	<ulink url="http://www-atm.physics.ox.ac.uk/user/stoned/idl_lib/idl_lib.html">IDL routines from the University of Oxford Climate Dynamics Group</ulink>
+	<link xl:href="http://www-atm.physics.ox.ac.uk/user/stoned/idl_lib/idl_lib.html">IDL routines from the University of Oxford Climate Dynamics Group</link>
       </simpara></listitem>
       <listitem><simpara>
-	<ulink url="http://iacweb.ethz.ch/staff/dominik/hiphop/">Handy IDL-Program for HDF-Output Plotting from Dominik Brunner</ulink>
+	<link xl:href="http://iacweb.ethz.ch/staff/dominik/hiphop/">Handy IDL-Program for HDF-Output Plotting from Dominik Brunner</link>
       </simpara></listitem>
     </itemizedlist>
   </para>
 </sect1>
-
-
 </article>
Index: trunk/SRC/Documentation/xmldoc/updatesaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/updatesaxo.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/updatesaxo.xml	(revision 345)
@@ -1,18 +1,15 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
-]>
-<!--
--->
-<article lang="en">
-  <title>
-    Update <application>SAXO</application>
-  </title>
-  
-  <articleinfo>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en"
+xml:id="updatesaxo">
+
+  <title> Update <application>SAXO</application> </title>
+
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -22,25 +19,28 @@
     <revhistory>
       <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+      <revision>
 	<revnumber>0.0</revnumber>
 	<date>May 2006</date>
 	<revremark>First draft</revremark>
       </revision>
-    </revhistory>  
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
 
-    <sect1 id="saxo_local">
-      <title>
-	If you work at IDRIS, IPSL or LOCEAN
-      </title>
+    <sect1 xml:id="saxo_local">
+      <title> If you work at IDRIS, IPSL or LOCEAN </title>
       <para>
-	If you <ulink url="./getsaxo.html#saxo_local">linked</ulink> your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> to
+	If you <link xl:href="./getsaxo.html#saxo_local">linked</link> your <filename class="directory">${HOME}/SAXO_DIR</filename> to
 	<itemizedlist>
-	  <listitem><simpara>IDRIS, on rhodes: <filename class='directory'>/home/rech/eee/reee217/SAXO_DIR</filename></simpara></listitem>
-	  <listitem><simpara>IPSL: <filename class='directory'>/home/smlod/SAXO_DIR</filename></simpara></listitem>
-	  <listitem><simpara>LOCEAN: <filename class='directory'>/usr/home/smasson/SAXO_DIR</filename></simpara></listitem>
+	  <listitem><simpara>IDRIS, on rhodes: <filename class="directory">/home/rech/eee/reee217/SAXO_DIR</filename></simpara></listitem>
+	  <listitem><simpara>IPSL: <filename class="directory">/home/smlod/SAXO_DIR</filename></simpara></listitem>
+	  <listitem><simpara>LOCEAN: <filename class="directory">/usr/home/smasson/SAXO_DIR</filename></simpara></listitem>
 	</itemizedlist>
-	your are always using the up-to-date version of SAXO. There is nothing to do.
+	you are always using the up-to-date version of SAXO. There is nothing to do.
       </para>
     </sect1>
@@ -48,27 +48,25 @@
   <!--	2 -->
 
-    <sect1 id="saxo_svn">
-      <title>
-	If you got SAXO with <ulink url="./getsaxo.html#saxo_svn"><application> Subversion (svn)</application></ulink>
-      </title>
+    <sect1 xml:id="saxo_svn">
+      <title> If you got SAXO with <link xl:href="./getsaxo.html#saxo_svn"><application> Subversion (svn)</application></link> </title>
       <para>
-	You can check the status of your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> with the following command:
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename></parameter></userinput>
+	You can check the status of your <filename class="directory">${HOME}/SAXO_DIR</filename> with the following command:
+	<screen>
+  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <filename class="directory">${HOME}/SAXO_DIR</filename></userinput>
 	</screen>
-	Or, for example, if you only want to check the status of <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename> directory
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename></parameter></userinput>
+	Or, for example, if you only want to check the status of <filename class="directory">${HOME}/SAXO_DIR/SRC</filename> directory
+	<screen>
+  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <filename class="directory">${HOME}/SAXO_DIR/SRC</filename></userinput>
 	</screen>
-	You can update your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> with the following command:
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename></parameter></userinput>
+	You can update your <filename class="directory">${HOME}/SAXO_DIR</filename> with the following command:
+	<screen>
+  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <filename class="directory">${HOME}/SAXO_DIR</filename></userinput>
 	</screen>
-	Or, for example, if you only want to update <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename> directory
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename></parameter></userinput>
+	Or, for example, if you only want to update <filename class="directory">${HOME}/SAXO_DIR/SRC</filename> directory
+	<screen>
+  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <filename class="directory">${HOME}/SAXO_DIR/SRC</filename></userinput>
 	</screen>
 	For a quick help on <userinput>svn status</userinput> and <userinput>svn update</userinput> see
-	<screen format="linespecific">
+	<screen>
   <prompt>$</prompt> <userinput><command>svn</command> <option>help</option> <parameter>status</parameter></userinput>
   <prompt>$</prompt> <userinput><command>svn</command> <option>help</option> <parameter>update</parameter></userinput>
@@ -79,11 +77,9 @@
   <!--	3 -->
 
-    <sect1 id="saxo_tar">
-      <title>
-	If you got SAXO from a <ulink url="./getsaxo.html#saxo_src_tar">tar file</ulink>
-      </title>
+    <sect1 xml:id="saxo_tar">
+      <title> If you got SAXO from a <link xl:href="./getsaxo.html#saxo_src_tar">tar file</link> </title>
       <para>
-	The only way to update SAXO is to re-download and reinstall the tar file as you done for the <ulink url="./getsaxo.html#saxo_src_tar">first installation</ulink>.
-      </para>  
+	The only way to update SAXO is to re-download and reinstall the tar file as you done for the <link xl:href="./getsaxo.html#saxo_src_tar">first installation</link>.
+      </para>
     </sect1>
 
Index: trunk/SRC/Documentation/xmldoc/websaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/websaxo.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/websaxo.xml	(revision 345)
@@ -1,19 +1,32 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[
-<!ENTITY hellip	"&#x2026;">
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article [
+<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
+%isolat1;
+<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
+%isolat2;
+<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
+%isogrk3;
+<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
+%isopub;
+<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
+%isotech;
+<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
+%isonum;
 ]>
-<article>
-<!--
--->
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xmlns:xi="http://www.w3.org/2001/XInclude"
+xml:lang="en"
+xml:id="websaxo">
+
 <!--
  do not forget to modify WikiStart page if you modify this file
 -->
-<title>Main page of SAXO</title> 
-  <articleinfo>
+<title>Main page of SAXO</title>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -32,16 +45,22 @@
         <revremark>rename to websaxo; use whatissaxo</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+        <revnumber>0.2</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
   <note><para>
-This page is a mirror of <ulink url="http://forge.ipsl.jussieu.fr/saxo">SAXO web page</ulink> and allows you to browse SAXO help pages in local.
+This page is a mirror of <link xl:href="http://forge.ipsl.jussieu.fr/saxo">SAXO web page</link> and allows you to browse SAXO help pages in local.
   </para></note>
 
-<sect1 id="whatissaxo">
+<sect1 xml:id="whatissaxo">
 <title>What is SAXO</title>
 <xi:include href="./whatissaxo.xml"
-                 xpointer="whatissaxo_for_main" 
+                 xpointer="whatissaxo_for_main"
                  parse="xml"
       xmlns:xi="http://www.w3.org/2001/XInclude"/>
@@ -50,5 +69,5 @@
 
 <xi:include href="./whatissaxo.xml"
-                 xpointer="element(/article/sect[1]/p[1])" 
+                 xpointer="element(/article/sect[1]/p[1])"
                  parse="xml"
       xmlns:xi="http://www.w3.org/2001/XInclude"/>
@@ -56,15 +75,15 @@
 
 <para>
-<ulink url="./whatissaxo.html">More &hellip;</ulink> 
-</para>
-</sect1>
-
-
-<sect1 id="whatsnew">
+<link xl:href="./whatissaxo.html">More &hellip;</link>
+</para>
+</sect1>
+
+
+<sect1 xml:id="whatsnew">
 <title>What's new</title>
 <itemizedlist>
 <listitem><para>September 2006: One <emphasis role="bold">unique online_help</emphasis> for IDL and SAXO (requires IDL 6.2 or higher).</para></listitem>
 <listitem><para>Summer 2006: <emphasis role="bold">English translation</emphasis> of headers, add <emphasis role="bold">pltv</emphasis> and <emphasis role="bold">documentation of xxx</emphasis>.</para></listitem>
-<listitem> 
+<listitem>
 <para>
 March 2006-May 2006 : migration of <emphasis role="bold">obsolete</emphasis> CVS repository + Sébastien Masson improvements in a beautiful <quote><application>trac</application>+<application>svn</application></quote> project.
@@ -73,5 +92,5 @@
 <listitem>
 <para>
-More details in <ulink url="./whatsnew.html">What's new in SAXO</ulink>
+More details in <link xl:href="./whatsnew.html">What's new in SAXO</link>
 </para>
 </listitem>
@@ -80,5 +99,5 @@
 
 
-<sect1 id="getsaxo">
+<sect1 xml:id="getsaxo">
 <title>
 Get SAXO
@@ -86,31 +105,31 @@
 <itemizedlist>
 <listitem><para>
-<ulink url="./getsaxo.html">Get</ulink> SAXO
+<link xl:href="./getsaxo.html">Get</link> SAXO
 </para></listitem>
 <listitem><para>
-<ulink url="./updatesaxo.html">Update</ulink> SAXO
+<link xl:href="./updatesaxo.html">Update</link> SAXO
 </para></listitem>
 <listitem><para>
-<ulink url="http://forge.ipsl.jussieu.fr/saxo/browser/trunk">Browse</ulink> SAXO
+<link xl:href="http://forge.ipsl.jussieu.fr/saxo/browser/trunk">Browse</link> SAXO
 </para></listitem>
 </itemizedlist>
 </sect1>
 
-<sect1 id="support">
+<sect1 xml:id="support">
 <title>Support</title>
 <itemizedlist>
 <listitem>
 <para>
-You like SAXO? Please subscribe to SAXO <ulink url="./mailing.html">mailing lists</ulink> (subscription and archives).
-</para>
-</listitem>
-<listitem>
-<para>
-<ulink url="http://forge.ipsl.jussieu.fr/saxo/report">Read</ulink> tickets. Because of abusive use of our tickets, <ulink url="http://forge.ipsl.jussieu.fr/saxo/newticket">sending tickets</ulink> is now limited to a registered login accessible if you subscribe to <ulink url="./mailing.html">SAXO mailing lists</ulink>.
-</para>
-</listitem>
-<listitem>
-<para>
-<ulink url="./faqsaxo.html">FAQ</ulink>
+You like SAXO? Please subscribe to SAXO <link xl:href="./mailing.html">mailing lists</link> (subscription and archives).
+</para>
+</listitem>
+<listitem>
+<para>
+<link xl:href="http://forge.ipsl.jussieu.fr/saxo/report">Read</link> tickets. Because of abusive use of our tickets, <link xl:href="http://forge.ipsl.jussieu.fr/saxo/newticket">sending tickets</link> is now limited to a registered login accessible if you subscribe to <link xl:href="./mailing.html">SAXO mailing lists</link>.
+</para>
+</listitem>
+<listitem>
+<para>
+<link xl:href="./faqsaxo.html">FAQ</link>
 </para>
 </listitem>
@@ -119,25 +138,25 @@
 
 
-<sect1 id="documentation">
+<sect1 xml:id="documentation">
 <title>Documentation</title>
 <para>
-<ulink url="./firststeps.html">First Steps</ulink> with SAXO. See also plots of First Steps in <ulink url="./all_plots.html">All plots</ulink>
-</para>
-<para>
-A short overview and <ulink url="./mini_notice.html">documentation of xxx widget</ulink> is now available.
-</para>
-<para>
-A complete and convenient description of all SAXO routines can be found in the <ulink url="../idldoc_html_output/index.html">web pages created by <application>IDLdoc</application></ulink>.
-</para>
-<para>
-Some useful <ulink url="./tiplink.html">Tips and links</ulink>.
-</para>
-</sect1>
-<sect1 id="saxoteam">
+<link xl:href="./firststeps.html">First Steps</link> with SAXO. See also plots of First Steps in <link xl:href="./all_plots.html">All plots</link>
+</para>
+<para>
+A short overview and <link xl:href="./mini_notice.html">documentation of xxx widget</link> is now available.
+</para>
+<para>
+A complete and convenient description of all SAXO routines can be found in the <link xl:href="../idldoc_html_output/index.html">web pages created by <application>IDLdoc</application></link>.
+</para>
+<para>
+Some useful <link xl:href="./tiplink.html">Tips and links</link>.
+</para>
+</sect1>
+<sect1 xml:id="saxoteam">
 <title>SAXO team</title>
 <variablelist>
 <varlistentry>
 <term>
-Sébastien Masson 
+Sébastien Masson
 </term>
 <listitem>
@@ -173,5 +192,5 @@
 <listitem>
 <simpara>
-<ulink url="http://forge.ipsl.jussieu.fr/">IPSL forge</ulink> maintainer
+<link xl:href="http://forge.ipsl.jussieu.fr/">IPSL forge</link> maintainer
 </simpara>
 </listitem>
Index: trunk/SRC/Documentation/xmldoc/whatissaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/whatissaxo.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/whatissaxo.xml	(revision 345)
@@ -1,16 +1,26 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
-<!ENTITY hellip	"&#x2026;">
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article [
+<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
+%isolat1;
+<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
+%isolat2;
+<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
+%isogrk3;
+<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
+%isopub;
+<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
+%isotech;
+<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
+%isonum;
 ]>
-<!--
--->
-<article>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en">
 <title>What is SAXO</title>
-  <articleinfo>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -29,27 +39,32 @@
         <revremark>add introduction (previously in main.xml)</revremark>
       </revision>
+      <revision>
+        <revnumber>0.1</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
     </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
-<sect1 id="whatissaxo">
+<sect1 xml:id="whatissaxo">
 <title>What is SAXO</title>
-<para id="whatissaxo_for_main">
+<para xml:id="whatissaxo_for_main">
 SAXO is a package (~400 routines, ~60 000 code lines) used to easily and quickly visualize and analyze models outputs or data observations.
-It is based on <ulink url="http://www.ittvis.com/idl/"><trademark>IDL</trademark></ulink> and contains a Graphic User Interface.
-Developed in collaboration with <ulink url="http://www.locean-ipsl.upmc.fr/">LOCEAN</ulink> researchers, it allows to explore four dimension data which may be gridded or irregularly spaced.
-It is particularly adapted to the "Arakawa C grid" discretization used in <ulink url="http://www.locean-ipsl.upmc.fr/NEMO/">NEMO</ulink>.
+It is based on <link xl:href="http://www.ittvis.com/idl/"><trademark>IDL</trademark></link> and contains a Graphic User Interface.
+Developed in collaboration with <link xl:href="http://www.locean-ipsl.upmc.fr/">LOCEAN</link> researchers, it allows to explore four dimension data which may be gridded or irregularly spaced.
+It is particularly adapted to the <quote>Arakawa C grid</quote> discretization used in <link xl:href="http://www.locean-ipsl.upmc.fr/NEMO/">NEMO</link>.
 In addition to graphical procedures, interpolation modules and other things &hellip;, it contains a set of programs dedicated to oceanographic diagnostics.
 </para>
 </sect1>
 
-<sect1 id="prerequisites">
+<sect1 xml:id="prerequisites">
   <title>Prerequisites</title>
   <para>
-    <application>SAXO</application> needs at least <ulink url="http://www.ittvis.com/idl/"><trademark>IDL</trademark></ulink> 6.0.
+    <application>SAXO</application> needs at least <link xl:href="http://www.ittvis.com/idl/"><trademark>IDL</trademark></link> 6.0.
   </para>
-  <para>
-    <remark><application>SAXO</application> can be used with the 7 minutes demo-mode (within the limitations of this mode: impossible to save data and create a file).</remark>
-  </para>
+  <note>
+    <para><application>SAXO</application> can be used with the 7 minutes demo-mode (within the limitations of this mode: impossible to save data and create a file).</para>
+  </note>
   <!-- ++un jour peut-être
 <para>
@@ -58,5 +73,5 @@
   -->
 </sect1>
-<sect1 id="include">
+<sect1 xml:id="include">
   <title>Include</title>
   <para>
@@ -64,25 +79,25 @@
       <listitem><simpara>
 	<application>idl-NetCDF</application> written and maintained by Alan Iwi
-	<ulink url="http://www.ittvis.com/codebank/search.asp?FID=261"/>
+	<link xl:href="http://www.ittvis.com/codebank/search.asp?FID=261"/>
       </simpara></listitem>
       <listitem><simpara>
 	<application>IDLdoc</application> written and maintained by Mike Galloy
-	<ulink url="http://www.ittvis.com/codebank/search.asp?FID=100"/>
+	<link xl:href="http://www.ittvis.com/codebank/search.asp?FID=100"/>
       </simpara></listitem>
       <listitem><simpara>
 	<application>color24</application>, <application>colorbar</application>, <application>getcolor</application>, <application>binary</application>, <application>different</application>, <application>inter</application>, <application>union</application>, <application>str_size</application> and <application>undefine</application> written and maintained by David Fanning
-	<ulink url="http://www.dfanning.com"/>
+	<link xl:href="http://www.dfanning.com"/>
       </simpara></listitem>
       <listitem><simpara>
 	<application>delchr</application>, <application>getfile</application>, <application>getwrd</application>, <application>isnumber</application>, <application>nwrds</application> and <application>putfile</application> written and maintained by R. Sterner in JHU/APL/S1R IDL Library
-	<ulink url="http://fermi.jhuapl.edu/s1r/idl/s1rlib/local_idl.html"/>
+	<link xl:href="http://fermi.jhuapl.edu/s1r/idl/s1rlib/local_idl.html"/>
       </simpara></listitem>
       <listitem><simpara>
 	<application>cmapply</application> and <application>cmset_op</application> written and maintained by Craig Markwardt
-	<ulink url="http://cow.physics.wisc.edu/~craigm/idl/"/>
+	<link xl:href="http://cow.physics.wisc.edu/~craigm/idl/"/>
       </simpara></listitem>
       <listitem><simpara>
 	<application>imdisp</application>, <application>saveimage</application> and <application>showimage</application> written and maintained by Liam E. Gumley
-	<ulink url="http://cimss.ssec.wisc.edu/~gumley/"/>
+	<link xl:href="http://cimss.ssec.wisc.edu/~gumley/"/>
       </simpara></listitem>
       <listitem><simpara>
Index: trunk/SRC/Documentation/xmldoc/whatsnew.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/whatsnew.xml	(revision 344)
+++ trunk/SRC/Documentation/xmldoc/whatsnew.xml	(revision 345)
@@ -1,14 +1,14 @@
-<?xml version='1.0' encoding='iso-8859-1'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
-[]>
-<!--
--->
-<article>
-<title>What's new in SAXO</title> 
-  <articleinfo>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<article version="5.0"
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xl="http://www.w3.org/1999/xlink"
+xml:lang="en"
+xml:id="whatsnew">
+
+<title>What's new in SAXO</title>
+  <info>
     <authorgroup>
-      <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
-      <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author>
+      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author>
     </authorgroup>
     <keywordset>
@@ -27,11 +27,16 @@
         <revremark>add date according to output of svn log</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+        <revnumber>0.2</revnumber>
+        <date>April 2008</date>
+        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark>
+      </revision>
+    </revhistory>
     <pubdate>$Id$</pubdate>
-  </articleinfo>
+  </info>
 
-<!-- dans les page trac <ulink url="../changeset/69"> equivalent de [changeset:69] dans la syntaxe TracWiki -->
+<!-- dans les page trac <link xl:href="../changeset/69"> equivalent de [changeset:69] dans la syntaxe TracWiki -->
 
-<sect1 id="intro">
+<sect1 xml:id="intro">
 <title>Introduction</title>
 <para>
@@ -43,5 +48,5 @@
 </sect1>
 
-<sect1 id="changeset175">
+<sect1 xml:id="changeset175">
 <title>Changeset 175 (2006-09-13)</title>
 <para>
@@ -49,9 +54,9 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/175">Changeset 175</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/175">Changeset 175</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset174">
+<sect1 xml:id="changeset174">
 <title>Changeset 172-174 (2006-09-11/12)</title>
 <para>
@@ -59,39 +64,39 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/172">Changeset 172</ulink>, <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/173">Changeset 173</ulink>, <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/174">Changeset 174</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/172">Changeset 172</link>, <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/173">Changeset 173</link>, <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/174">Changeset 174</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset163">
+<sect1 xml:id="changeset163">
 <title>Changeset 163 (2006-08-29)</title>
 <para>
-Last major commit related to the English translation of headers and their format. Better <ulink url="../idldoc_html_output/index.html">idldoc HTML documentation</ulink> and introduce SAXO online_help created by idldoc assistant.
+Last major commit related to the English translation of headers and their format. Better <link xl:href="../idldoc_html_output/index.html">idldoc HTML documentation</link> and introduce SAXO online_help created by xml:idldoc assistant.
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/163">Changeset 163</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/163">Changeset 163</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset152">
+<sect1 xml:id="changeset152">
 <title>Changeset 152 (2006-08-10)</title>
 <para>
-This revision includes new <ulink type="text" url="../../ToBeReviewed/PLOTS/DESSINE/pltv.pro">pltv</ulink> (a mix between plt and tvplus) plotting procedure.
+This revision includes new <link xl:href="../../ToBeReviewed/PLOTS/DESSINE/pltv.pro">pltv</link> (a mix between <command>plt</command> and <command>tvplus</command>) plotting procedure.
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/152">Changeset 152</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/152">Changeset 152</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset114">
+<sect1 xml:id="changeset114">
 <title>Changeset 114 (2006-06-19)</title>
 <para>
-This revision includes new compilation options (compile_opt idl2, strictarrsubs) in each routine and new interpolation routine from irregular grid (originally introduced in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/110">Changeset 110</ulink>).
+This revision includes new compilation options (compile_opt idl2, strictarrsubs) in each routine and new interpolation routine from irregular grid (originally introduced in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/110">Changeset 110</link>).
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/114">Changeset 114</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/114">Changeset 114</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset73">
+<sect1 xml:id="changeset73">
 <title>Changeset 73 (2006-05-22)</title>
 <para>
@@ -99,9 +104,9 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/71">Changeset 71</ulink>, <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/72">Changeset 72</ulink> and <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/73">Changeset 73</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/71">Changeset 71</link>, <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/72">Changeset 72</link> and <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/73">Changeset 73</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset69">
+<sect1 xml:id="changeset69">
 <title>Changeset 69 (2006-05-11)</title>
 <para>
@@ -109,9 +114,9 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/69">Changeset 69</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/69">Changeset 69</link>.
 </para>
 </sect1>
 
-<sect1 id="chgangeset68">
+<sect1 xml:id="chgangeset68">
 <title>Changeset 68 (2006-05-09)</title>
 <para>
@@ -119,13 +124,13 @@
 </para>
 <para>
-See <ulink url="./infoupdatekwd.html">Keywords translation</ulink>
-and <ulink url="./infoupdatecm.html">Commons translation</ulink>.
+See <link xl:href="./infoupdatekwd.html">Keywords translation</link>
+and <link xl:href="./infoupdatecm.html">Commons translation</link>.
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/68">Changeset 68</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/68">Changeset 68</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset7">
+<sect1 xml:id="changeset7">
 <title>Changeset 7 (2006-04-24)</title>
 <para>
@@ -133,9 +138,9 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/7">Changeset 7</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/7">Changeset 7</link>.
 </para>
 </sect1>
 
-<sect1 id="changeset2">
+<sect1 xml:id="changeset2">
 <title>Changeset 2 (revision date=2002-09-11 actually done 2006-04-13)</title>
 <para>
@@ -143,5 +148,5 @@
 </para>
 <para>
-Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/2">Changeset 2</ulink>.
+Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/2">Changeset 2</link>.
 </para>
 </sect1>
