Changeset 345 for trunk


Ignore:
Timestamp:
04/16/08 11:15:20 (16 years ago)
Author:
pinsard
Message:

migration from DocBook? 4 to Docbook 5 : sources and production tools

Location:
trunk/SRC/Documentation/xmldoc
Files:
1 added
17 edited
2 copied

Legend:

Unmodified
Added
Removed
  • trunk/SRC/Documentation/xmldoc/all_plots_docbook.xsl

    r191 r345  
    1 <?xml version="1.0" encoding="iso-8859-1" ?> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<xsl:stylesheet 
     3version="1.0" 
     4xmlns:dbk="http://docbook.org/ns/docbook" 
     5xmlns:xl="http://www.w3.org/1999/xlink" 
     6xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 
    27<!-- 
    3 module :  
     8module : 
    49generation of a docbook file for display all plots of firtsteps.xml 
    510 
     
    813 
    914update : 
     15fplod 2008-04-15T12:40:25Z aedon.locean-ipsl.upmc.fr (Darwin) 
     16adaptation to docbook 5 in and out 
    1017fplod 2006-05-17T09:59:52Z aedon.lodyc.jussieu.fr (Darwin) 
    1118fplod 2006-09-21T14:58:05Z aedon.locean-ipsl.upmc.fr (Darwin) 
     
    1320--> 
    1421 
    15 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 
    1622 
    17 <xsl:output  
    18  method="xml"  
    19  indent="yes"  
    20  encoding="iso-8859-1" 
    21  omit-xml-declaration="no" 
    22  doctype-public="-//OASIS//DTD DocBook XML V4.2//EN" 
    23  doctype-system="http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"/> 
     23<xsl:output 
     24 method="xml" 
     25 indent="yes" 
     26 omit-xml-declaration="no"/> 
    2427 
    25  <xsl:template match="article">  
    26   <article id="all_plots" lang="en"> 
     28<xsl:template match="/"> 
     29 <xsl:element name="article"> 
     30 <xsl:attribute name="version">5.0</xsl:attribute> 
     31 <xsl:attribute name="xmlns">http://docbook.org/ns/docbook</xsl:attribute> 
     32 <xsl:attribute name="xml:lang">en</xsl:attribute> 
     33 <xsl:attribute name="xml:id">all_plots</xsl:attribute> 
     34 
    2735  <title>All plots of SAXO demo</title> 
    28     <articleinfo> 
     36    <info> 
    2937    <authorgroup> 
    30       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>smasson_at_lodyc.jussieu.fr</email></author> 
    31       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_lodyc.jussieu.fr</email></author> 
     38      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>smasson_at_lodyc.jussieu.fr</email></author> 
     39      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_lodyc.jussieu.fr</email></author> 
    3240    </authorgroup> 
    3341    <keywordset> 
     
    3543      <keyword>SAXO</keyword> 
    3644    </keywordset> 
    37     </articleinfo> 
    38     <sect1 id="intro"> 
     45    </info> 
     46    <sect1 xml:id="intro"> 
    3947    <title>Introduction</title> 
    4048    <para> 
    41       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. 
     49      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. 
    4250    </para> 
    4351    </sect1> 
    44     <sect1 id="allplots"> 
     52    <sect1 xml:id="allplots"> 
    4553    <title>All plots</title> 
     54     <xsl:element name="itemizedlist"> 
    4655 
    47 <!-- for all ulink where url is something .png 
    48 plot it with the title of the closest ancestor which have an id attibutes 
     56<!-- for all links where xl:href is something .png 
     57plot it with the title of the closest ancestor which have an xml:id attribute 
    4958--> 
    50 <xsl:for-each select="self::node()/descendant-or-self::node()/child::ulink[contains(@url,'png')]"> 
    51   <xsl:sort order="ascending" data-type="text" select="@url"/> 
     59<!-- version dbk 4 pour mémoire 
     60<xsl:for-each select="self::node()/descendant-or-self::node()/child::link[contains(@xl:href,'png')]"> 
     61--> 
     62<xsl:for-each select="//dbk:link[contains(@xl:href,'png')]"> 
     63  <xsl:sort order="ascending" data-type="text" select="@xl:href"/> 
    5264  <xsl:call-template name="plot"> 
    53       <xsl:with-param name="url" select="@url"/> 
    54       <xsl:with-param name="id" select="(ancestor-or-self::node()/@id)[last()]"/> 
    55       <xsl:with-param name="title" select="(ancestor-or-self::node()/title)[last()]"/> 
     65      <xsl:with-param name="href" select="@xl:href"/> 
     66      <xsl:with-param name="id" select="(ancestor-or-self::node()/@xml:id)[last()]"/> 
     67      <xsl:with-param name="title" select="(ancestor-or-self::node()/dbk:title)[last()]"/> 
    5668  </xsl:call-template> 
    5769</xsl:for-each> 
     70   </xsl:element> 
    5871  </sect1> 
    59   </article> 
    60  </xsl:template>  
     72  </xsl:element> 
     73</xsl:template> 
    6174 
    62     <xsl:template name="plot">  
    63         <xsl:param name="url"/>   
    64         <xsl:param name="id"/>   
    65         <xsl:param name="title"/>   
    66         <xsl:element name="para"> 
    67         <xsl:element name="mediaobject"> 
     75    <xsl:template name="plot"> 
     76        <xsl:param name="href"/> 
     77        <xsl:param name="id"/> 
     78        <xsl:param name="title"/> 
     79        <xsl:element name="listitem"> 
     80         <xsl:element name="para"> 
     81          [plot <xsl:value-of select="$href"/>] 
     82         </xsl:element>  
     83         <xsl:element name="para"> 
     84          <xsl:element name="mediaobject"> 
    6885            <xsl:element name="imageobject"> 
    6986                <xsl:element name="imagedata"> 
    70                     <xsl:attribute name="fileref"><xsl:value-of select="$url"/></xsl:attribute> 
     87                    <xsl:attribute name="fileref"><xsl:value-of select="$href"/></xsl:attribute> 
    7188                    <xsl:attribute name="format">PNG</xsl:attribute> 
    7289                    <xsl:attribute name="valign">top</xsl:attribute> 
    7390                </xsl:element> 
    7491            </xsl:element> 
     92            <xsl:element name="textobject"> 
     93             <xsl:element name="phrase"> 
     94              [plot <xsl:value-of select="$href"/>] 
     95             </xsl:element> 
     96            </xsl:element> 
     97            <xsl:element name="caption"> 
     98             <xsl:element name="para"> 
     99              cf.  
     100              <xsl:element name="link"> 
     101               <xsl:attribute name="xl:href">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute> 
     102                <xsl:value-of select="$title"/> 
     103              </xsl:element> 
     104              <xsl:text> in </xsl:text><xsl:value-of select="//dbk:title"/> 
     105             </xsl:element> 
     106            </xsl:element> 
     107           </xsl:element> 
     108          </xsl:element> 
    75109        </xsl:element> 
    76         <xsl:element name="textobject"> 
    77             <xsl:element name="phrase"> 
    78                 [plot <xsl:value-of select="$url"/>] 
    79             </xsl:element> 
    80         </xsl:element> 
    81         <xsl:element name="caption"> 
    82             <xsl:element name="para"> 
    83             cf. <xsl:element name="ulink"> 
    84 <!-- 
    85                     <xsl:attribute name="url">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute> 
    86 --> 
    87                     <xsl:attribute name="url">firststeps.html#<xsl:value-of select="$id"/></xsl:attribute> 
    88                 <xsl:value-of select="$title"/> 
    89                 </xsl:element> 
    90                 <xsl:text>in First steps with SAXO</xsl:text> <!--++ récupérer le titre de l'article --> 
    91             </xsl:element> 
    92         </xsl:element> 
    93         </xsl:element> 
    94     </xsl:template>  
     110    </xsl:template> 
    95111 
    96112</xsl:stylesheet> 
  • trunk/SRC/Documentation/xmldoc/doidldoc.sh

    r327 r345  
    66# update : 
    77# $Id$ 
     8# fplod 2008-01-10T08:13:41Z aedon.locean-ipsl.upmc.fr (Darwin) 
     9# version  
     10# http://cookbook.idldev.com/idldoc-3.0rc2.zip 
     11# fplod 2008-01-03T09:59:18Z aedon.locean-ipsl.upmc.fr (Darwin) 
     12# version  
     13# http://cookbook.idldev.com/idldoc-3.0rc1.zip 
    814# fplod 2007-12-12T09:47:04Z aedon.locean-ipsl.upmc.fr (Darwin) 
    915# version 
     
    4248root="../../" 
    4349root="/Users/fplod/SAXO_DIR_ws/SRC/" #++ à cause du cd pour éviter expand_path 
     50# ++ pb avec /Users/fplod/SAXO_DIR_ws/SRC/ToBeReviewed/UTILITAIRE/oups.pro ELEMENTS ... à cause de todo 
    4451#root="/usr/home/fplod/src/mglib/" # overriding root for test ++ 
    4552# 
     
    4956#idldoc_dir="/usr/home/fplod/src/idldoc-3.0b4-src/" # overriding idldoc_dir for test ++ 
    5057idldoc_dir="/usr/home/fplod/src/idldoc-3.0b4/" # overriding idldoc_dir for test ++ 
     58idldoc_dir="/usr/home/fplod/src/idldoc-3.0rc2/" # overriding idldoc_dir for test ++ 
    5159template_location=${idldoc_dir}/templates/ 
    5260#++ pas fini  
    53 #template_location=${idldoc_dir}/templates_dbk/ # overriding TEMPLATE_LOCATION++ 
     61template_location=${idldoc_dir}/templates_dbk/ # overriding TEMPLATE_LOCATION++ 
     62template_location=/usr/home/fplod/src/idldoc-3.0b3/templates_dbk/ # overriding TEMPLATE_LOCATION++ 
    5463# 
    5564# memorize current directory 
     
    6574 
    6675#+++ a remettre pour dbk template_location="${template_location}", $ 
     76#++MARKUP_STYLE="verbatim", $ 
    6777# !path = expand_path('+' + '${idldoc_dir}') 
    6878cd ${idldoc_dir} 
     
    7181cat <<EOF > ${pro} 
    7282idldoc,root="${root}",title="${title}", $ 
     83CHARSET="ISO-8859-15", $ 
    7384LOG_FILE="${log}", $ 
    7485output="${outputtmp}", $ 
     86template_prefix="dbk", $ 
    7587template_location="${template_location}", $ 
    76 COMMENT_STYLE="latex", $ 
    77 overview="../../overview", /statistics 
     88overview="../../overview", /statistics, $ 
     89COMMENT_STYLE="assistant" 
    7890exit 
    7991EOF 
  • trunk/SRC/Documentation/xmldoc/faqsaxo.xml

    r294 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<!DOCTYPE article [ 
    53<!ENTITY promptidl "idl&gt;"> 
    64]> 
    7 <article> 
     5 
     6<article version="5.0" 
     7xmlns="http://docbook.org/ns/docbook" 
     8xmlns:xl="http://www.w3.org/1999/xlink" 
     9xml:lang="en" 
     10xml:id="faqsaxo"> 
     11 
    812<!-- 
    913en s'inspirant de 
     
    2125--> 
    2226<title>Frequently Asked questions about SAXO</title> 
    23   <articleinfo> 
     27  <info> 
    2428    <authorgroup> 
    25       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    26       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     29      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     30      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    2731    </authorgroup> 
    2832    <keywordset> 
     
    4246        <revremark>+ onlinehelp</revremark> 
    4347      </revision> 
     48      <revision> 
     49        <revnumber>0.2</revnumber> 
     50        <date>April 2008</date> 
     51        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     52      </revision> 
    4453    </revhistory> 
    4554    <pubdate>$Id$</pubdate> 
    46   </articleinfo> 
     55  </info> 
    4756 
    4857<qandaset> 
    49 <qandadiv id="intro"> 
    50 <title>Introduction</title> 
    5158<para> 
    5259This is a list of Frequently Asked Questions about SAXO. 
     
    5966Suggestions for corrections or additional sections are welcome -- please email them to <email>saxo-dev@forge.ipsl.jussieu.fr</email>. 
    6067</para> 
    61 </qandadiv> 
    62 <qandadiv id="general"> 
     68<qandadiv xml:id="general"> 
    6369<title>General</title> 
    6470<qandaentry> 
     
    7076<answer> 
    7177<para> 
    72 see document <ulink url="./whatissaxo.html">What is SAXO</ulink>. 
     78see document <link xl:href="./whatissaxo.html">What is SAXO</link>. 
    7379</para> 
    7480</answer> 
     
    8288<answer> 
    8389<para> 
    84 see Support in document <ulink url="./websaxo.html">Main page of SAXO</ulink>. 
     90see Support in document <link xl:href="./websaxo.html">Main page of SAXO</link>. 
    8591</para> 
    8692</answer> 
     
    94100<answer> 
    95101<para> 
    96 see document <ulink url="./getsaxo.html">Get SAXO</ulink>. 
     102see document <link xl:href="./getsaxo.html">Get SAXO</link>. 
    97103</para> 
    98104</answer> 
     
    167173</qandaentry> 
    168174</qandadiv> 
    169 <qandadiv id="technical"> 
     175<qandadiv xml:id="technical"> 
    170176<title>Technical questions</title> 
    171177<qandaentry> 
     
    177183<answer> 
    178184<para> 
    179 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: 
     185Yes, 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: 
    180186     <screen> 
    181187       <prompt>&promptidl;</prompt> <userinput><command>?</command></userinput> 
     
    185191</qandaentry> 
    186192</qandadiv> 
    187 <qandadiv id="Contributors"> 
     193<qandadiv xml:id="Contributors"> 
    188194<title>Contributors</title> 
    189195<qandaentry> 
     
    195201<answer> 
    196202<para> 
    197 There is a template for header <ulink url="../new_header.txt">new_header.txt</ulink> 
     203There is a template for header <link xl:href="../new_header.txt">new_header.txt</link> 
    198204which can be parsed by <application>IDLdoc</application>. 
    199205</para> 
     
    277283There is one way with command line : 
    278284     <screen> 
    279        <prompt>$</prompt> <userinput><command>aspell</command> <option>--mode=sgml</option> <option>-c</option> <parameter><filename><replaceable>xmlfile</replaceable></filename></parameter></userinput> 
     285       <prompt>$</prompt> <userinput><command>aspell</command> <option>--mode=sgml</option> <option>-c</option> <filename><replaceable>xmlfile</replaceable></filename></userinput> 
    280286     </screen> 
    281287</para> 
     
    292298Not so easy but you can start with something like this : 
    293299     <screen> 
    294        <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR/SRC</parameter></userinput> 
     300       <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">${HOME}/SAXO_DIR/SRC/</filename></userinput> 
    295301       <prompt>$</prompt> <userinput>list=$(find . -name "*.pro")</userinput> 
    296302       <prompt>$</prompt> <userinput>for file in ${list}; do aspell list &lt; ${file}; done > /tmp/list_word </userinput> 
  • trunk/SRC/Documentation/xmldoc/firststeps.xml

    r291 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
    5 <!ENTITY hellip "&#x2026;"> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<!DOCTYPE article [ 
     3<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent"> 
     4%isolat1; 
     5<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent"> 
     6%isolat2; 
     7<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent"> 
     8%isogrk3; 
     9<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> 
     10%isopub; 
     11<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent"> 
     12%isotech; 
     13<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent"> 
     14%isonum; 
    615<!ENTITY promptidl "idl&gt;"> 
    716<!ENTITY numb1 '<inlinemediaobject><imageobject><imagedata fileref="images/callouts/1.png" format="PNG"/></imageobject><textobject><phrase>1</phrase></textobject></inlinemediaobject>'> 
     
    918<!ENTITY showfig '<inlinemediaobject><imageobject><imagedata fileref="images/showfig.png" format="PNG"/></imageobject><textobject><phrase>show result</phrase></textobject></inlinemediaobject>'> 
    1019]> 
     20 
     21<article version="5.0" 
     22xmlns="http://docbook.org/ns/docbook" 
     23xmlns:xl="http://www.w3.org/1999/xlink" 
     24xmlns:xi="http://www.w3.org/2001/XInclude" 
     25xml:lang="en" 
     26xml:id="firststeps"> 
    1127 
    1228<!-- 
     
    2743 
    2844--> 
    29 <article lang="en"> 
    30   <title> 
    31     First steps with <application>SAXO</application> 
    32   </title> 
    33  
    34   <articleinfo> 
     45  <title> First steps with <application>SAXO</application> </title> 
     46 
     47  <info> 
    3548    <authorgroup> 
    36       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    37       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     49      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     50      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    3851    </authorgroup> 
    3952    <keywordset> 
     
    4356    <revhistory> 
    4457      <revision> 
    45         <revnumber>0.0</revnumber> 
    46         <date>29 July 2005</date> 
    47         <revremark>First draft</revremark> 
     58<revnumber>0.0</revnumber> 
     59<date>29 July 2005</date> 
     60<revremark>First draft</revremark> 
    4861      </revision> 
    4962      <revision> 
    50         <revnumber>0.1</revnumber> 
    51         <date>29 August 2005</date> 
    52         <revremark>last Japanese version!</revremark> 
     63<revnumber>0.1</revnumber> 
     64<date>29 August 2005</date> 
     65<revremark>last Japanese version!</revremark> 
    5366      </revision> 
    5467      <revision> 
    55         <revnumber>0.2</revnumber> 
    56         <date>May 2006</date> 
    57         <revremark>split with getsaxo</revremark> 
     68<revnumber>0.2</revnumber> 
     69<date>May 2006</date> 
     70<revremark>split with getsaxo</revremark> 
    5871      </revision> 
     72      <revision> 
     73        <revnumber>0.3</revnumber> 
     74        <date>April 2008</date> 
     75        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     76      </revision> 
     77 
    5978     </revhistory> 
    6079     <pubdate>$Id$</pubdate> 
    61   </articleinfo> 
    62 <sect1 id="beforefirststeps"> 
     80  </info> 
     81<sect1 xml:id="beforefirststeps"> 
    6382<title>Before this</title> 
    6483<para> 
    65 In this document, we supposed that you followed <ulink url="./getsaxo.html">Get SAXO</ulink> recommendations. 
     84In this document, we supposed that you followed <link xl:href="./getsaxo.html">Get SAXO</link> recommendations. 
    6685</para> 
    6786</sect1> 
    6887 
    69   <sect1 id="first_plots"> 
    70     <title> 
    71       First plots &hellip; 
    72     </title> 
    73     <sect2 id="start_with_init"> 
    74       <title> 
    75         Start IDL session: <userinput><command>@init</command></userinput> 
    76       </title> 
    77       <para> 
    78         Each IDL session using <application>SAXO</application> must always start with: <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>. 
    79       </para> 
    80       <para> 
    81         <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> 
    82         <screen format="linespecific"> 
    83   <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory"><envar>${HOME}</envar>/My_IDL/</filename></userinput> 
     88  <sect1 xml:id="first_plots"> 
     89    <title> First plots &hellip; </title> 
     90    <sect2 xml:id="start_with_init"> 
     91      <title> Start IDL session: <userinput><command>@init</command></userinput> </title> 
     92      <para> 
     93Each IDL session using <application>SAXO</application> must always start with: <prompt>&promptidl;</prompt> <userinput><command>@init</command></userinput>. 
     94      </para> 
     95      <para> 
     96<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> 
     97<screen> 
     98  <prompt>$</prompt> <userinput><command>cd</command> <filename class="directory">${HOME}/My_IDL/</filename></userinput> 
    8499  <prompt>$</prompt> <userinput><command>idl</command></userinput> 
    85100  <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput> 
     
    102117  <computeroutput>% Compiled module: LOADCT.</computeroutput> 
    103118  <prompt>&promptidl;</prompt> 
    104         </screen> 
    105         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: 
     119</screen> 
     120As 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: 
    106121      <variablelist> 
    107         <varlistentry><term><command>csh</command></term> 
    108         <listitem><screen><prompt>$</prompt> <userinput><command>setenv</command> <envar>IDL_STARTUP</envar> <filename><envar>${HOME}</envar>/My_IDL/init.pro</filename></userinput></screen></listitem> 
    109         </varlistentry> 
    110         <varlistentry><term><command>ksh</command></term> 
    111         <listitem><screen><prompt>$</prompt> <userinput><command>export</command> <envar>IDL_STARTUP</envar>=<filename><envar>${HOME}</envar>/My_IDL/init.pro</filename></userinput></screen></listitem> 
    112         </varlistentry> 
     122<varlistentry><term><command>csh</command></term> 
     123<listitem><screen><prompt>$</prompt> <userinput><command>setenv</command> <envar>IDL_STARTUP</envar> <filename>${HOME}/My_IDL/init.pro</filename></userinput></screen></listitem> 
     124</varlistentry> 
     125<varlistentry><term><command>ksh</command></term> 
     126<listitem><screen><prompt>$</prompt> <userinput><command>export</command> <envar>IDL_STARTUP</envar>=<filename>${HOME}/My_IDL/init.pro</filename></userinput></screen></listitem> 
     127</varlistentry> 
    113128      </variablelist> 
    114129      </para> 
    115130    </sect2> 
    116     <sect2 id="basic_plots"> 
    117       <title> 
    118         Basic plots &hellip; 
    119       </title> 
    120       <sect3 id="basic_splot"> 
    121       <title> 
    122         splot 
    123       </title> 
    124  
    125       <para> 
    126         <screenco> 
    127           <areaspec> 
    128             <area id="findgen" coords='2'/> 
    129           </areaspec> 
    130         <screen format="linespecific"> 
     131    <sect2 xml:id="basic_plots"> 
     132      <title> Basic plots &hellip; </title> 
     133      <sect3 xml:id="basic_splot"> 
     134      <title> splot </title> 
     135 
     136      <para> 
     137<screenco> 
     138  <areaspec> 
     139    <area xml:id="findgen" coords="2"/> 
     140  </areaspec> 
     141<screen> 
    131142   <prompt>&promptidl;</prompt> <userinput><command>n = 10</command></userinput> 
    132143   <prompt>&promptidl;</prompt> <userinput><command>y = findgen(n)</command></userinput> &numb1; 
    133    <prompt>&promptidl;</prompt> <userinput><command>plot, y</command></userinput> <ulink url="./figpng/basic_plot.png">&showfig;</ulink> 
    134         </screen> 
     144   <prompt>&promptidl;</prompt> <userinput><command>plot, y</command></userinput> <link xl:href="./figpng/basic_plot.png">&showfig;</link> 
     145</screen> 
    135146          <calloutlist> 
    136             <callout arearefs="findgen"> 
    137               <para> 
    138                 <command>findgen</command> stands for 
     147    <callout arearefs="findgen"> 
     148      <para> 
     149<command>findgen</command> stands for 
    139150<emphasis role="bold">f</emphasis>loat <emphasis role="bold">ind</emphasis>ex <emphasis role="bold">gen</emphasis>erator. 
    140                 <screen format="linespecific"> 
     151<screen> 
    141152  <prompt>&promptidl;</prompt> <userinput><command>print, findgen(6)</command></userinput> 
    142153  <computeroutput>      0.00000      1.00000      2.00000      3.00000      4.00000      5.00000</computeroutput> 
    143                 </screen> 
    144               </para> 
    145             </callout> 
    146           </calloutlist> 
    147         </screenco> 
     154</screen> 
     155      </para> 
     156    </callout> 
     157  </calloutlist> 
     158</screenco> 
    148159     </para> 
    149160      <para> 
    150         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. 
    151         <screen format="linespecific"> 
    152   <prompt>&promptidl;</prompt> <userinput><command>splot, y</command></userinput> <ulink url="./figpng/basic_splot1.png">&showfig;</ulink> 
     161Using 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. 
     162<screen> 
     163  <prompt>&promptidl;</prompt> <userinput><command>splot, y</command></userinput> <link xl:href="./figpng/basic_splot1.png">&showfig;</link> 
    153164  <computeroutput>% Compiled module: SPLOT.</computeroutput> 
    154165  <computeroutput>% Compiled module: REINITPLT.</computeroutput> 
     
    158169  <computeroutput>% Compiled module: GET_SCREEN_SIZE.</computeroutput> 
    159170  <computeroutput>% Compiled module: TERMINEDESSIN.</computeroutput> 
    160         </screen> 
    161         Save the figure seen on the screen as a (real, not a screen capture) postscript in only one command. 
    162         <screenco> 
    163           <areaspec> 
    164             <area id="make_ps" coords='6'/> 
    165           </areaspec> 
    166         <screen format="linespecific"> 
     171</screen> 
     172Save the figure seen on the screen as a (real, not a screen capture) postscript in only one command. 
     173<screenco> 
     174  <areaspec> 
     175    <area xml:id="make_ps" coords="6"/> 
     176  </areaspec> 
     177<screen> 
    167178  <prompt>&promptidl;</prompt> <userinput><command>@ps</command></userinput> 
    168179  <computeroutput>% Compiled module: GETFILE.</computeroutput> 
     
    178189  <computeroutput>% Compiled module: CW_BGROUP.</computeroutput> 
    179190  <computeroutput>% Compiled module: XMANAGER.</computeroutput> 
    180         </screen> 
    181           <calloutlist> 
    182             <callout arearefs="make_ps"> 
    183               <para> 
    184                 <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> 
    185               </para> 
    186             </callout> 
    187           </calloutlist> 
    188         </screenco> 
    189         Check that the <quote><filename>first_ps.ps</filename></quote> file is now existing &hellip; 
    190         <screen format="linespecific"> 
     191</screen> 
     192  <calloutlist> 
     193    <callout arearefs="make_ps"> 
     194      <simpara> 
     195If 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>. 
     196      </simpara> 
     197    </callout> 
     198  </calloutlist> 
     199</screenco> 
     200Check that the <quote><filename>first_ps.ps</filename></quote> file is now existing &hellip; 
     201<screen> 
    191202  <prompt>&promptidl;</prompt> <userinput><command>print, file_test(psdir + 'first_ps.ps')</command></userinput> 
    192203  <computeroutput>           1</computeroutput> 
     
    216227  <computeroutput>   MTIME           LONG64                1122424373</computeroutput> 
    217228  <computeroutput>   SIZE            LONG64                      4913</computeroutput> 
    218         </screen> 
    219       </para> 
    220       <para id="splot_description"> 
    221         <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>). 
     229</screen> 
     230      </para> 
     231      <para xml:id="splot_description"> 
     232<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>). 
    222233      </para> 
    223234      <simpara> 
    224         It can therefore be customized <emphasis>as much as you want</emphasis>. See this short example: 
     235It can therefore be customized <emphasis>as much as you want</emphasis>. See this short example: 
    225236      </simpara> 
    226237      <para> 
    227         <screen format="linespecific"> 
    228   <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> 
    229         </screen> 
    230         <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> 
    231         <screen format="linespecific"> 
     238<screen> 
     239  <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> 
     240</screen> 
     241<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> 
     242<screen> 
    232243  <prompt>&promptidl;</prompt> <userinput><command>splot, y, yrange = [0, (n-1)^2], title = 'x and x^2'</command></userinput> 
    233   <prompt>&promptidl;</prompt> <userinput><command>oplot, y^2, color = 50, linestyle = 2</command></userinput> <ulink url="./figpng/basic_splot4.png">&showfig;</ulink> 
    234         </screen> 
    235         Use the keyword small to produce multi plots figures. 
    236         <screenco> 
    237           <areaspec> 
    238             <areaset id="small" coords=""> 
    239               <area id="small.1" coords='1'/> 
    240               <area id="small.2" coords='2'/> 
    241             </areaset> 
    242             <area id="noerase" coords='2'/> 
    243           </areaspec> 
    244         <screen format="linespecific"> 
     244  <prompt>&promptidl;</prompt> <userinput><command>oplot, y^2, color = 50, linestyle = 2</command></userinput> <link xl:href="./figpng/basic_splot4.png">&showfig;</link> 
     245</screen> 
     246Use the keyword small to produce multi plots figures. 
     247<screenco> 
     248  <areaspec> 
     249    <areaset xml:id="small"> 
     250      <area xml:id="small.1" coords="1"/> 
     251      <area xml:id="small.2" coords="2"/> 
     252    </areaset> 
     253    <area xml:id="noerase" coords="2"/> 
     254  </areaspec> 
     255<screen> 
    245256  <prompt>&promptidl;</prompt> <userinput><command>splot, y, y^2, title = 'y = x^2', psym = 2, small &numb1; = [1, 2, 1]</command></userinput> 
    246257  <prompt>&promptidl;</prompt> <userinput><command>splot, findgen(360)/36., findgen(360)*2.*!dtor, /polar $</command></userinput> 
    247   <prompt>&promptidl;</prompt> <userinput><command>    , small &numb1; = [1, 2, 2], /noerase &numb2;</command></userinput> <ulink url="./figpng/basic_splot3.png">&showfig;</ulink> 
    248         </screen> 
    249           <calloutlist> 
    250             <callout arearefs="small"> 
    251               <para> 
    252                 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. 
    253               </para> 
    254             </callout> 
    255             <callout arearefs="noerase"> 
    256               <simpara> 
    257                 you must put <computeroutput>/noerase</computeroutput> otherwise the second plot will be done in a new window. 
    258               </simpara> 
    259             </callout> 
    260           </calloutlist> 
    261         </screenco> 
     258  <prompt>&promptidl;</prompt> <userinput><command>    , small &numb1; = [1, 2, 2], /noerase &numb2;</command></userinput> <link xl:href="./figpng/basic_splot3.png">&showfig;</link> 
     259</screen> 
     260  <calloutlist> 
     261    <callout arearefs="small"> 
     262      <simpara> 
     263the <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. 
     264      </simpara> 
     265    </callout> 
     266    <callout arearefs="noerase"> 
     267      <simpara> 
     268you must put <computeroutput>/noerase</computeroutput> otherwise the second plot will be done in a new window. 
     269      </simpara> 
     270    </callout> 
     271  </calloutlist> 
     272</screenco> 
    262273      </para> 
    263274      </sect3> 
    264275 
    265       <sect3 id="basic_contour"> 
    266       <title> 
    267         scontour 
    268       </title> 
    269       <para> 
    270         Following <command><link linkend="basic_splot">splot</link></command> example, we provide <command>scontour</command> as a "super <command>contour</command>". 
    271         <screen format="linespecific"> 
     276      <sect3 xml:id="basic_contour"> 
     277      <title> scontour </title> 
     278      <para> 
     279Following <command><link linkend="basic_splot">splot</link></command> example, we provide <command>scontour</command> as a "super <command>contour</command>". 
     280<screen> 
    272281  <prompt>&promptidl;</prompt> <userinput><command>z = dist(n)</command></userinput> 
    273282  <computeroutput>% Compiled module: DIST.</computeroutput> 
    274   <prompt>&promptidl;</prompt> <userinput><command>scontour, z</command></userinput> <ulink url="./figpng/basic_scontour1.png">&showfig;</ulink> 
     283  <prompt>&promptidl;</prompt> <userinput><command>scontour, z</command></userinput> <link xl:href="./figpng/basic_scontour1.png">&showfig;</link> 
    275284  <computeroutput>% Compiled module: SCONTOUR.</computeroutput> 
    276285  <computeroutput>% Compiled module: CHKSTRU.</computeroutput> 
    277         </screen> 
    278         <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>). 
     286</screen> 
     287<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>). 
    279288      </para> 
    280289      <simpara>It can therefore be customized <emphasis>as much as you want</emphasis>. See these short examples:</simpara> 
    281290      <para> 
    282         <screen format="linespecific"> 
     291<screen> 
    283292  <prompt>&promptidl;</prompt> <userinput><command>scontour, z, /fill, nlevels = 15, subtitle = 'nicer contour' $</command></userinput> 
    284   <prompt>&promptidl;</prompt> <userinput><command>    , xtitle = 'x index', charsize = 1.5</command></userinput> <ulink url="./figpng/basic_scontour2.png">&showfig;</ulink> 
    285         </screen> 
     293  <prompt>&promptidl;</prompt> <userinput><command>    , xtitle = 'x index', charsize = 1.5</command></userinput> <link xl:href="./figpng/basic_scontour2.png">&showfig;</link> 
     294</screen> 
    286295It can be used in combination with contour to make more complex plots: 
    287         <screenco> 
    288           <areaspec> 
    289             <area id="rebin" coords='1'/> 
    290           </areaspec> 
    291         <screen format="linespecific"> 
     296<screenco> 
     297  <areaspec> 
     298    <area xml:id="rebin" coords="1"/> 
     299  </areaspec> 
     300<screen> 
    292301  <prompt>&promptidl;</prompt> <userinput><command>ind = findgen(2*n)/(2.*n)</command></userinput> 
    293302  <prompt>&promptidl;</prompt> <userinput><command>scontour, z, levels = n*ind, c_orientation = 180*ind, c_spacing = 0.4*ind</command></userinput> 
    294303  <prompt>&promptidl;</prompt> <userinput><command>contour, z, /overplot, c_label = rebin([1, 0], 2, n) &numb1;, levels = n*ind $</command></userinput> 
    295   <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> 
    296         </screen> 
    297         <calloutlist> 
    298           <callout arearefs="rebin"> 
    299             <para> 
    300               <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. 
    301                 <screen format="linespecific"> 
     304  <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> 
     305</screen> 
     306<calloutlist> 
     307  <callout arearefs="rebin"> 
     308    <para> 
     309      <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. 
     310<screen> 
    302311  <prompt>&promptidl;</prompt> <userinput><command>print, rebin([1, 0], 2, 3)</command></userinput> 
    303312  <computeroutput>       1       0</computeroutput> 
    304313  <computeroutput>       1       0</computeroutput> 
    305314  <computeroutput>       1       0</computeroutput> 
    306                 </screen> 
    307             </para> 
    308           </callout> 
    309         </calloutlist> 
    310         </screenco> 
    311         <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>: 
    312         <screen format="linespecific"> 
    313   <prompt>&promptidl;</prompt> <userinput><command>tst_basic</command></userinput> <ulink url="./figpng/tst_basic.png">&showfig;</ulink> 
    314         </screen> 
     315</screen> 
     316    </para> 
     317  </callout> 
     318</calloutlist> 
     319</screenco> 
     320<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>: 
     321<screen> 
     322  <prompt>&promptidl;</prompt> <userinput><command>tst_basic</command></userinput> <link xl:href="./figpng/tst_basic.png">&showfig;</link> 
     323</screen> 
    315324      </para> 
    316325      </sect3> 
    317326 
    318       <sect3 id="tvplus"> 
    319         <title> 
    320           Quick look and explore 2D arrays: tvplus 
    321         </title> 
    322         <para> 
    323           <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. 
    324           <screen format="linespecific"> 
    325   <prompt>&promptidl;</prompt> <userinput><command>tvplus, dist(20)</command></userinput> <ulink url="./figpng/tvplus.png">&showfig;</ulink> 
     327      <sect3 xml:id="tvplus"> 
     328<title> Quick look and explore 2D arrays: tvplus </title> 
     329<para> 
     330  <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. 
     331  <screen> 
     332  <prompt>&promptidl;</prompt> <userinput><command>tvplus, dist(20)</command></userinput> <link xl:href="./figpng/tvplus.png">&showfig;</link> 
    326333  <computeroutput>left button  : mouse position and associated array value</computeroutput> 
    327334  <computeroutput>middle button: use it twice to define a zoom box</computeroutput> 
     
    329336  <computeroutput>(x, y) = (  5,   5), value = 7.07107</computeroutput> 
    330337  <computeroutput>(x, y) = ( 12,   8), value = 11.3137</computeroutput> 
    331           </screen> 
    332           For more informations on <command>tvplus</command>, try: 
    333           <screen format="linespecific"> 
     338  </screen> 
     339  For more informations on <command>tvplus</command>, try: 
     340  <screen> 
    334341  <prompt>&promptidl;</prompt> <userinput><command>xhelp, 'tvplus'</command></userinput> 
    335           </screen> 
    336           To see the source code of <command>tvplus</command>, try: 
    337           <screen format="linespecific"> 
     342  </screen> 
     343  To see the source code of <command>tvplus</command>, try: 
     344  <screen> 
    338345  <prompt>&promptidl;</prompt> <userinput><command>xfile, 'tvplus'</command></userinput> 
    339           </screen> 
    340           <note><title>New Feature</title><para> 
    341           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: 
    342           <screen format="linespecific"> 
     346  </screen> 
     347  <note><title>New Feature</title><para> 
     348  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: 
     349  <screen> 
    343350  <prompt>&promptidl;</prompt> <userinput><command>?tvplus</command></userinput> 
    344           </screen> 
    345           </para></note> 
    346         </para> 
     351  </screen> 
     352  </para></note> 
     353</para> 
    347354      </sect3> 
    348355 
    349       <sect3 id="pltv"> 
    350         <title> 
    351           Formal quick look at 2D arrays: pltv 
    352         </title> 
    353         <para> 
    354           <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. 
    355           <screen format="linespecific"> 
    356   <prompt>&promptidl;</prompt> <userinput><command>pltv, dist(20)</command></userinput> <ulink url="./figpng/pltv.png">&showfig;</ulink> 
    357           </screen> 
    358         </para> 
     356      <sect3 xml:id="pltv"> 
     357<title> Formal quick look at 2D arrays: pltv </title> 
     358<para> 
     359  <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. 
     360  <screen> 
     361  <prompt>&promptidl;</prompt> <userinput><command>pltv, dist(20)</command></userinput> <link xl:href="./figpng/pltv.png">&showfig;</link> 
     362  </screen> 
     363</para> 
    359364      </sect3> 
    360365    </sect2> 
    361366  </sect1> 
    362367 
    363   <sect1 id="gridded_data"> 
    364     <title> 
    365       Explore gridded data (model outputs and observations) 
    366     </title> 
     368  <sect1 xml:id="gridded_data"> 
     369    <title> Explore gridded data (model outputs and observations) </title> 
    367370    <para> 
    368371      This section briefly describes the main functionalities offered by SAXO to explore gridded data on regular or irregular grid. 
    369372    </para> 
    370373 
    371     <sect2 id="load_grid"> 
    372       <title> 
    373         Load the data grid 
    374       </title> 
    375       <para> 
    376         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. 
    377       </para> 
    378       <sect3 id="load_fromdata"> 
    379         <title> 
    380           Easiest solution: load data grid (regular or not) directly from the data file 
    381         </title> 
    382         <para> 
    383           Example of Levitus temperature on a regular 1x1 grid. 
    384           <screen format="linespecific"> 
     374    <sect2 xml:id="load_grid"> 
     375      <title> Load the data grid </title> 
     376      <para> 
     377As 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. 
     378      </para> 
     379      <sect3 xml:id="load_fromdata"> 
     380<title> Easiest solution: load data grid (regular or not) directly from the data file </title> 
     381<para> 
     382  Example of Levitus temperature on a regular 1x1 grid. 
     383  <screen> 
    385384  <prompt>&promptidl;</prompt> <userinput><command>@tst_initlev</command></userinput> 
    386385  <computeroutput>% Compiled module: INITNCDF.</computeroutput> 
     
    397396  <computeroutput>% Compiled module: DIFFERENT.</computeroutput> 
    398397  <computeroutput>% Compiled module: DEFINETRI.</computeroutput> 
    399           </screen> 
    400           This <ulink type="text" url="../../Tests/tst_initlev.pro"><command>@tst_initlev</command></ulink> command allows us to define: 
    401           <itemizedlist> 
    402             <listitem><simpara>domain dimensions, stored in <varname>jpi, jpj and jpk</varname></simpara></listitem> 
    403             <listitem><simpara>points abscissa, stored in 2D array <varname></varname>glamt</simpara></listitem> 
    404             <listitem><simpara>points ordinates, stored in 2D array <varname></varname>gphit</simpara></listitem> 
    405             <listitem><simpara>points depths, stored in 1D array <varname></varname>gdept</simpara></listitem> 
    406             <listitem><simpara>cells corners abscissa, stored in 2D array <varname></varname>glamf</simpara></listitem> 
    407             <listitem><simpara>cells corners ordinates, stored in 2D array <varname></varname>gphif</simpara></listitem> 
    408             <listitem><simpara>cells upper boundary depth, stored in 1D array <varname></varname>gdepw</simpara></listitem> 
    409             <listitem><simpara>land-sea mask, stored in <varname>tmask</varname></simpara></listitem> 
    410             <listitem><simpara>the cells size in the longitudinal direction, stored in 2D array <varname></varname>e1t</simpara></listitem> 
    411             <listitem><simpara>the cells size in the latitudinal direction, stored in 2D array <varname></varname>e2t</simpara></listitem> 
    412             <listitem><simpara>the cells size in the vertical direction, stored in 1D array <varname></varname>e3t</simpara></listitem> 
    413             <listitem><simpara>the triangulation used to fill the land points, stored in <varname></varname>triangles_list</simpara></listitem> 
    414           </itemizedlist> 
    415  
    416           <screen format="linespecific"> 
     398  </screen> 
     399  This <link xl:href="../../Tests/tst_initlev.pro"><command>@tst_initlev</command></link> command allows us to define: 
     400  <itemizedlist> 
     401    <listitem><simpara>domain dimensions, stored in <varname>jpi, jpj and jpk</varname></simpara></listitem> 
     402    <listitem><simpara>points abscissa, stored in 2D array <varname></varname>glamt</simpara></listitem> 
     403    <listitem><simpara>points ordinates, stored in 2D array <varname></varname>gphit</simpara></listitem> 
     404    <listitem><simpara>points depths, stored in 1D array <varname></varname>gdept</simpara></listitem> 
     405    <listitem><simpara>cells corners abscissa, stored in 2D array <varname></varname>glamf</simpara></listitem> 
     406    <listitem><simpara>cells corners ordinates, stored in 2D array <varname></varname>gphif</simpara></listitem> 
     407    <listitem><simpara>cells upper boundary depth, stored in 1D array <varname></varname>gdepw</simpara></listitem> 
     408    <listitem><simpara>land-sea mask, stored in <varname>tmask</varname></simpara></listitem> 
     409    <listitem><simpara>the cells size in the longitudinal direction, stored in 2D array <varname></varname>e1t</simpara></listitem> 
     410    <listitem><simpara>the cells size in the latitudinal direction, stored in 2D array <varname></varname>e2t</simpara></listitem> 
     411    <listitem><simpara>the cells size in the vertical direction, stored in 1D array <varname></varname>e3t</simpara></listitem> 
     412    <listitem><simpara>the triangulation used to fill the land points, stored in <varname></varname>triangles_list</simpara></listitem> 
     413  </itemizedlist> 
     414 
     415  <screen> 
    417416  <prompt>&promptidl;</prompt> <userinput><command>help, jpi,jpj,jpk</command></userinput> 
    418417  <computeroutput>JPI (LOCAL_COORD)   LONG      =          360</computeroutput> 
     
    437436  <prompt>&promptidl;</prompt> <userinput><command>tvplus, glamt*tmask[*,*,0]</command></userinput> 
    438437  <prompt>&promptidl;</prompt> <userinput><command>tvplus, gphit*tmask[*,*,0]</command></userinput> 
    439           </screen> 
    440           We provide other initialization methods/examples 
    441           <itemizedlist> 
    442             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_short.pro">@tst_initorca2_short</ulink> : ORCA2 example</simpara></listitem> 
    443             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_short.pro">@tst_initorca05_short</ulink> : ORCA05 example</simpara></listitem> 
    444             <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> 
    445             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_short_stride.pro">@tst_initorca2_short_stride</ulink> : ORCA2 with stride</simpara></listitem> 
    446             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_short_stride.pro">@tst_initorca05_short_stride</ulink> : ORCA05 with stride</simpara></listitem> 
    447             <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> 
    448             <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> 
    449             <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> 
    450             <listitem><simpara><ulink type="text" url="../../Tests/tst_initlev_index_stride.pro">@tst_initlev_index_stride</ulink> : @tst_initlev_index with stride</simpara></listitem> 
    451             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</ulink> : ORCA2 in index with stride</simpara></listitem> 
    452             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</ulink> : ORCA05 in index with stride</simpara></listitem> 
    453           </itemizedlist> 
    454         </para> 
     438  </screen> 
     439  We provide other initialization methods/examples 
     440  <itemizedlist> 
     441    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_short.pro">@tst_initorca2_short</link> : ORCA2 example</simpara></listitem> 
     442    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_short.pro">@tst_initorca05_short</link> : ORCA05 example</simpara></listitem> 
     443    <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> 
     444    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_short_stride.pro">@tst_initorca2_short_stride</link> : ORCA2 with stride</simpara></listitem> 
     445    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_short_stride.pro">@tst_initorca05_short_stride</link> : ORCA05 with stride</simpara></listitem> 
     446    <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> 
     447    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</link> : load ORCA2 as it see by the model</simpara></listitem> 
     448    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</link> : load ORCA05 as it see by the model</simpara></listitem> 
     449    <listitem><simpara><link xl:href="../../Tests/tst_initlev_index_stride.pro">@tst_initlev_index_stride</link> : @tst_initlev_index with stride</simpara></listitem> 
     450    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</link> : ORCA2 in index with stride</simpara></listitem> 
     451    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</link> : ORCA05 in index with stride</simpara></listitem> 
     452  </itemizedlist> 
     453</para> 
    455454      </sect3> 
    456       <sect3 id="load_meshmask"> 
    457         <title> 
    458           Load the grid from OPA <filename>meshmask</filename> file 
    459         </title> 
    460         <para> 
    461           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. 
    462           <itemizedlist> 
    463             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2.pro">@tst_initorca2</ulink> : ORCA2</simpara></listitem> 
    464             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05.pro">@tst_initorca05</ulink> : ORCA05</simpara></listitem> 
    465             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_stride.pro">@tst_initorca2_stride</ulink> : ORCA2 with stride</simpara></listitem> 
    466             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_stride.pro">@tst_initorca05_stride</ulink> : ORCA05 with stride</simpara></listitem> 
    467             <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> 
    468             <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> 
    469             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</ulink> : ORCA2 in index with stride</simpara></listitem> 
    470             <listitem><simpara><ulink type="text" url="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</ulink> : ORCA05 in index with stride</simpara></listitem> 
    471           </itemizedlist> 
    472         </para> 
     455      <sect3 xml:id="load_meshmask"> 
     456<title> Load the grid from OPA <filename>meshmask</filename> file </title> 
     457<para> 
     458  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. 
     459  <itemizedlist> 
     460    <listitem><simpara><link xl:href="../../Tests/tst_initorca2.pro">@tst_initorca2</link> : ORCA2</simpara></listitem> 
     461    <listitem><simpara><link xl:href="../../Tests/tst_initorca05.pro">@tst_initorca05</link> : ORCA05</simpara></listitem> 
     462    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_stride.pro">@tst_initorca2_stride</link> : ORCA2 with stride</simpara></listitem> 
     463    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_stride.pro">@tst_initorca05_stride</link> : ORCA05 with stride</simpara></listitem> 
     464    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index.pro">@tst_initorca2_index</link> : load ORCA2 as it see by the model</simpara></listitem> 
     465    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index.pro">@tst_initorca05_index</link> : load ORCA05 as it see by the model</simpara></listitem> 
     466    <listitem><simpara><link xl:href="../../Tests/tst_initorca2_index_stride.pro">@tst_initorca2_index_stride</link> : ORCA2 in index with stride</simpara></listitem> 
     467    <listitem><simpara><link xl:href="../../Tests/tst_initorca05_index_stride.pro">@tst_initorca05_index_stride</link> : ORCA05 in index with stride</simpara></listitem> 
     468  </itemizedlist> 
     469</para> 
    473470        </sect3> 
    474471    </sect2> 
    475472 
    476     <sect2 id="plt"> 
    477       <title> 
    478         Horizontal plots and maps 
    479       </title> 
    480         <para> 
    481           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: 
    482           <screen format="linespecific"> 
     473    <sect2 xml:id="plt"> 
     474      <title> Horizontal plots and maps </title> 
     475<para> 
     476  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: 
     477  <screen> 
    483478  <prompt>&promptidl;</prompt> <userinput><command>tst_plt</command></userinput> 
    484           </screen> 
    485         </para> 
    486         <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> 
    487         <para> 
    488           See the results with 
    489           <itemizedlist> 
    490           <listitem><simpara><command>@tst_initlev</command>&figsplt_lev;</simpara></listitem> 
    491           <listitem><simpara><command>@tst_initorca2</command>&figsplt_orca2;</simpara></listitem> 
    492           <listitem><simpara><command>@tst_initorca05</command>&figsplt_orca05;</simpara></listitem> 
    493           <listitem><simpara><command>@tst_initlev_stride</command>&figsplt_lev_stride;</simpara></listitem> 
    494           <listitem><simpara><command>@tst_initorca2_stride</command>&figsplt_orca2_stride;</simpara></listitem> 
    495           <listitem><simpara><command>@tst_initorca05_stride</command>&figsplt_orca05_stride;</simpara></listitem> 
    496           </itemizedlist> 
    497         </para> 
     479  </screen> 
     480</para> 
     481<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> 
     482<para> 
     483  See the results with 
     484  <itemizedlist> 
     485  <listitem><simpara><command>@tst_initlev</command>&figsplt_lev;</simpara></listitem> 
     486  <listitem><simpara><command>@tst_initorca2</command>&figsplt_orca2;</simpara></listitem> 
     487  <listitem><simpara><command>@tst_initorca05</command>&figsplt_orca05;</simpara></listitem> 
     488  <listitem><simpara><command>@tst_initlev_stride</command>&figsplt_lev_stride;</simpara></listitem> 
     489  <listitem><simpara><command>@tst_initorca2_stride</command>&figsplt_orca2_stride;</simpara></listitem> 
     490  <listitem><simpara><command>@tst_initorca05_stride</command>&figsplt_orca05_stride;</simpara></listitem> 
     491  </itemizedlist> 
     492</para> 
    498493    </sect2> 
    499494 
    500     <sect2 id="pltz"> 
    501       <title> 
    502         Vertical sections 
    503       </title> 
    504         <para> 
    505           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: 
    506           <screen format="linespecific"> 
     495    <sect2 xml:id="pltz"> 
     496      <title> Vertical sections </title> 
     497<para> 
     498  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: 
     499  <screen> 
    507500  <prompt>&promptidl;</prompt> <userinput><command>tst_pltz</command></userinput> 
    508           </screen> 
    509         </para> 
    510           <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> 
    511         <para> 
    512           See the results with 
    513           <itemizedlist> 
    514           <listitem><simpara><command>@tst_initlev</command>&figspltz_lev;</simpara></listitem> 
    515           <listitem><simpara><command>@tst_initorca2</command>&figspltz_orca2;</simpara></listitem> 
    516           <listitem><simpara><command>@tst_initorca05</command>&figspltz_orca05;</simpara></listitem> 
    517           <listitem><simpara><command>@tst_initlev_stride</command>&figspltz_lev_stride;</simpara></listitem> 
    518           <listitem><simpara><command>@tst_initorca2_stride</command>&figspltz_orca2_stride;</simpara></listitem> 
    519           <listitem><simpara><command>@tst_initorca05_stride</command>&figspltz_orca05_stride;</simpara></listitem> 
    520           </itemizedlist> 
    521         </para> 
     501  </screen> 
     502</para> 
     503  <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> 
     504<para> 
     505  See the results with 
     506  <itemizedlist> 
     507  <listitem><simpara><command>@tst_initlev</command>&figspltz_lev;</simpara></listitem> 
     508  <listitem><simpara><command>@tst_initorca2</command>&figspltz_orca2;</simpara></listitem> 
     509  <listitem><simpara><command>@tst_initorca05</command>&figspltz_orca05;</simpara></listitem> 
     510  <listitem><simpara><command>@tst_initlev_stride</command>&figspltz_lev_stride;</simpara></listitem> 
     511  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltz_orca2_stride;</simpara></listitem> 
     512  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltz_orca05_stride;</simpara></listitem> 
     513  </itemizedlist> 
     514</para> 
    522515    </sect2> 
    523516 
    524     <sect2 id="pltt"> 
    525       <title> 
    526         Hovmoellers and time series 
    527       </title> 
    528         <para> 
    529           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: 
    530           <screen format="linespecific"> 
     517    <sect2 xml:id="pltt"> 
     518      <title> Hovmoellers and time series </title> 
     519<para> 
     520  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: 
     521  <screen> 
    531522  <prompt>&promptidl;</prompt> <userinput><command>tst_pltt</command></userinput> 
    532           </screen> 
    533         </para> 
    534           <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> 
    535         <para> 
    536           See the results with 
    537           <itemizedlist> 
    538           <listitem><simpara><command>@tst_initlev</command>&figspltt_lev;</simpara></listitem> 
    539           <listitem><simpara><command>@tst_initorca2</command>&figspltt_orca2;</simpara></listitem> 
    540           <listitem><simpara><command>@tst_initorca05</command>&figspltt_orca05;</simpara></listitem> 
    541           <listitem><simpara><command>@tst_initlev_stride</command>&figspltt_lev_stride;</simpara></listitem> 
    542           <listitem><simpara><command>@tst_initorca2_stride</command>&figspltt_orca2_stride;</simpara></listitem> 
    543           <listitem><simpara><command>@tst_initorca05_stride</command>&figspltt_orca05_stride;</simpara></listitem> 
    544           </itemizedlist> 
    545         </para> 
     523  </screen> 
     524</para> 
     525  <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> 
     526<para> 
     527  See the results with 
     528  <itemizedlist> 
     529  <listitem><simpara><command>@tst_initlev</command>&figspltt_lev;</simpara></listitem> 
     530  <listitem><simpara><command>@tst_initorca2</command>&figspltt_orca2;</simpara></listitem> 
     531  <listitem><simpara><command>@tst_initorca05</command>&figspltt_orca05;</simpara></listitem> 
     532  <listitem><simpara><command>@tst_initlev_stride</command>&figspltt_lev_stride;</simpara></listitem> 
     533  <listitem><simpara><command>@tst_initorca2_stride</command>&figspltt_orca2_stride;</simpara></listitem> 
     534  <listitem><simpara><command>@tst_initorca05_stride</command>&figspltt_orca05_stride;</simpara></listitem> 
     535  </itemizedlist> 
     536</para> 
    546537    </sect2> 
    547538 
    548     <sect2 id="plt1d"> 
    549       <title> 
    550         1D plots 
    551       </title> 
     539    <sect2 xml:id="plt1d"> 
     540      <title> 1D plots </title> 
    552541        <para> 
    553           To be continued &hellip; 
    554         </para> 
     542  To be continued &hellip; 
     543</para> 
    555544   </sect2> 
    556545 
  • trunk/SRC/Documentation/xmldoc/firststeps_pre.sh

    r326 r345  
    1 #!/bin/bash -x 
     1#! /bin/sh 
     2# 
     3# module : 
     4# ++ working on firststeps.xml before processing for HTML and wiki 
    25# 
    36# update : 
    47# $Id$ 
    5 # 
    6 # ++ one day we can add accessibility check with tidy with -access 3 
    7 # diagnostics are not so good so far because tidy (HTML Tidy for Mac OS X 
    8 # released on 1 September 2005) doesn't handle carriage returns 
    9 # 
    10 # fplod 2007-06-27T11:54:26Z aedon.locean-ipsl.upmc.fr (Darwin) 
    11 # replacing saxon by xalan because of better results on callouts 
    12 # fplod 2006-09-20T16:28:32Z aedon.locean-ipsl.upmc.fr (Darwin) 
    13 # remove ?format=raw 
    14 # fplod 2006-09-18T12:53:07Z aedon.locean-ipsl.upmc.fr (Darwin) 
    15 # add status checking in xml processing 
    16 # fplod 2006-09-07T08:10:23Z aedon.locean-ipsl.upmc.fr (Darwin) 
    17 # main is rename to websaxo.html 
    18 # fplod 2006-08-29T14:01:11Z aedon.locean-ipsl.upmc.fr (Darwin) 
    19 # add main which needs xmllint processing to resolve xinclude 
    20 # fplod 2006-08-18T13:38:31Z aedon.locean-ipsl.upmc.fr (Darwin) 
    21 # add faqsaxo which needs xmllint processing to resolve xinclude 
    22 # fplod 2006-07-21T08:25:05Z aedon.locean-ipsl.upmc.fr (Darwin) 
    23 # add prerequisites for mini_notice production 
    24 # fplod 2006-07-12T11:57:24Z aedon.locean-ipsl.upmc.fr (Darwin) 
    25 # add style.css 
    26 # fplod 2006-07-11T08:25:30Z aedon.locean-ipsl.upmc.fr (Darwin) 
    27 # use of tidy and titlepage.saxo.xml 
    28 # replace /sw/share/xml/xsl/docbook-xsl/html/docbook.xsl 
    29 # by saxo_html.xsl 
    30 # fplod 2006-07-05T13:18:56Z aedon.locean-ipsl.upmc.fr (Darwin) 
    31 # add infoupdatecm 
    32 # add sort and varname in production of infoupdatekwd 
    33 # fplod 2006-06-07T13:55:07Z aedon.locean-ipsl.upmc.fr (Darwin) 
    34 # add infoupdatekwd 
    35 # fplod 2006-06-02T14:37:47Z aedon.locean-ipsl.upmc.fr (Darwin) 
    36 # take only one tar file : the most recent using modification time 
    37 # fplod 2006-06-02T10:00:41Z aedon.locean-ipsl.upmc.fr (Darwin) 
    38 # http://forge.ipsl.jussieu.fr/saxo/download/ is the new directory reference 
    39 # for tar file instead of ~/SAXO_SRC/ ie home of Sebatien Masson on 
    40 # arete.locean-ipsl.jussieu.fr 
    41 # !!! saxo@forge.ipsl.jussieu.fr password is needed 
    42 # fplod 2006-05-31T10:34:18Z aedon.locean-ipsl.upmc.fr (Darwin) 
    43 # . add creation of all_plots.html using firststeps.html 
    44 # . remplace ~/SAXO_SRC/SRC/Documentation/xmldoc/figpng by ./figpng/ 
    45 # we suppose that this shell script is launched when we are in 
    46 # <working space of saxo>/SRC/Documentation/xmldoc/ 
     8# fplod 2008-04-15T10:53:26Z aedon.locean-ipsl.upmc.fr (Darwin) 
     9# creation from makehtml.sh 
     10# adapation to docbook 5.0 
    4711# 
    4812set -u 
     13set -o posix 
    4914# 
    50 case $( whoami ) in 
    51     smasson) 
    52         lgforge=smasson 
    53     ;; 
    54     floseb) 
    55         lgforge=smasson 
    56     ;; 
    57     *) 
    58         lgforge=saxo 
    59     ;; 
    60 esac 
    61 # 
    62 case "${1}" in 
    63    getsaxo) 
    64       # size of SRC and DATA with .svn 
    65       szallsvn=$( du -sh ../../.. | awk '{print $1}' ) 
    66       szallsvn=${szallsvn%*M} 
    67       # size of SRC with .svn 
    68       szsrcsvn=$( du -sh ../../../SRC | awk '{print $1}' ) 
    69       szsrcsvn=${szsrcsvn%*M} 
    70       # size of DATA with .svn 
    71       szdatasvn=$( du -sh ../../../DATA | awk '{print $1}' ) 
    72       szdatasvn=${szdatasvn%*M} 
    73       echo "iii : you will be asked ${lgforge}@forge.ipsl.jussieu.fr passwd two times" 
    74       # find the most recent SAXO_SRC_yyyymmddrxxx.tar.gz in 
    75       # /ipsl/forge/projets/saxo/download/ 
    76       infosrc=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_SRC_*.tar.gz  | head -n 1) 
    77       filesrc=$(echo ${infosrc} | awk '{print $NF}') 
    78       szsrc=$(echo ${infosrc} | awk '{print $5}') 
    79       # ndate is the date in the file SAXO_SRC_*.tar.gz 
    80       ndate=${filesrc##*_} 
    81       ndate=${ndate%.tar.gz} 
    82       # find the most recent SAXO_DATA_yyyymmddrxxx.tar.gz in 
    83       # /ipsl/forge/projets/saxo/download/ 
    84       infodata=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_DATA_*.tar.gz | head -n 1) 
    85       filedata=$(echo ${infodata} | awk '{print $NF}') 
    86       szdata=$(echo ${infodata} | awk '{print $5}') 
    87       # ndate2 is the date in the file SAXO_DATA_*.tar.gz 
    88       ndate2=${filedata##*_} 
    89       ndate2=${ndate2%.tar.gz} 
    90    ;; 
    91    infoupdatekwd) 
    92       grep "^  old = \[old, .* new = \[new" ../../ForOldVersion/updatekwd.pro | \ 
    93         sort | \ 
    94       sed -e "s/\( old = \[old, '\)\(.*\)\('\] *& new = \[new, '\)\(.*\)\('\]\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" > /tmp/rowskwd.xml 
    95    ;; 
    96    infoupdatecm) 
    97       grep "IF NOT key_forgetold AND n_elements(" ../../ForOldVersion/updateold.pro | \ 
    98         sort | \ 
    99       sed -e "s/\(^.* THEN \)\(.*\)\( = \)\(.*\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" > /tmp/rowscm.xml 
    100    ;; 
    101    mini_notice) 
    102       # production of images with frames and callouts 
    103       # ./forxxxdoc.sh 0101 
    104       # ./forxxxdoc.sh 0201 
    105    ;; 
    106    *) 
    107       echo "iii : no prerequisites needed" 
    108    ;; 
    109 esac 
    110  
    11115# figures lists 
    11216cd ./figpng 
    113  
    11417# 
    11518figsplt_lev="" 
    11619for i in tst_plt_lev_[0-9][0-9].png 
    11720do 
    118   figsplt_lev="${figsplt_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     21  figsplt_lev="${figsplt_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    11922done 
    12023figspltz_lev="" 
    12124for i in tst_pltz_lev_[0-9][0-9].png 
    12225do 
    123   figspltz_lev="${figspltz_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     26  figspltz_lev="${figspltz_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    12427done 
    12528figspltt_lev="" 
    12629for i in tst_pltt_lev_[0-9][0-9].png 
    12730do 
    128   figspltt_lev="${figspltt_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     31  figspltt_lev="${figspltt_lev} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    12932done 
    13033# 
     
    13235for i in tst_plt_orca2_[0-9][0-9].png 
    13336do 
    134   figsplt_orca2="${figsplt_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     37  figsplt_orca2="${figsplt_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    13538done 
    13639figspltz_orca2="" 
    13740for i in tst_pltz_orca2_[0-9][0-9].png 
    13841do 
    139   figspltz_orca2="${figspltz_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     42  figspltz_orca2="${figspltz_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    14043done 
    14144figspltt_orca2="" 
    14245for i in tst_pltt_orca2_[0-9][0-9].png 
    14346do 
    144   figspltt_orca2="${figspltt_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     47  figspltt_orca2="${figspltt_orca2} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    14548done 
    14649# 
     
    14851for i in tst_plt_orca05_[0-9][0-9].png 
    14952do 
    150   figsplt_orca05="${figsplt_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     53  figsplt_orca05="${figsplt_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    15154done 
    15255figspltz_orca05="" 
    15356for i in tst_pltz_orca05_[0-9][0-9].png 
    15457do 
    155   figspltz_orca05="${figspltz_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     58  figspltz_orca05="${figspltz_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    15659done 
    15760figspltt_orca05="" 
    15861for i in tst_pltt_orca05_[0-9][0-9].png 
    15962do 
    160   figspltt_orca05="${figspltt_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     63  figspltt_orca05="${figspltt_orca05} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    16164done 
    16265## 
     
    16568for i in tst_plt_lev_stride_[0-9][0-9].png 
    16669do 
    167   figsplt_lev_stride="${figsplt_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     70  figsplt_lev_stride="${figsplt_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    16871done 
    16972figspltz_lev_stride="" 
    17073for i in tst_pltz_lev_stride_[0-9][0-9].png 
    17174do 
    172   figspltz_lev_stride="${figspltz_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     75  figspltz_lev_stride="${figspltz_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    17376done 
    17477figspltt_lev_stride="" 
    17578for i in tst_pltt_lev_stride_[0-9][0-9].png 
    17679do 
    177   figspltt_lev_stride="${figspltt_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     80  figspltt_lev_stride="${figspltt_lev_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    17881done 
    17982# 
     
    18184for i in tst_plt_orca2_stride_[0-9][0-9].png 
    18285do 
    183   figsplt_orca2_stride="${figsplt_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     86  figsplt_orca2_stride="${figsplt_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    18487done 
    18588figspltz_orca2_stride="" 
    18689for i in tst_pltz_orca2_stride_[0-9][0-9].png 
    18790do 
    188   figspltz_orca2_stride="${figspltz_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     91  figspltz_orca2_stride="${figspltz_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    18992done 
    19093figspltt_orca2_stride="" 
    19194for i in tst_pltt_orca2_stride_[0-9][0-9].png 
    19295do 
    193   figspltt_orca2_stride="${figspltt_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     96  figspltt_orca2_stride="${figspltt_orca2_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    19497done 
    19598# 
     
    197100for i in tst_plt_orca05_stride_[0-9][0-9].png 
    198101do 
    199   figsplt_orca05_stride="${figsplt_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     102  figsplt_orca05_stride="${figsplt_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    200103done 
    201104figspltz_orca05_stride="" 
    202105for i in tst_pltz_orca05_stride_[0-9][0-9].png 
    203106do 
    204   figspltz_orca05_stride="${figspltz_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     107  figspltz_orca05_stride="${figspltz_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    205108done 
    206109figspltt_orca05_stride="" 
    207110for i in tst_pltt_orca05_stride_[0-9][0-9].png 
    208111do 
    209   figspltt_orca05_stride="${figspltt_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
     112  figspltt_orca05_stride="${figspltt_orca05_stride} \<link xl:href=\"figpng\/${i}\"\>\&showfig\;\<\/link\>" 
    210113done 
    211114## 
    212115cd .. # ie <working space of saxo>/SRC/Documentation/xmldoc 
    213116# 
    214 # production of titlepage.saxo.xsl 
    215 # 
    216 # si pb reseau remplacer sur mac par la ligne suivante 
    217 titlepagexsl=http://docbook.sourceforge.net/release/xsl/current/template/titlepage.xsl 
    218 titlepagexsl=/sw/share/xml/xsl/docbook-xsl/template/titlepage.xsl 
    219 # 
    220 xsltproc \ 
    221 --xinclude \ 
    222 -o titlepage.saxo.xsl \ 
    223 ${titlepagexsl} \ 
    224 titlepage.saxo.xml 
    225 status=${?} 
    226 if [ ${status} -ne 0 ] 
    227 then 
    228  echo "eee : pb xsltproc sur titlepage.saxo.xml" 
    229  exit 1 
    230 fi 
    231 # 
    232 case "${1}" in 
    233    getsaxo) 
    234       sed -e s/"\&date\;"/${ndate}/g \ 
    235           -e s/"\&date2\;"/${ndate2}/g \ 
    236           -e s/"\&szsrc\;"/${szsrc}/g \ 
    237           -e s/"\&szdata\;"/${szdata}/g \ 
    238           -e s/"\&szallsvn\;"/${szallsvn}/g \ 
    239           -e s/"\&szsrcsvn\;"/${szsrcsvn}/g \ 
    240           -e s/"\&szdatasvn\;"/${szdatasvn}/g \ 
    241           ${1}.xml > ${1}_${$}.xml 
    242    ;; 
    243    firststeps) 
    244       sed -e s/"\&figsplt_lev\;"/"${figsplt_lev}"/g \ 
    245           -e s/"\&figsplt_orca2\;"/"${figsplt_orca2}"/g \ 
    246           -e s/"\&figsplt_orca05\;"/"${figsplt_orca05}"/g \ 
    247           -e s/"\&figspltz_lev\;"/"${figspltz_lev}"/g \ 
    248           -e s/"\&figspltz_orca2\;"/"${figspltz_orca2}"/g \ 
    249           -e s/"\&figspltz_orca05\;"/"${figspltz_orca05}"/g \ 
    250           -e s/"\&figspltt_lev\;"/"${figspltt_lev}"/g \ 
    251           -e s/"\&figspltt_orca2\;"/"${figspltt_orca2}"/g \ 
    252           -e s/"\&figspltt_orca05\;"/"${figspltt_orca05}"/g \ 
    253           -e s/"\&figsplt_lev_stride\;"/"${figsplt_lev_stride}"/g \ 
    254           -e s/"\&figsplt_orca2_stride\;"/"${figsplt_orca2_stride}"/g \ 
    255           -e s/"\&figsplt_orca05_stride\;"/"${figsplt_orca05_stride}"/g \ 
    256           -e s/"\&figspltz_lev_stride\;"/"${figspltz_lev_stride}"/g \ 
    257           -e s/"\&figspltz_orca2_stride\;"/"${figspltz_orca2_stride}"/g \ 
    258           -e s/"\&figspltz_orca05_stride\;"/"${figspltz_orca05_stride}"/g \ 
    259           -e s/"\&figspltt_lev_stride\;"/"${figspltt_lev_stride}"/g \ 
    260           -e s/"\&figspltt_orca2_stride\;"/"${figspltt_orca2_stride}"/g \ 
    261           -e s/"\&figspltt_orca05_stride\;"/"${figspltt_orca05_stride}"/g \ 
    262           ${1}.xml > ${1}_${$}.xml 
    263    ;; 
    264    infoupdatekwd) 
    265       sed -e "/-- rows from updatekwd.pro --/r /tmp/rowskwd.xml" \ 
    266           ${1}.xml > ${1}_${$}.xml 
    267       /bin/rm /tmp/rowskwd.xml 
    268    ;; 
    269    infoupdatecm) 
    270       sed -e "/-- rows from updateold.pro --/r /tmp/rowscm.xml" \ 
    271           ${1}.xml > ${1}_${$}.xml 
    272       /bin/rm /tmp/rowscm.xml 
    273    ;; 
    274    faqsaxo|websaxo) 
    275       # resolve xinclude 
    276       xmllint --xinclude \ 
    277               --output ${1}_${$}.xml ${1}.xml 
    278       status=${?} 
    279       if [ ${status} -ne 0 ] 
    280       then 
    281        echo "eee : pb xmllint sur ${1}.xml" 
    282        exit 1 
    283       fi 
    284    ;; 
    285    *) 
    286       cp ${1}.xml ${1}_${$}.xml 
    287       echo "iii : no xml transformation needed" 
    288    ;; 
    289 esac 
    290 # 
    291 CLASSPATH=${CLASSPATH}:/usr/Xalan/xalan.jar:/usr/Xalan/xml-apis.jar:\ 
    292 /usr/Xalan/xercesImpl.jar:/usr/docbook-xsl/extensions/xalan25.jar 
    293 export CLASSPATH 
    294 # 
    295 java org.apache.xalan.xslt.Process -out ${1}.html -in ${1}_${$}.xml  \ 
    296 -xsl saxo_html.xsl \ 
    297 -param section.autolabel 1 \ 
    298 -param html.stylesheet "style.css saxo.css" \ 
    299 -param css.decoration 1 
    300 status=${?} 
    301 if [ ${status} -ne 0 ] 
    302 then 
    303  echo "eee : pb xalan sur ${1}_${$}.xml" 
    304  exit 1 
    305 fi 
    306 # 
    307 case "${1}" in 
    308    firststeps) 
    309       # process all_plots 
    310       java org.apache.xalan.xslt.Process -out all_plots_${$}.xml \ 
    311       -in  ${1}_${$}.xml  \ 
    312       -xsl all_plots_docbook.xsl 
    313       java org.apache.xalan.xslt.Process -out all_plots.html \ 
    314       -in  all_plots_${$}.xml \ 
    315       -xsl saxo_html.xsl \ 
    316       -param section.autolabel 1 \ 
    317       -param html.stylesheet "style.css saxo.css" \ 
    318       -param css.decoration 1 
    319       rm -f all_plots_${$}.xml 
    320       ;; 
    321    websaxo) 
    322       sed -e s?"../../saxo/browser/trunk/SRC/Documentation/xmldoc/"??g \ 
    323           -e s?"../../saxo/browser/trunk/SRC/Documentation/idldoc_html_output/"?"../idldoc_html_output/"?g \ 
    324           -e s?"../../saxo/browser/trunk"?"http://forge.ipsl.jussieu.fr/saxo/browser/trunk"?g \ 
    325           ${1}.html > ${1}_${$}.html 
    326       mv ${1}_${$}.html ${1}.html 
    327       ;; 
    328 esac 
    329 # 
    330 # use of tidy to have a W3C compliant html file 
    331 tidy -m ${1}.html 
    332 # 
    333 # clean 
    334 rm -f ${1}_${$}.xml 
    335 rm titlepage.saxo.xsl 
     117rm firststeps_sed.xml 2> /dev/null 
     118sed -e s/"\&figsplt_lev\;"/"${figsplt_lev}"/g \ 
     119-e s/"\&figsplt_orca2\;"/"${figsplt_orca2}"/g \ 
     120-e s/"\&figsplt_orca05\;"/"${figsplt_orca05}"/g \ 
     121-e s/"\&figspltz_lev\;"/"${figspltz_lev}"/g \ 
     122-e s/"\&figspltz_orca2\;"/"${figspltz_orca2}"/g \ 
     123-e s/"\&figspltz_orca05\;"/"${figspltz_orca05}"/g \ 
     124-e s/"\&figspltt_lev\;"/"${figspltt_lev}"/g \ 
     125-e s/"\&figspltt_orca2\;"/"${figspltt_orca2}"/g \ 
     126-e s/"\&figspltt_orca05\;"/"${figspltt_orca05}"/g \ 
     127-e s/"\&figsplt_lev_stride\;"/"${figsplt_lev_stride}"/g \ 
     128-e s/"\&figsplt_orca2_stride\;"/"${figsplt_orca2_stride}"/g \ 
     129-e s/"\&figsplt_orca05_stride\;"/"${figsplt_orca05_stride}"/g \ 
     130-e s/"\&figspltz_lev_stride\;"/"${figspltz_lev_stride}"/g \ 
     131-e s/"\&figspltz_orca2_stride\;"/"${figspltz_orca2_stride}"/g \ 
     132-e s/"\&figspltz_orca05_stride\;"/"${figspltz_orca05_stride}"/g \ 
     133-e s/"\&figspltt_lev_stride\;"/"${figspltt_lev_stride}"/g \ 
     134-e s/"\&figspltt_orca2_stride\;"/"${figspltt_orca2_stride}"/g \ 
     135-e s/"\&figspltt_orca05_stride\;"/"${figspltt_orca05_stride}"/g \ 
     136firststeps.xml > firststeps_sed.xml 
    336137# 
    337138# exit 
  • trunk/SRC/Documentation/xmldoc/getsaxo.xml

    r193 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
    5 <!ENTITY hellip "&#x2026;"> 
     1<?xml version="1.0" encoding="ISO-8859-1"?> 
     2<!DOCTYPE article [ 
     3<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent"> 
     4%isolat1; 
     5<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent"> 
     6%isolat2; 
     7<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent"> 
     8%isogrk3; 
     9<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> 
     10%isopub; 
     11<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent"> 
     12%isotech; 
     13<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent"> 
     14%isonum; 
    615<!ENTITY promptidl "idl&gt;"> 
    716]> 
    8 <!-- 
    9 --> 
    10 <article lang="en"> 
    11   <title> 
    12     Get <application>SAXO</application> 
    13   </title> 
    14    
    15   <articleinfo> 
     17<article version="5.0" 
     18xmlns="http://docbook.org/ns/docbook" 
     19xmlns:xl="http://www.w3.org/1999/xlink" 
     20xmlns:xi="http://www.w3.org/2001/XInclude" 
     21xml:lang="en" 
     22xml:id="getsaxo"> 
     23 
     24  <title>Get <application>SAXO</application></title> 
     25 
     26  <info> 
    1627    <authorgroup> 
    17       <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    18       <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     28      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     29      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1930    </authorgroup> 
    2031    <keywordset> 
     
    2839        <revremark>First draft</revremark> 
    2940      </revision> 
    30     </revhistory>   
     41      <revision> 
     42        <revnumber>0.1</revnumber> 
     43        <date>April 2008</date> 
     44        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     45      </revision> 
     46    </revhistory> 
    3147   <pubdate>$Id$</pubdate> 
    32   </articleinfo> 
     48  </info> 
    3349 
    3450  <!--  1st part --> 
    3551 
    36   <sect1 id="create_saxo_env"> 
    37     <title> 
    38       Create <application>SAXO</application> environment 
    39     </title> 
     52  <sect1 xml:id="create_saxo_env"> 
     53    <title> Create <application>SAXO</application> environment </title> 
    4054    <para> 
    41       To simplify the explanation, we suppose that we install <application>SAXO</application> in your <filename class='directory'><envar>${HOME}</envar></filename>.  
     55      To simplify the explanation, we suppose that we install <application>SAXO</application> in your <filename class='directory'>${HOME}</filename>. 
    4256      We need to create 2 directories: 
    4357      <itemizedlist> 
    4458        <listitem> 
    45          <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 
     59         <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 
    4660         </simpara> 
    4761        </listitem> 
    4862        <listitem> 
    49          <simpara><filename class='directory'><envar>${HOME}</envar>/My_IDL</filename> that will contain user personal files (including modified <application>SAXO</application> files, if needed). 
     63         <simpara><filename class='directory'>${HOME}/My_IDL</filename> that will contain user personal files (including modified <application>SAXO</application> files, if needed). 
    5064         </simpara> 
    5165       </listitem> 
     
    5367    </para> 
    5468    <para> 
    55       <screen format="linespecific"> 
    56   <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput> 
     69      <screen> 
     70  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput> 
    5771  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>My_IDL</parameter></userinput> 
    5872      </screen> 
     
    6276  <!--  2nd part --> 
    6377 
    64  <sect1 id="get_saxo_files"> 
    65     <title> 
    66       Get <application>SAXO</application> files 
    67     </title> 
     78 <sect1 xml:id="get_saxo_files"> 
     79    <title> Get <application>SAXO</application> files </title> 
    6880 
    6981  <!--  2.1 --> 
    7082 
    71     <sect2 id="saxo_local"> 
    72       <title> 
    73         If you work at IDRIS, IPSL or LOCEAN 
    74       </title> 
     83    <sect2 xml:id="saxo_local"> 
     84      <title> If you work at IDRIS, IPSL or LOCEAN </title> 
    7585      <para> 
    7686        <application>SAXO</application> is already installed at 
     
    8999         </listitem> 
    90100        </itemizedlist> 
    91         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: 
     101        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: 
    92102        <variablelist> 
    93103          <varlistentry><term><emphasis role="bold">IDRIS</emphasis></term> 
    94104          <listitem><screen> 
    95   <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> 
     105  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/rech/eee/reee217/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput> 
    96106          </screen> 
    97107         </listitem> 
     
    99109          <varlistentry><term><emphasis role="bold">IPSL</emphasis></term> 
    100110          <listitem><screen> 
    101   <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/smlod/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput> 
     111  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/smlod/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput> 
    102112          </screen> 
    103113           </listitem> 
     
    105115          <varlistentry><term><emphasis role="bold">LOCEAN</emphasis></term> 
    106116          <listitem><screen> 
    107   <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/usr/home/smasson/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput> 
     117  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/usr/home/smasson/SAXO_DIR</parameter> <parameter>${HOME}/SAXO_DIR</parameter></userinput> 
    108118          </screen> 
    109119           </listitem> 
     
    115125  <!--  2.2 --> 
    116126 
    117     <sect2 id="saxo_svn"> 
    118       <title> 
    119         If <ulink url="http://subversion.tigris.org/"><application> Subversion (svn)</application></ulink> is installed on your machine 
    120       </title> 
     127    <sect2 xml:id="saxo_svn"> 
     128      <title> If <link xl:href="http://subversion.tigris.org/"><application> Subversion (svn)</application></link> is installed on your machine </title> 
    121129 <!--   2.2.1 --> 
    122       <sect3 id="saxo_svn_users"> 
    123         <title> 
    124           Regular users 
    125         </title> 
     130      <sect3 xml:id="saxo_svn_users"> 
     131        <title> Regular users </title> 
    126132      <para> 
    127133        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>: 
    128         <screen format="linespecific"> 
     134        <screen> 
    129135  <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/</parameter> <parameter>SAXO_DIR</parameter></userinput> 
    130136        </screen> 
     
    132138      <para> 
    133139        The latest revision of the <emphasis role="bold">source files</emphasis> (&szsrcsvn; Mb) can be checked out with the following command: 
    134         <screen format="linespecific"> 
     140        <screen> 
    135141  <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> 
    136142        </screen> 
     
    138144      <para> 
    139145        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: 
    140         <screen format="linespecific"> 
     146        <screen> 
    141147  <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> 
    142148        </screen> 
     
    144150      </sect3> 
    145151<!--    2.2.2 --> 
    146       <sect3 id="saxo_svn_contributors"> 
    147         <title> 
    148           Contributors 
    149         </title> 
     152      <sect3 xml:id="saxo_svn_contributors"> 
     153        <title> Contributors </title> 
    150154      <para> 
    151155        <emphasis role="bold">Contributors</emphasis> should better use the following command (and replace login by your own login): 
    152         <screen  format="linespecific"> 
     156        <screen > 
    153157  <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> 
    154158        </screen> 
     
    159163  <!--  2.3 --> 
    160164 
    161     <sect2 id="saxo_tar"> 
    162       <title> 
    163         Get <application>SAXO</application> from a tar file 
    164       </title> 
     165    <sect2 xml:id="saxo_tar"> 
     166      <title> Get <application>SAXO</application> from a tar file </title> 
    165167  <!--  2.3.1 --> 
    166       <sect3 id="saxo_src_tar"> 
    167         <title> 
    168           Get <application>SAXO</application> source files (&szsrc; Mb) 
    169         </title> 
     168      <sect3 xml:id="saxo_src_tar"> 
     169        <title> Get <application>SAXO</application> source files (&szsrc; Mb) </title> 
    170170        <para> 
    171           Create your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> directory &hellip; 
    172           <screen format="linespecific"> 
    173   <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput> 
     171          Create your <filename class='directory'>${HOME}/SAXO_DIR</filename> directory &hellip; 
     172          <screen> 
     173  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput> 
    174174  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>SAXO_DIR</parameter></userinput> 
    175175  <prompt>$</prompt> <userinput><command>cd</command> <parameter>SAXO_DIR</parameter></userinput> 
    176176          </screen> 
    177           &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  
     177          &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 
    178178        <variablelist> 
    179179          <varlistentry><term><command>wget</command></term> 
     
    191191        </variablelist>  
    192192        Untar the file 
    193         <screen format="linespecific"> 
    194   <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput> 
     193        <screen> 
     194  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}/SAXO_DIR</parameter></userinput> 
    195195  <prompt>$</prompt> <userinput><command>tar</command> <option>xvfz</option> <parameter>SAXO_SRC_&date;.tar.gz</parameter></userinput> 
    196196  <prompt>$</prompt> <userinput><command>rm</command> <parameter>SAXO_SRC_&date;.tar.gz</parameter></userinput> 
     
    200200      </sect3> 
    201201  <!--  2.3.2 --> 
    202       <sect3 id="saxo_data_tar"> 
    203         <title> 
    204           Get <application>SAXO</application> tests data files (&szdata; Mb) 
    205         </title> 
     202      <sect3 xml:id="saxo_data_tar"> 
     203        <title> Get <application>SAXO</application> tests data files (&szdata; Mb) </title> 
    206204        <para> 
    207         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  
     205        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 
    208206        <itemizedlist> 
    209207          <listitem> 
    210            <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. 
     208           <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. 
    211209           </simpara> 
    212210          </listitem> 
     
    216214          </listitem> 
    217215        </itemizedlist> 
    218         <screen format="linespecific"> 
    219   <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput> 
     216        <screen> 
     217  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}</parameter></userinput> 
    220218  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter><replaceable>CHOSEN_DIR</replaceable></parameter></userinput> 
    221219  <prompt>$</prompt> <userinput><command>cd</command> <parameter><replaceable>CHOSEN_DIR</replaceable></parameter></userinput> 
    222220        </screen> 
    223         Download <ulink url="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.tar.gz">SAXO_DATA_&date2;.tar.gz</ulink> (&szdata; Mb) 
    224         &hellip; or with  
     221        Download <link xl:href="http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.tar.gz">SAXO_DATA_&date2;.tar.gz</link> (&szdata; Mb) 
     222        &hellip; or with 
    225223        <variablelist> 
    226224          <varlistentry><term><command>wget</command></term> 
     
    242240  </sect1> 
    243241  <!--  3 --> 
    244     <sect1 id="generate_init"> 
    245       <title> 
    246         Generate your init.pro file 
    247       </title> 
     242    <sect1 xml:id="generate_init"> 
     243      <title> Generate your init.pro file </title> 
    248244      <para> 
    249245        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. 
    250246      </para> 
    251247      <para> 
    252         <screen format="linespecific"> 
    253   <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR/SRC</parameter></userinput> 
     248        <screen> 
     249  <prompt>$</prompt> <userinput><command>cd</command> <parameter>${HOME}/SAXO_DIR/SRC</parameter></userinput> 
    254250  <prompt>$</prompt> <userinput><command>idl</command></userinput> 
    255251  <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput> 
     
    266262        <itemizedlist> 
    267263          <listitem> 
    268            <simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/My_IDL</filename> 
    269            </simpara> 
    270           </listitem> 
    271           <listitem> 
    272            <simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> 
     264           <simpara>give the path of <filename class='directory'>${HOME}/My_IDL</filename> 
     265           </simpara> 
     266          </listitem> 
     267          <listitem> 
     268           <simpara>give the path of <filename class='directory'>${HOME}/SAXO_DIR</filename> 
    273269           </simpara> 
    274270          </listitem> 
     
    322318          </listitem> 
    323319        </itemizedlist> 
    324         <screen format="linespecific"> 
     320        <screen> 
    325321   <computeroutput>% Compiled module: CW_FIELD.</computeroutput> 
    326322   <computeroutput>% Compiled module: XMANAGER.</computeroutput> 
     
    335331   <prompt>&promptidl;</prompt> <userinput><command>exit</command></userinput> 
    336332        </screen> 
    337         There is an example of the kind of <ulink url="idlfiles/init_example.pro"> <filename>init.pro</filename></ulink> you should get. 
     333        There is an example of the kind of <link xl:href="idlfiles/init_example.pro"> <filename>init.pro</filename></link> you should get. 
    338334      </para> 
    339335    </sect1> 
    340 <sect1 id="aftergetsaxo"> 
     336<sect1 xml:id="aftergetsaxo"> 
    341337<title>After this</title> 
    342338<para> 
    343 You are now ready to do your  
    344 <ulink url="./firststeps.html">First steps with SAXO</ulink>. 
     339You are now ready to do your 
     340<link xl:href="./firststeps.html">First steps with SAXO</link>. 
    345341</para> 
    346342</sect1> 
  • trunk/SRC/Documentation/xmldoc/getsaxo_pre.sh

    r326 r345  
    1 #!/bin/bash -x 
     1#! /bin/sh 
     2# 
     3# module : 
     4# ++ working on getsaxo.xml before processing for HTML and wiki 
    25# 
    36# update : 
    47# $Id$ 
    58# 
    6 # ++ one day we can add accessibility check with tidy with -access 3 
    7 # diagnostics are not so good so far because tidy (HTML Tidy for Mac OS X 
    8 # released on 1 September 2005) doesn't handle carriage returns 
    9 # 
    10 # fplod 2007-06-27T11:54:26Z aedon.locean-ipsl.upmc.fr (Darwin) 
    11 # replacing saxon by xalan because of better results on callouts 
    12 # fplod 2006-09-20T16:28:32Z aedon.locean-ipsl.upmc.fr (Darwin) 
    13 # remove ?format=raw 
    14 # fplod 2006-09-18T12:53:07Z aedon.locean-ipsl.upmc.fr (Darwin) 
    15 # add status checking in xml processing 
    16 # fplod 2006-09-07T08:10:23Z aedon.locean-ipsl.upmc.fr (Darwin) 
    17 # main is rename to websaxo.html 
    18 # fplod 2006-08-29T14:01:11Z aedon.locean-ipsl.upmc.fr (Darwin) 
    19 # add main which needs xmllint processing to resolve xinclude 
    20 # fplod 2006-08-18T13:38:31Z aedon.locean-ipsl.upmc.fr (Darwin) 
    21 # add faqsaxo which needs xmllint processing to resolve xinclude 
    22 # fplod 2006-07-21T08:25:05Z aedon.locean-ipsl.upmc.fr (Darwin) 
    23 # add prerequisites for mini_notice production 
    24 # fplod 2006-07-12T11:57:24Z aedon.locean-ipsl.upmc.fr (Darwin) 
    25 # add style.css 
    26 # fplod 2006-07-11T08:25:30Z aedon.locean-ipsl.upmc.fr (Darwin) 
    27 # use of tidy and titlepage.saxo.xml 
    28 # replace /sw/share/xml/xsl/docbook-xsl/html/docbook.xsl 
    29 # by saxo_html.xsl 
    30 # fplod 2006-07-05T13:18:56Z aedon.locean-ipsl.upmc.fr (Darwin) 
    31 # add infoupdatecm 
    32 # add sort and varname in production of infoupdatekwd 
    33 # fplod 2006-06-07T13:55:07Z aedon.locean-ipsl.upmc.fr (Darwin) 
    34 # add infoupdatekwd 
    35 # fplod 2006-06-02T14:37:47Z aedon.locean-ipsl.upmc.fr (Darwin) 
    36 # take only one tar file : the most recent using modification time 
    37 # fplod 2006-06-02T10:00:41Z aedon.locean-ipsl.upmc.fr (Darwin) 
    38 # http://forge.ipsl.jussieu.fr/saxo/download/ is the new directory reference 
    39 # for tar file instead of ~/SAXO_SRC/ ie home of Sebatien Masson on 
    40 # arete.locean-ipsl.jussieu.fr 
    41 # !!! saxo@forge.ipsl.jussieu.fr password is needed 
    42 # fplod 2006-05-31T10:34:18Z aedon.locean-ipsl.upmc.fr (Darwin) 
    43 # . add creation of all_plots.html using firststeps.html 
    44 # . remplace ~/SAXO_SRC/SRC/Documentation/xmldoc/figpng by ./figpng/ 
    45 # we suppose that this shell script is launched when we are in 
    46 # <working space of saxo>/SRC/Documentation/xmldoc/ 
     9# fplod 2008-04-15T10:53:26Z aedon.locean-ipsl.upmc.fr (Darwin) 
     10# creation from makehtml.sh 
     11# adapation to docbook 5.0 
    4712# 
    4813set -u 
     14set -o posix 
    4915# 
    5016case $( whoami ) in 
    5117    smasson) 
    52         lgforge=smasson 
     18        lgforge=smasson 
    5319    ;; 
    5420    floseb) 
    55         lgforge=smasson 
     21        lgforge=smasson 
    5622    ;; 
    5723    *) 
    58         lgforge=saxo 
     24        lgforge=saxo 
    5925    ;; 
    6026esac 
    6127# 
    62 case "${1}" in 
    63    getsaxo) 
    64       # size of SRC and DATA with .svn 
    65       szallsvn=$( du -sh ../../.. | awk '{print $1}' ) 
    66       szallsvn=${szallsvn%*M} 
    67       # size of SRC with .svn 
    68       szsrcsvn=$( du -sh ../../../SRC | awk '{print $1}' ) 
    69       szsrcsvn=${szsrcsvn%*M} 
    70       # size of DATA with .svn 
    71       szdatasvn=$( du -sh ../../../DATA | awk '{print $1}' ) 
    72       szdatasvn=${szdatasvn%*M} 
    73       echo "iii : you will be asked ${lgforge}@forge.ipsl.jussieu.fr passwd two times" 
    74       # find the most recent SAXO_SRC_yyyymmddrxxx.tar.gz in 
    75       # /ipsl/forge/projets/saxo/download/ 
    76       infosrc=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_SRC_*.tar.gz  | head -n 1) 
    77       filesrc=$(echo ${infosrc} | awk '{print $NF}') 
    78       szsrc=$(echo ${infosrc} | awk '{print $5}') 
    79       # ndate is the date in the file SAXO_SRC_*.tar.gz 
    80       ndate=${filesrc##*_} 
    81       ndate=${ndate%.tar.gz} 
    82       # find the most recent SAXO_DATA_yyyymmddrxxx.tar.gz in 
    83       # /ipsl/forge/projets/saxo/download/ 
    84       infodata=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_DATA_*.tar.gz | head -n 1) 
    85       filedata=$(echo ${infodata} | awk '{print $NF}') 
    86       szdata=$(echo ${infodata} | awk '{print $5}') 
    87       # ndate2 is the date in the file SAXO_DATA_*.tar.gz 
    88       ndate2=${filedata##*_} 
    89       ndate2=${ndate2%.tar.gz} 
    90    ;; 
    91    infoupdatekwd) 
    92       grep "^  old = \[old, .* new = \[new" ../../ForOldVersion/updatekwd.pro | \ 
    93         sort | \ 
    94       sed -e "s/\( old = \[old, '\)\(.*\)\('\] *& new = \[new, '\)\(.*\)\('\]\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" > /tmp/rowskwd.xml 
    95    ;; 
    96    infoupdatecm) 
    97       grep "IF NOT key_forgetold AND n_elements(" ../../ForOldVersion/updateold.pro | \ 
    98         sort | \ 
    99       sed -e "s/\(^.* THEN \)\(.*\)\( = \)\(.*\)/<row><entry colname='old'><varname>\2<\/varname><\/entry> <entry colname='new'><varname>\4<\/varname><\/entry><\/row>/" > /tmp/rowscm.xml 
    100    ;; 
    101    mini_notice) 
    102       # production of images with frames and callouts 
    103       # ./forxxxdoc.sh 0101 
    104       # ./forxxxdoc.sh 0201 
    105    ;; 
    106    *) 
    107       echo "iii : no prerequisites needed" 
    108    ;; 
    109 esac 
    110  
    111 # figures lists 
    112 cd ./figpng 
    113  
     28# size of SRC and DATA with .svn 
     29szallsvn=$( du -sh ../../.. | awk '{print $1}' ) 
     30szallsvn=${szallsvn%*M} 
     31# size of SRC with .svn 
     32szsrcsvn=$( du -sh ../../../SRC | awk '{print $1}' ) 
     33szsrcsvn=${szsrcsvn%*M} 
     34# size of DATA with .svn 
     35szdatasvn=$( du -sh ../../../DATA | awk '{print $1}' ) 
     36szdatasvn=${szdatasvn%*M} 
    11437# 
    115 figsplt_lev="" 
    116 for i in tst_plt_lev_[0-9][0-9].png 
    117 do 
    118   figsplt_lev="${figsplt_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    119 done 
    120 figspltz_lev="" 
    121 for i in tst_pltz_lev_[0-9][0-9].png 
    122 do 
    123   figspltz_lev="${figspltz_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    124 done 
    125 figspltt_lev="" 
    126 for i in tst_pltt_lev_[0-9][0-9].png 
    127 do 
    128   figspltt_lev="${figspltt_lev} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    129 done 
     38echo "iii : you will be asked ${lgforge}@forge.ipsl.jussieu.fr passwd two times" 
    13039# 
    131 figsplt_orca2="" 
    132 for i in tst_plt_orca2_[0-9][0-9].png 
    133 do 
    134   figsplt_orca2="${figsplt_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    135 done 
    136 figspltz_orca2="" 
    137 for i in tst_pltz_orca2_[0-9][0-9].png 
    138 do 
    139   figspltz_orca2="${figspltz_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    140 done 
    141 figspltt_orca2="" 
    142 for i in tst_pltt_orca2_[0-9][0-9].png 
    143 do 
    144   figspltt_orca2="${figspltt_orca2} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    145 done 
     40# find the most recent SAXO_SRC_yyyymmddrxxx.tar.gz in 
     41# /ipsl/forge/projets/saxo/download/ 
     42infosrc=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_SRC_*.tar.gz  | head -n 1) 
     43filesrc=$(echo ${infosrc} | awk '{print $NF}') 
     44szsrc=$(echo ${infosrc} | awk '{print $5}') 
    14645# 
    147 figsplt_orca05="" 
    148 for i in tst_plt_orca05_[0-9][0-9].png 
    149 do 
    150   figsplt_orca05="${figsplt_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    151 done 
    152 figspltz_orca05="" 
    153 for i in tst_pltz_orca05_[0-9][0-9].png 
    154 do 
    155   figspltz_orca05="${figspltz_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    156 done 
    157 figspltt_orca05="" 
    158 for i in tst_pltt_orca05_[0-9][0-9].png 
    159 do 
    160   figspltt_orca05="${figspltt_orca05} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    161 done 
    162 ## 
     46# ndate is the date in the file SAXO_SRC_*.tar.gz 
     47ndate=${filesrc##*_} 
     48ndate=${ndate%.tar.gz} 
    16349# 
    164 figsplt_lev_stride="" 
    165 for i in tst_plt_lev_stride_[0-9][0-9].png 
    166 do 
    167   figsplt_lev_stride="${figsplt_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    168 done 
    169 figspltz_lev_stride="" 
    170 for i in tst_pltz_lev_stride_[0-9][0-9].png 
    171 do 
    172   figspltz_lev_stride="${figspltz_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    173 done 
    174 figspltt_lev_stride="" 
    175 for i in tst_pltt_lev_stride_[0-9][0-9].png 
    176 do 
    177   figspltt_lev_stride="${figspltt_lev_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    178 done 
     50# find the most recent SAXO_DATA_yyyymmddrxxx.tar.gz in 
     51# /ipsl/forge/projets/saxo/download/ 
     52infodata=$(ssh ${lgforge}@forge.ipsl.jussieu.fr ls -lht /ipsl/forge/projets/saxo/download/SAXO_DATA_*.tar.gz | head -n 1) 
     53filedata=$(echo ${infodata} | awk '{print $NF}') 
     54szdata=$(echo ${infodata} | awk '{print $5}') 
    17955# 
    180 figsplt_orca2_stride="" 
    181 for i in tst_plt_orca2_stride_[0-9][0-9].png 
    182 do 
    183   figsplt_orca2_stride="${figsplt_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    184 done 
    185 figspltz_orca2_stride="" 
    186 for i in tst_pltz_orca2_stride_[0-9][0-9].png 
    187 do 
    188   figspltz_orca2_stride="${figspltz_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    189 done 
    190 figspltt_orca2_stride="" 
    191 for i in tst_pltt_orca2_stride_[0-9][0-9].png 
    192 do 
    193   figspltt_orca2_stride="${figspltt_orca2_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    194 done 
     56# ndate2 is the date in the file SAXO_DATA_*.tar.gz 
     57ndate2=${filedata##*_} 
     58ndate2=${ndate2%.tar.gz} 
    19559# 
    196 figsplt_orca05_stride="" 
    197 for i in tst_plt_orca05_stride_[0-9][0-9].png 
    198 do 
    199   figsplt_orca05_stride="${figsplt_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    200 done 
    201 figspltz_orca05_stride="" 
    202 for i in tst_pltz_orca05_stride_[0-9][0-9].png 
    203 do 
    204   figspltz_orca05_stride="${figspltz_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    205 done 
    206 figspltt_orca05_stride="" 
    207 for i in tst_pltt_orca05_stride_[0-9][0-9].png 
    208 do 
    209   figspltt_orca05_stride="${figspltt_orca05_stride} \<ulink url=\"figpng\/${i}\"\>\&showfig\;\<\/ulink\>" 
    210 done 
    211 ## 
    212 cd .. # ie <working space of saxo>/SRC/Documentation/xmldoc 
    213 # 
    214 # production of titlepage.saxo.xsl 
    215 # 
    216 # si pb reseau remplacer sur mac par la ligne suivante 
    217 titlepagexsl=http://docbook.sourceforge.net/release/xsl/current/template/titlepage.xsl 
    218 titlepagexsl=/sw/share/xml/xsl/docbook-xsl/template/titlepage.xsl 
    219 # 
    220 xsltproc \ 
    221 --xinclude \ 
    222 -o titlepage.saxo.xsl \ 
    223 ${titlepagexsl} \ 
    224 titlepage.saxo.xml 
    225 status=${?} 
    226 if [ ${status} -ne 0 ] 
    227 then 
    228  echo "eee : pb xsltproc sur titlepage.saxo.xml" 
    229  exit 1 
    230 fi 
    231 # 
    232 case "${1}" in 
    233    getsaxo) 
    234       sed -e s/"\&date\;"/${ndate}/g \ 
    235           -e s/"\&date2\;"/${ndate2}/g \ 
    236           -e s/"\&szsrc\;"/${szsrc}/g \ 
    237           -e s/"\&szdata\;"/${szdata}/g \ 
    238           -e s/"\&szallsvn\;"/${szallsvn}/g \ 
    239           -e s/"\&szsrcsvn\;"/${szsrcsvn}/g \ 
    240           -e s/"\&szdatasvn\;"/${szdatasvn}/g \ 
    241           ${1}.xml > ${1}_${$}.xml 
    242    ;; 
    243    firststeps) 
    244       sed -e s/"\&figsplt_lev\;"/"${figsplt_lev}"/g \ 
    245           -e s/"\&figsplt_orca2\;"/"${figsplt_orca2}"/g \ 
    246           -e s/"\&figsplt_orca05\;"/"${figsplt_orca05}"/g \ 
    247           -e s/"\&figspltz_lev\;"/"${figspltz_lev}"/g \ 
    248           -e s/"\&figspltz_orca2\;"/"${figspltz_orca2}"/g \ 
    249           -e s/"\&figspltz_orca05\;"/"${figspltz_orca05}"/g \ 
    250           -e s/"\&figspltt_lev\;"/"${figspltt_lev}"/g \ 
    251           -e s/"\&figspltt_orca2\;"/"${figspltt_orca2}"/g \ 
    252           -e s/"\&figspltt_orca05\;"/"${figspltt_orca05}"/g \ 
    253           -e s/"\&figsplt_lev_stride\;"/"${figsplt_lev_stride}"/g \ 
    254           -e s/"\&figsplt_orca2_stride\;"/"${figsplt_orca2_stride}"/g \ 
    255           -e s/"\&figsplt_orca05_stride\;"/"${figsplt_orca05_stride}"/g \ 
    256           -e s/"\&figspltz_lev_stride\;"/"${figspltz_lev_stride}"/g \ 
    257           -e s/"\&figspltz_orca2_stride\;"/"${figspltz_orca2_stride}"/g \ 
    258           -e s/"\&figspltz_orca05_stride\;"/"${figspltz_orca05_stride}"/g \ 
    259           -e s/"\&figspltt_lev_stride\;"/"${figspltt_lev_stride}"/g \ 
    260           -e s/"\&figspltt_orca2_stride\;"/"${figspltt_orca2_stride}"/g \ 
    261           -e s/"\&figspltt_orca05_stride\;"/"${figspltt_orca05_stride}"/g \ 
    262           ${1}.xml > ${1}_${$}.xml 
    263    ;; 
    264    infoupdatekwd) 
    265       sed -e "/-- rows from updatekwd.pro --/r /tmp/rowskwd.xml" \ 
    266           ${1}.xml > ${1}_${$}.xml 
    267       /bin/rm /tmp/rowskwd.xml 
    268    ;; 
    269    infoupdatecm) 
    270       sed -e "/-- rows from updateold.pro --/r /tmp/rowscm.xml" \ 
    271           ${1}.xml > ${1}_${$}.xml 
    272       /bin/rm /tmp/rowscm.xml 
    273    ;; 
    274    faqsaxo|websaxo) 
    275       # resolve xinclude 
    276       xmllint --xinclude \ 
    277               --output ${1}_${$}.xml ${1}.xml 
    278       status=${?} 
    279       if [ ${status} -ne 0 ] 
    280       then 
    281        echo "eee : pb xmllint sur ${1}.xml" 
    282        exit 1 
    283       fi 
    284    ;; 
    285    *) 
    286       cp ${1}.xml ${1}_${$}.xml 
    287       echo "iii : no xml transformation needed" 
    288    ;; 
    289 esac 
    290 # 
    291 CLASSPATH=${CLASSPATH}:/usr/Xalan/xalan.jar:/usr/Xalan/xml-apis.jar:\ 
    292 /usr/Xalan/xercesImpl.jar:/usr/docbook-xsl/extensions/xalan25.jar 
    293 export CLASSPATH 
    294 # 
    295 java org.apache.xalan.xslt.Process -out ${1}.html -in ${1}_${$}.xml  \ 
    296 -xsl saxo_html.xsl \ 
    297 -param section.autolabel 1 \ 
    298 -param html.stylesheet "style.css saxo.css" \ 
    299 -param css.decoration 1 
    300 status=${?} 
    301 if [ ${status} -ne 0 ] 
    302 then 
    303  echo "eee : pb xalan sur ${1}_${$}.xml" 
    304  exit 1 
    305 fi 
    306 # 
    307 case "${1}" in 
    308    firststeps) 
    309       # process all_plots 
    310       java org.apache.xalan.xslt.Process -out all_plots_${$}.xml \ 
    311       -in  ${1}_${$}.xml  \ 
    312       -xsl all_plots_docbook.xsl 
    313       java org.apache.xalan.xslt.Process -out all_plots.html \ 
    314       -in  all_plots_${$}.xml \ 
    315       -xsl saxo_html.xsl \ 
    316       -param section.autolabel 1 \ 
    317       -param html.stylesheet "style.css saxo.css" \ 
    318       -param css.decoration 1 
    319       rm -f all_plots_${$}.xml 
    320       ;; 
    321    websaxo) 
    322       sed -e s?"../../saxo/browser/trunk/SRC/Documentation/xmldoc/"??g \ 
    323           -e s?"../../saxo/browser/trunk/SRC/Documentation/idldoc_html_output/"?"../idldoc_html_output/"?g \ 
    324           -e s?"../../saxo/browser/trunk"?"http://forge.ipsl.jussieu.fr/saxo/browser/trunk"?g \ 
    325           ${1}.html > ${1}_${$}.html 
    326       mv ${1}_${$}.html ${1}.html 
    327       ;; 
    328 esac 
    329 # 
    330 # use of tidy to have a W3C compliant html file 
    331 tidy -m ${1}.html 
    332 # 
    333 # clean 
    334 rm -f ${1}_${$}.xml 
    335 rm titlepage.saxo.xsl 
     60sed -e s/"\&date\;"/${ndate}/g \ 
     61    -e s/"\&date2\;"/${ndate2}/g \ 
     62    -e s/"\&szsrc\;"/${szsrc}/g \ 
     63    -e s/"\&szdata\;"/${szdata}/g \ 
     64    -e s/"\&szallsvn\;"/${szallsvn}/g \ 
     65    -e s/"\&szsrcsvn\;"/${szsrcsvn}/g \ 
     66    -e s/"\&szdatasvn\;"/${szdatasvn}/g \ 
     67    getsaxo.xml > getsaxo_sed.xml 
    33668# 
    33769# exit 
  • trunk/SRC/Documentation/xmldoc/infoupdatecm.xml

    r270 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 []> 
    5 <!-- 
    6 --> 
    7 <article> 
    8 <title>Commons update</title>  
    9   <articleinfo> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xmlns:xi="http://www.w3.org/2001/XInclude" 
     6xml:lang="en" 
     7xml:id="infoupdatecm"> 
     8<title>Commons update</title> 
     9  <info> 
    1010    <authorgroup> 
    11       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    12       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     11      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1313    </authorgroup> 
    1414    <keywordset> 
     
    2222        <revremark>First draft</revremark> 
    2323      </revision> 
    24     </revhistory>   
     24      <revision> 
     25        <revnumber>0.1</revnumber> 
     26        <date>April 2008</date> 
     27        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     28      </revision> 
     29    </revhistory> 
    2530    <pubdate>$Id$</pubdate> 
    26   </articleinfo> 
     31  </info> 
    2732 
    28 <sect1 id="intro"> 
     33<sect1 xml:id="intro"> 
    2934<title>Introduction</title> 
    3035<para> 
     
    3540</para> 
    3641</sect1> 
    37 <sect1 id="disappeared"> 
     42<sect1 xml:id="disappeared"> 
    3843<title>Commons disappeared</title> 
    3944<para> 
     
    6267</para> 
    6368</sect1> 
    64 <sect1 id="translation"> 
     69<sect1 xml:id="translation"> 
    6570<title>Commons translations</title> 
    6671<para> 
     
    7782</row> 
    7883</thead> 
    79 <tbody> 
    8084<!-- rows from updateold.pro --> 
    81 </tbody> 
     85<xi:include href="rowscm.xml" parse="xml"> 
     86 <xi:fallback> 
     87  <para><emphasis>manque fichier rowscm.xml</emphasis></para> 
     88 </xi:fallback> 
     89</xi:include> 
    8290</tgroup> 
    8391</informaltable> 
    8492</sect1> 
    85 <sect1 id="otherkind"> 
     93<sect1 xml:id="otherkind"> 
    8694<title>Commons transformations</title> 
    8795<para> 
  • trunk/SRC/Documentation/xmldoc/infoupdatekwd.xml

    r139 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 []> 
    5 <!-- 
    6 --> 
    7 <article> 
    8 <title>Keywords translation</title>  
    9   <articleinfo> 
     1<?xml version="1.0" encoding="ISO-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xmlns:xi="http://www.w3.org/2001/XInclude" 
     6xml:lang="en" 
     7xml:id="infoupdatekwd"> 
     8<title>Keywords translation</title> 
     9  <info> 
    1010    <authorgroup> 
    11       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    12       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     11      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1313    </authorgroup> 
    1414    <keywordset> 
     
    2222        <revremark>First draft</revremark> 
    2323      </revision> 
    24     </revhistory>   
     24      <revision> 
     25        <revnumber>0.1</revnumber> 
     26        <date>April 2008</date> 
     27        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     28      </revision> 
     29    </revhistory> 
    2530    <pubdate>$Id$</pubdate> 
    26   </articleinfo> 
     31  </info> 
    2732 
    28 <sect1 id="intro"> 
     33<sect1 xml:id="intro"> 
    2934<title>Introduction</title> 
    3035<para> 
     
    3540</para> 
    3641</sect1> 
    37 <sect1 id="translation"> 
     42<sect1 xml:id="translation"> 
    3843<title>Keywords translations</title> 
    3944<para> 
     
    5055</row> 
    5156</thead> 
    52 <tbody> 
    5357<!-- rows from updatekwd.pro --> 
    54 </tbody> 
     58<xi:include href="rowskwd.xml" parse="xml"> 
     59 <xi:fallback> 
     60  <para><emphasis>manque fichier rowskwd.xml</emphasis></para> 
     61 </xi:fallback> 
     62</xi:include> 
    5563</tgroup> 
    5664</informaltable> 
  • trunk/SRC/Documentation/xmldoc/mailing.xml

    r183 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 []> 
    5 <!-- 
    6 --> 
    7 <article> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xml:lang="en" 
     6xml:id="mailing"> 
     7 
    88<title>SAXO Mailing lists</title> 
    9   <articleinfo> 
     9  <info> 
    1010    <authorgroup> 
    11       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    12       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     11      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1313    </authorgroup> 
    1414    <keywordset> 
     
    1717    </keywordset> 
    1818    <revhistory> 
     19      <revision> 
     20        <revnumber>0.2</revnumber> 
     21        <date>April 2008</date> 
     22        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     23      </revision> 
    1924      <revision> 
    2025        <revnumber>0.1</revnumber> 
     
    2732        <revremark>First draft</revremark> 
    2833      </revision> 
    29     </revhistory>   
     34    </revhistory> 
    3035    <pubdate>$Id$</pubdate> 
    31   </articleinfo> 
     36  </info> 
    3237 
    33 <sect1 id="saxo-users"> 
     38<sect1 xml:id="saxo-users"> 
    3439<title>saxo-users@forge.ipsl.jussieu.fr</title> 
    3540<itemizedlist> 
    3641<listitem> 
    3742<para> 
    38 <ulink url="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-users/">Subscription</ulink> 
     43<link xl:href="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-users/">Subscription</link> 
    3944</para> 
    4045</listitem> 
    4146<listitem> 
    4247<para> 
    43 <ulink url="http://forge.ipsl.jussieu.fr/pipermail/saxo-users/">Archives</ulink> 
     48<link xl:href="http://forge.ipsl.jussieu.fr/pipermail/saxo-users/">Archives</link> 
    4449</para> 
    4550</listitem> 
    4651</itemizedlist> 
    4752</sect1> 
    48 <sect1 id="saxo-dev"> 
     53<sect1 xml:id="saxo-dev"> 
    4954<title>saxo-dev@forge.ipsl.jussieu.fr</title> 
    5055<itemizedlist> 
    5156<listitem> 
    5257<para> 
    53 <ulink url="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-dev/">Subscription</ulink> 
     58<link xl:href="http://forge.ipsl.jussieu.fr/mailman/listinfo/saxo-dev/">Subscription</link> 
    5459</para> 
    5560</listitem> 
    5661<listitem> 
    5762<para> 
    58 <ulink url="http://forge.ipsl.jussieu.fr/pipermail/saxo-dev/">Archives</ulink> 
     63<link xl:href="http://forge.ipsl.jussieu.fr/pipermail/saxo-dev/">Archives</link> 
    5964</para> 
    6065</listitem> 
  • trunk/SRC/Documentation/xmldoc/makehtml.sh

    r291 r345  
    88# released on 1 September 2005) doesn't handle carriage returns 
    99# 
     10# fplod 2008-04-16T09:02:05Z aedon.locean-ipsl.upmc.fr (Darwin) 
     11# this file is not used anymore. see makefile. 
    1012# fplod 2007-06-27T11:54:26Z aedon.locean-ipsl.upmc.fr (Darwin) 
    1113# replacing saxon by xalan because of better results on callouts 
  • trunk/SRC/Documentation/xmldoc/mini_notice.xml

    r327 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
    5 <!ENTITY hellip "&#x2026;"> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<!DOCTYPE article [ 
     3<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent"> 
     4%isolat1; 
     5<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent"> 
     6%isolat2; 
     7<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent"> 
     8%isogrk3; 
     9<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> 
     10%isopub; 
     11<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent"> 
     12%isotech; 
     13<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent"> 
     14%isonum; 
    615<!ENTITY promptidl "idl&gt;"> 
    716] 
    817> 
     18<article version="5.0" 
     19xmlns="http://docbook.org/ns/docbook" 
     20xmlns:xl="http://www.w3.org/1999/xlink" 
     21xmlns:xi="http://www.w3.org/2001/XInclude" 
     22xml:lang="en" 
     23xml:id="mini_notice"> 
    924<!-- 
    1025 
     
    1934 
    2035--> 
    21 <article lang="en"> 
    22 <title> 
    23 Mini Guide for Basic Commands in the XXX Program 
    24 </title> 
    25   <articleinfo> 
     36<title> Mini Guide for Basic Commands in the XXX Program </title> 
     37  <info> 
    2638    <authorgroup> 
    27       <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    28       <author><firstname>Albert</firstname><surname>Fisher</surname></author> 
    29       <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    30       <author><firstname>Steve</firstname><surname>Navarro</surname></author> 
     39      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     40      <author><personname><firstname>Albert</firstname> <surname>Fisher</surname></personname></author> 
     41      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     42      <author><personname><firstname>Steve</firstname> <surname>Navarro</surname></personname></author> 
    3143    </authorgroup> 
    3244    <keywordset> 
     
    6173        <revremark>Review by Sébastien Masson</revremark> 
    6274      </revision> 
     75      <revision> 
     76        <revnumber>1.2</revnumber> 
     77        <date>April 2008</date> 
     78        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     79      </revision> 
     80 
    6381     </revhistory> 
    6482     <pubdate>$Id$</pubdate> 
    65   </articleinfo> 
    66  
    67  
    68 <sect1 id="launchxxx"><title>Launching XXX</title> 
     83  </info> 
     84 
     85 
     86<sect1 xml:id="launchxxx"><title>Launching XXX</title> 
    6987 
    7088<para> 
    7189There is several ways to launch XXX which we will detail in the next sections: 
    72   <screen format="linespecific"> 
     90  <screen> 
    7391    <prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput> 
    7492    <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput> 
     
    82100</para> 
    83101 
    84 <sect2 id="launch_xxx_1"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput></title> 
     102<sect2 xml:id="launch_xxx_1"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command></userinput></title> 
    85103  <para> 
    86104    A window will open with 3 parts to consider. 
    87 <figure id="fig_xxx_0101"> 
     105<figure xml:id="fig_xxx_0101"> 
    88106<title>Window xxx 1</title> 
    89 <mediaobjectco> 
     107<mediaobject> 
    90108<imageobjectco> 
    91109<areaspec units="calspair"> 
    92 <area id="datafile" coords="500,1715 9326,3074"/> 
    93 <area id="initmethod" coords="1500,3268 8326,4919"/> 
    94 <area id="initprogram" coords="57,5145 9961,8996"/> 
     110<area xml:id="datafile" coords="500,1715 9326,3074"/> 
     111<area xml:id="initmethod" coords="1500,3268 8326,4919"/> 
     112<area xml:id="initprogram" coords="57,5145 9961,8996"/> 
    95113</areaspec> 
    96114<imageobject> 
     
    112130<textobject>[plot figpng/xxx_0101.png]</textobject> 
    113131--> 
    114 </mediaobjectco> 
     132</mediaobject> 
    115133</figure> 
    116134  </para> 
    117135 
    118 <sect3 id="datafiletxt"><title>Data file name</title> 
     136<sect3 xml:id="datafiletxt"><title>Data file name</title> 
    119137  <para> 
    120138    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. 
    121139  </para> 
    122140</sect3> 
    123 <sect3 id="initmethodtxt"><title>Grid initialization method</title> 
     141<sect3 xml:id="initmethodtxt"><title>Grid initialization method</title> 
    124142  <para> 
    125     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). 
     143    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). 
    126144  </para> 
    127145</sect3> 
    128 <sect3 id="initprogramtxt"><title>Grid initialization parameters</title> 
     146<sect3 xml:id="initprogramtxt"><title>Grid initialization parameters</title> 
    129147  <para> 
    130148    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. 
    131149By 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. 
    132     <figure id="fig_xxx_0102"> 
     150    <figure xml:id="fig_xxx_0102"> 
    133151      <title>Window xxx 1</title> 
    134       <mediaobjectco> 
    135         <imageobjectco> 
    136           <imageobject> 
    137             <imagedata fileref="figpng/xxx_0102.png"/> 
    138           </imageobject> 
    139         </imageobjectco> 
    140       </mediaobjectco> 
     152      <mediaobject> 
     153  <imageobject> 
     154    <imagedata fileref="figpng/xxx_0102.png"/> 
     155  </imageobject> 
     156      </mediaobject> 
    141157    </figure> 
    142158  </para> 
     
    147163  </para> 
    148164<para> 
    149   <figure id="fig_xxx_0103"> 
     165  <figure xml:id="fig_xxx_0103"> 
    150166      <title>Oceania at 125 meters of depth with proper grid initialization</title> 
    151         <imageobject> 
    152           <imagedata fileref="figpng/xxx_0103.png"/> 
    153         </imageobject> 
    154   </figure> 
    155 </para> 
    156 </sect3> 
    157 </sect2> 
    158  
    159 <sect2 id="launch_xxx_2"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput></title> 
     167<mediaobject> 
     168<imageobject> 
     169  <imagedata fileref="figpng/xxx_0103.png"/> 
     170</imageobject> 
     171      </mediaobject> 
     172  </figure> 
     173</para> 
     174</sect3> 
     175</sect2> 
     176 
     177<sect2 xml:id="launch_xxx_2"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>/separate</parameter></userinput></title> 
    160178<para> 
    161179This 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. 
     
    163181</sect2> 
    164182 
    165 <sect2 id="launch_xxx_3"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></title> 
     183<sect2 xml:id="launch_xxx_3"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>restore = 'file.dat'</parameter></userinput></title> 
    166184<para> 
    167185In 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> 
     
    169187</sect2> 
    170188 
    171 <sect2 id="launch_xxx_4"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter></userinput></title> 
     189<sect2 xml:id="launch_xxx_4"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter></userinput></title> 
    172190<para> 
    173191In 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: 
    174   <screen format="linespecific"> 
     192  <screen> 
    175193    <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</parameter></userinput> 
    176194  </screen> 
     
    178196</sect2> 
    179197 
    180 <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> 
     198<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> 
    181199<para> 
    182200In 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: 
    183   <screen format="linespecific"> 
     201  <screen> 
    184202    <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> 
    185203  </screen> 
     
    187205</sect2> 
    188206 
    189 <sect2 id="launch_xxx_6"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter></userinput></title> 
     207<sect2 xml:id="launch_xxx_6"><title><prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'file.nc'</parameter>, <parameter>'initgrid'</parameter></userinput></title> 
    190208<para> 
    191209In 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> 
    192   <screen format="linespecific"> 
     210  <screen> 
    193211    <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc'</parameter>, <parameter>'tst_initorca2'</parameter></userinput> 
    194212  </screen> 
     
    196214</sect2> 
    197215 
    198 <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> 
     216<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> 
    199217<para> 
    200218In 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>. 
     
    202220</sect2> 
    203221 
    204 <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> 
     222<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> 
    205223<para> 
    206224In 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>. 
     
    210228</sect1> 
    211229 
    212 <sect1 id="wigdets"><title>Description of XXX window</title> 
     230<sect1 xml:id="wigdets"><title>Description of XXX window</title> 
    213231 
    214232<para> 
     
    220238ce produit klickety est installable via fink sous mac 
    221239 --> 
    222 <figure id="fig_xxx_0201"> 
     240<figure xml:id="fig_xxx_0201"> 
    223241<title>Window xxx 2</title> 
    224 <mediaobjectco> 
     242<mediaobject> 
    225243<imageobjectco> 
    226244<areaspec units="calspair"> 
    227 <area id="plottype" coords="69,380 2261,809"/> 
    228 <area id="menu" coords="2517,380 7575,841"/> 
    229 <area id="ok" coords="116,936 1025,1365"/> 
    230 <area id="pagelayout" coords="1631,936 4498,1365"/> 
    231 <area id="variableslist" coords="4871,952 7529,1349"/> 
    232 <area id="fileslist" coords="46,1507 8018,1857"/> 
    233 <area id="commandtext" coords="46,2000 8065,2539"/> 
    234 <area id="calendar" coords="46,2682 4941,3428"/> 
    235 <area id="domdef" coords="372,3603 7179,7095"/> 
    236 <area id="specifications" coords="23,7269 8041,9206"/> 
     245<area xml:id="plottype" coords="69,380 2261,809"/> 
     246<area xml:id="menu" coords="2517,380 7575,841"/> 
     247<area xml:id="ok" coords="116,936 1025,1365"/> 
     248<area xml:id="pagelayout" coords="1631,936 4498,1365"/> 
     249<area xml:id="variableslist" coords="4871,952 7529,1349"/> 
     250<area xml:id="fileslist" coords="46,1507 8018,1857"/> 
     251<area xml:id="commandtext" coords="46,2000 8065,2539"/> 
     252<area xml:id="calendar" coords="46,2682 4941,3428"/> 
     253<area xml:id="domdef" coords="372,3603 7179,7095"/> 
     254<area xml:id="specifications" coords="23,7269 8041,9206"/> 
    237255</areaspec> 
    238256<imageobject> 
     
    275293<textobject>[plot figpng/xxx_0201.png]</textobject> 
    276294--> 
    277 </mediaobjectco> 
     295</mediaobject> 
    278296</figure> 
    279297</para> 
    280298 
    281 <sect2 id="plottypetxt"><title>Plot type list</title> 
     299<sect2 xml:id="plottypetxt"><title>Plot type list</title> 
    282300<para>Allows specification of the type of plot desired.</para> 
    283301<para> 
    284     <figure id="fig_xxx_0202"> 
     302    <figure xml:id="fig_xxx_0202"> 
    285303      <title>Different plot types available</title> 
    286           <imageobject> 
    287             <imagedata fileref="figpng/xxx_0202.png"/> 
    288           </imageobject> 
     304<mediaobject> 
     305  <imageobject> 
     306    <imagedata fileref="figpng/xxx_0202.png"/> 
     307  </imageobject> 
     308      </mediaobject> 
    289309    </figure> 
    290310</para> 
     
    296316</sect2> 
    297317 
    298 <sect2 id="menutxt"><title>The menu bar made up of 3 sub-menus</title> 
    299 <sect3 id="filesubmenu"><title><guibutton>File</guibutton> sub-menu</title> 
    300 <para> 
    301     <figure id="fig_xxx_0203"> 
     318<sect2 xml:id="menutxt"><title>The menu bar made up of 3 sub-menus</title> 
     319<sect3 xml:id="filesubmenu"><title><guibutton>File</guibutton> sub-menu</title> 
     320<para> 
     321    <figure xml:id="fig_xxx_0203"> 
    302322      <title>The File menu</title> 
    303           <imageobject> 
    304             <imagedata fileref="figpng/xxx_0203.png"/> 
    305           </imageobject> 
     323<mediaobject> 
     324  <imageobject> 
     325    <imagedata fileref="figpng/xxx_0203.png"/> 
     326  </imageobject> 
     327      </mediaobject> 
    306328    </figure> 
    307329</para> 
     
    311333The new file can be on a different grid, with different variables, with a different time base &hellip; 
    312334</para></listitem> 
    313 <listitem><para><menuchoice><guisubmenu>New XXX:</guisubmenu></menuchoice> to open a second XXX window identical to the first one.</para></listitem> 
     335<listitem><para><menuchoice><guisubmenu>New XXX:</guisubmenu></menuchoice> to open a second XXX window xml:identical to the first one.</para></listitem> 
    314336<listitem><para><menuchoice><guisubmenu>Quit:</guisubmenu></menuchoice> to close the XXX window.</para></listitem> 
    315337</itemizedlist> 
    316338</para> 
    317339</sect3> 
    318 <sect3 id="saveassubmenu"><title><guibutton>Save As</guibutton> sub-menu</title> 
    319 <para> 
    320     <figure id="fig_xxx_0204"> 
     340<sect3 xml:id="saveassubmenu"><title><guibutton>Save As</guibutton> sub-menu</title> 
     341<para> 
     342    <figure xml:id="fig_xxx_0204"> 
    321343      <title>The Save As menu</title> 
    322           <imageobject> 
    323             <imagedata fileref="figpng/xxx_0204.png"/> 
    324           </imageobject> 
     344<mediaobject> 
     345  <imageobject> 
     346    <imagedata fileref="figpng/xxx_0204.png"/> 
     347  </imageobject> 
     348      </mediaobject> 
    325349    </figure> 
    326350</para> 
     
    334358<listitem><para><menuchoice><guisubmenu>Gif:</guisubmenu></menuchoice> to save a gif of the plotting window.</para></listitem> 
    335359<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: 
    336   <screen format="linespecific"> 
     360  <screen> 
    337361<prompt>&promptidl;</prompt> <userinput>@init</userinput> 
    338362<prompt>&promptidl;</prompt> <userinput>xxx_figure</userinput> 
    339363</screen> 
    340364and I'll obtain the saved figure. 
    341   <screen format="linespecific"> 
     365  <screen> 
    342366<prompt>&promptidl;</prompt> <userinput>xxx_figure,/post</userinput> 
    343367</screen> 
    344368or 
    345   <screen format="linespecific"> 
     369  <screen> 
    346370<prompt>&promptidl;</prompt> <userinput>@ps</userinput> 
    347371</screen> 
    348372will then create a Postscript file of the figure. 
    349373</para></listitem> 
    350 <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> 
     374<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> 
    351375<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> 
    352376</itemizedlist> 
    353377</para> 
    354378</sect3> 
    355 <sect3 id="flagsubmenu"><title><guisubmenu>Flag options</guisubmenu> sub-menu</title> 
    356 <para> 
    357     <figure id="fig_xxx_0205"> 
     379<sect3 xml:id="flagsubmenu"><title><guisubmenu>Flag options</guisubmenu> sub-menu</title> 
     380<para> 
     381    <figure xml:id="fig_xxx_0205"> 
    358382      <title>The Flag Option menu</title> 
    359           <imageobject> 
    360             <imagedata fileref="figpng/xxx_0205.png"/> 
    361           </imageobject> 
     383<mediaobject> 
     384  <imageobject> 
     385    <imagedata fileref="figpng/xxx_0205.png"/> 
     386  </imageobject> 
     387      </mediaobject> 
    362388    </figure> 
    363389</para> 
     
    378404</sect2> 
    379405 
    380 <sect2 id="oktxt"><title>OK button</title> 
     406<sect2 xml:id="oktxt"><title>OK button</title> 
    381407<para>Click on this <guibutton>OK</guibutton> button is required to make a new plot appear</para> 
    382408</sect2> 
    383409 
    384 <sect2 id="pagelayouttxt"><title>Page Layout</title> 
     410<sect2 xml:id="pagelayouttxt"><title>Page Layout</title> 
    385411<para>Specify the number of columns and rows for plots on the sheet of paper.</para> 
    386412<para> 
    387     <figure id="fig_xxx_0206"> 
     413    <figure xml:id="fig_xxx_0206"> 
    388414      <title>Number of Column</title> 
    389           <imageobject> 
    390             <imagedata fileref="figpng/xxx_0206.png"/> 
    391           </imageobject> 
    392     </figure> 
    393 </para> 
    394 <para> 
    395     <figure id="fig_xxx_0206a"> 
     415<mediaobject> 
     416  <imageobject> 
     417    <imagedata fileref="figpng/xxx_0206.png"/> 
     418  </imageobject> 
     419      </mediaobject> 
     420    </figure> 
     421</para> 
     422<para> 
     423    <figure xml:id="fig_xxx_0206a"> 
    396424      <title>Example: For 2 columns and 2 rows</title> 
    397           <imageobject> 
    398             <imagedata fileref="figpng/xxx_0206a.png"/> 
    399           </imageobject> 
    400     </figure> 
    401 </para> 
    402 </sect2> 
    403  
    404 <sect2 id="variableslisttxt"><title>List of variables</title> 
     425<mediaobject> 
     426  <imageobject> 
     427    <imagedata fileref="figpng/xxx_0206a.png"/> 
     428  </imageobject> 
     429      </mediaobject> 
     430    </figure> 
     431</para> 
     432</sect2> 
     433 
     434<sect2 xml:id="variableslisttxt"><title>List of variables</title> 
    405435<para>You can choose the variable to work on.</para> 
    406436<para> 
    407     <figure id="fig_xxx_0207"> 
     437    <figure xml:id="fig_xxx_0207"> 
    408438      <title>Example of different Variables available</title> 
    409           <imageobject> 
    410             <imagedata fileref="figpng/xxx_0207.png"/> 
    411           </imageobject> 
    412     </figure> 
    413 </para> 
    414 </sect2> 
    415  
    416 <sect2 id="fileslisttxt"><title>List of open files</title> 
     439<mediaobject> 
     440  <imageobject> 
     441    <imagedata fileref="figpng/xxx_0207.png"/> 
     442  </imageobject> 
     443      </mediaobject> 
     444    </figure> 
     445</para> 
     446</sect2> 
     447 
     448<sect2 xml:id="fileslisttxt"><title>List of open files</title> 
    417449<para>You can choose the file to work on.</para> 
    418450<para> 
    419     <figure id="fig_xxx_0208"> 
     451    <figure xml:id="fig_xxx_0208"> 
    420452      <title>Example of list of open files</title> 
    421           <imageobject> 
    422             <imagedata fileref="figpng/xxx_0208.png"/> 
    423           </imageobject> 
    424     </figure> 
    425 </para> 
    426 </sect2> 
    427  
    428 <sect2 id="commandtexttxt"><title><guimenuitem>Command text</guimenuitem><!--++ textarea--></title> 
     453<mediaobject> 
     454  <imageobject> 
     455    <imagedata fileref="figpng/xxx_0208.png"/> 
     456  </imageobject> 
     457      </mediaobject> 
     458    </figure> 
     459</para> 
     460</sect2> 
     461 
     462<sect2 xml:id="commandtexttxt"><title><guimenuitem>Command text</guimenuitem><!--++ textarea--></title> 
    429463<para> 
    430464To specify in the widget part number 7 the computation you want to do on the data 
    431465<note><para>In all cases bellow, the name given to a field (a, b, c, &hellip;) is of no importance.</para></note> 
    432466</para> 
    433 <sect3 id="commandtext1"><title>Linear calculation</title> 
    434 <para> 
    435 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. 
    436 </para> 
    437 </sect3> 
    438 <sect3 id="commandtext1"><title>Any kind of computation</title> 
    439 <para> 
    440 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; 
    441 </para> 
    442 </sect3> 
    443 </sect2> 
    444  
    445 <sect2 id="calendartxt"><title>Calendar</title> 
     467<sect3 xml:id="commandtext_linear"><title>Linear calculation</title> 
     468<para> 
     469If 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. 
     470</para> 
     471</sect3> 
     472<sect3 xml:id="commandtext_anykind"><title>Any kind of computation</title> 
     473<para> 
     474If 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; 
     475</para> 
     476</sect3> 
     477</sect2> 
     478 
     479<sect2 xml:id="calendartxt"><title>Calendar</title> 
    446480<para> 
    447481The 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> 
    448482<para> 
    449     <figure id="fig_xxx_0301"> 
     483    <figure xml:id="fig_xxx_0301"> 
    450484      <title>Example: first plot in January, second plot is from January to December</title> 
    451           <imageobject> 
    452             <imagedata fileref="figpng/xxx_0301.png"/> 
    453           </imageobject> 
    454     </figure> 
    455 </para> 
    456 </sect2> 
    457  
    458 <sect2 id="domdeftxt"><title>Define the domain</title> 
     485<mediaobject> 
     486  <imageobject> 
     487    <imagedata fileref="figpng/xxx_0301.png"/> 
     488  </imageobject> 
     489      </mediaobject> 
     490    </figure> 
     491</para> 
     492</sect2> 
     493 
     494<sect2 xml:id="domdeftxt"><title>Define the domain</title> 
    459495<para> 
    460496  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. 
    461   <figure id="fig_xxx_0210"> 
     497  <figure xml:id="fig_xxx_0210_domain"> 
    462498    <title>Domain by default</title> 
     499<mediaobject> 
    463500    <imageobject> 
    464501      <imagedata fileref="figpng/xxx_0210.png"/> 
    465502    </imageobject> 
    466   </figure> 
    467   <figure id="fig_xxx_0401"> 
     503      </mediaobject> 
     504  </figure> 
     505  <figure xml:id="fig_xxx_0401"> 
    468506    <title>Change Domain area: zoom on Oceania</title> 
    469           <imageobject> 
    470             <imagedata fileref="figpng/xxx_0401.png"/> 
    471           </imageobject> 
    472   </figure> 
    473   <figure id="fig_xxx_0402"> 
     507<mediaobject> 
     508  <imageobject> 
     509    <imagedata fileref="figpng/xxx_0401.png"/> 
     510  </imageobject> 
     511      </mediaobject> 
     512  </figure> 
     513  <figure xml:id="fig_xxx_0402"> 
    474514    <title>This configuration give us:</title> 
     515<mediaobject> 
    475516    <imageobject> 
    476517      <imagedata fileref="figpng/xxx_0402.png"/> 
    477518    </imageobject> 
    478   </figure> 
    479   <figure id="fig_xxx_0403"> 
     519      </mediaobject> 
     520  </figure> 
     521  <figure xml:id="fig_xxx_0403"> 
    480522    <title>Change depth area: between depth 125 and 126</title> 
     523<mediaobject> 
    481524    <imageobject> 
    482525      <imagedata fileref="figpng/xxx_0403.png"/> 
    483526    </imageobject> 
    484   </figure> 
    485   <figure id="fig_xxx_0404"> 
     527      </mediaobject> 
     528  </figure> 
     529  <figure xml:id="fig_xxx_0404"> 
    486530    <title>temperature of the ocean at depth 125 meters without proper land/sea mask</title> 
     531<mediaobject> 
    487532    <imageobject> 
    488533      <imagedata fileref="figpng/xxx_0404.png"/> 
    489534    </imageobject> 
     535      </mediaobject> 
    490536  </figure> 
    491537  As you can see, at this depth, we better define a land/sea mask when loading the grid. Cf <xref linkend="fig_xxx_0103"/> 
     
    493539</sect2> 
    494540 
    495 <sect2 id="specificationstxt"><title>Specify your plot</title> 
    496  
    497 <sect3 id="minmaxintervaltxt"><title>Specify min, max and contour interval</title> 
    498 <para> 
    499   <figure id="fig_xxx_0501"> 
     541<sect2 xml:id="specificationstxt"><title>Specify your plot</title> 
     542 
     543<sect3 xml:id="minmaxintervaltxt"><title>Specify min, max and contour interval</title> 
     544<para> 
     545  <figure xml:id="fig_xxx_0501"> 
    500546    <title>min, max, and contour interval specifications</title> 
     547<mediaobject> 
    501548    <imageobject> 
    502549      <imagedata fileref="figpng/xxx_0501.png"/> 
    503550    </imageobject> 
     551      </mediaobject> 
    504552  </figure> 
    505553  You can restore configuration by default by pressing the <menuchoice><guibutton>Default</guibutton></menuchoice> button. 
    506   <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> 
    507 </para> 
    508 </sect3> 
    509  
    510 <sect3 id="colortxt"><title>Specify the palette to be used</title> 
     554  <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> 
     555</para> 
     556</sect3> 
     557 
     558<sect3 xml:id="colortxt"><title>Specify the palette to be used</title> 
    511559<para>For the color palette, you can either specify the name or go search for one among the palettes available.</para> 
    512560<para> 
    513     <figure id="fig_xxx_0502"> 
     561    <figure xml:id="fig_xxx_0502"> 
    514562      <title>The Color menu</title> 
    515           <imageobject> 
    516             <imagedata fileref="figpng/xxx_0502.png"/> 
    517           </imageobject> 
    518     </figure> 
    519 </para> 
    520 </sect3> 
    521  
    522 <sect3 id="kwdtxt"><title>Add any keyword</title> 
     563<mediaobject> 
     564  <imageobject> 
     565    <imagedata fileref="figpng/xxx_0502.png"/> 
     566  </imageobject> 
     567      </mediaobject> 
     568    </figure> 
     569</para> 
     570</sect3> 
     571 
     572<sect3 xml:id="kwdtxt"><title>Add any keyword</title> 
    523573<para> 
    524574  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. 
    525   <figure id="fig_xxx_0209"> 
     575  <figure xml:id="fig_xxx_0209"> 
    526576    <title>Without any additional keyword</title> 
     577<mediaobject> 
    527578    <imageobject> 
    528579      <imagedata fileref="figpng/xxx_0209.png"/> 
    529580    </imageobject> 
    530   </figure> 
    531   <figure id="fig_xxx_0210a"> 
     581      </mediaobject> 
     582  </figure> 
     583  <figure xml:id="fig_xxx_0210a"> 
    532584    <title>Add <varname>/realcont</varname> keyword</title> 
     585<mediaobject> 
    533586    <imageobject> 
    534587      <imagedata fileref="figpng/xxx_0210a.png"/> 
    535588    </imageobject> 
    536   </figure> 
    537   <figure id="fig_xxx_0210"> 
     589      </mediaobject> 
     590  </figure> 
     591  <figure xml:id="fig_xxx_0210_realcont"> 
    538592    <title>Graphic with <varname>/realcont</varname> keyword</title> 
     593<mediaobject> 
    539594    <imageobject> 
    540595      <imagedata fileref="figpng/xxx_0210.png"/> 
    541596    </imageobject> 
    542   </figure> 
    543   <figure id="fig_xxx_0211a"> 
     597      </mediaobject> 
     598  </figure> 
     599  <figure xml:id="fig_xxx_0211a"> 
    544600    <title>Add <userinput>/realcont, map=[90,0,0], /ortho, cell_fill=2</userinput> keywords</title> 
     601<mediaobject> 
    545602    <imageobject> 
    546603      <imagedata fileref="figpng/xxx_0211a.png"/> 
    547604    </imageobject> 
    548   </figure> 
    549   <figure id="fig_xxx_0211"> 
     605      </mediaobject> 
     606  </figure> 
     607  <figure xml:id="fig_xxx_0211"> 
    550608    <title>Graphic with <literal>/realcont, map=[90,0,0], /ortho, cell_fill=2</literal> keywords</title> 
     609<mediaobject> 
    551610    <imageobject> 
    552611      <imagedata fileref="figpng/xxx_0211.png"/> 
    553612    </imageobject> 
     613      </mediaobject> 
    554614  </figure> 
    555615</para> 
     
    558618</sect1> 
    559619 
    560 <sect1 id="mouseactions"><title>Mouse Actions</title> 
    561  
    562 <sect2 id="mouse"><title>In the graphics window on a horizontal plot</title> 
     620<sect1 xml:id="mouseactions"><title>Mouse Actions</title> 
     621 
     622<sect2 xml:id="mouse"><title>In the graphics window on a horizontal plot</title> 
    563623<para> 
    564624Select a domain and select the horizontal plot (<constant>plt</constant>), vertical plot 
     
    586646<para> 
    587647<itemizedlist> 
    588 <listitem><para> 
    589     <figure id="fig_mousell"> 
     648<listitem> 
     649<para> 
     650    <figure xml:id="fig_mousell"> 
    590651      <title><abbrev>LCL</abbrev>---><constant>plt</constant></title> 
    591       <mediaobjectco> 
    592         <imageobjectco> 
    593           <imageobject> 
    594             <imagedata fileref="figpng/xxx_mousell.png"/> 
    595           </imageobject> 
    596         </imageobjectco> 
    597       </mediaobjectco> 
    598     </figure> 
    599 <para> 
    600     <figure id="fig_xxx_0701"> 
     652      <mediaobject> 
     653  <imageobject> 
     654    <imagedata fileref="figpng/xxx_mousell.png"/> 
     655  </imageobject> 
     656      </mediaobject> 
     657    </figure> 
     658</para> 
     659<para> 
     660    <figure xml:id="fig_xxx_0701"> 
    601661      <title>Horizontal Plot</title> 
    602           <imageobject> 
    603             <imagedata fileref="figpng/xxx_0701.png"/> 
    604           </imageobject> 
    605     </figure> 
    606 </para> 
    607  
    608 </para></listitem> 
    609 <listitem><para> 
    610     <figure id="fig_mouselm"> 
     662      <mediaobject> 
     663  <imageobject> 
     664    <imagedata fileref="figpng/xxx_0701.png"/> 
     665  </imageobject> 
     666      </mediaobject> 
     667    </figure> 
     668</para> 
     669 
     670</listitem> 
     671<listitem> 
     672<para> 
     673    <figure xml:id="fig_mouselm"> 
    611674      <title><abbrev>LCM</abbrev>---><constant>pltz</constant></title> 
    612       <mediaobjectco> 
    613         <imageobjectco> 
    614           <imageobject> 
    615             <imagedata fileref="figpng/xxx_mouselm.png"/> 
    616           </imageobject> 
    617         </imageobjectco> 
    618       </mediaobjectco> 
    619     </figure> 
    620 <para> 
    621     <figure id="fig_xxx_0702"> 
     675      <mediaobject> 
     676  <imageobject> 
     677    <imagedata fileref="figpng/xxx_mouselm.png"/> 
     678  </imageobject> 
     679      </mediaobject> 
     680    </figure> 
     681</para> 
     682<para> 
     683    <figure xml:id="fig_xxx_0702"> 
    622684      <title>Vertical Plot</title> 
    623           <imageobject> 
    624             <imagedata fileref="figpng/xxx_0702.png"/> 
    625           </imageobject> 
    626     </figure> 
    627 </para> 
    628  
    629 </para></listitem> 
    630 <listitem><para> 
    631     <figure id="fig_mouselr"> 
     685      <mediaobject> 
     686  <imageobject> 
     687    <imagedata fileref="figpng/xxx_0702.png"/> 
     688  </imageobject> 
     689      </mediaobject> 
     690    </figure> 
     691</para> 
     692 
     693</listitem> 
     694<listitem> 
     695<para> 
     696    <figure xml:id="fig_mouselr"> 
    632697      <title><abbrev>LCR</abbrev>---><constant>pltt</constant></title> 
    633       <mediaobjectco> 
    634         <imageobjectco> 
    635           <imageobject> 
    636             <imagedata fileref="figpng/xxx_mouselr.png"/> 
    637           </imageobject> 
    638         </imageobjectco> 
    639       </mediaobjectco> 
    640     </figure> 
    641 <para> 
    642     <figure id="fig_xxx_0703"> 
     698      <mediaobject> 
     699  <imageobject> 
     700    <imagedata fileref="figpng/xxx_mouselr.png"/> 
     701  </imageobject> 
     702      </mediaobject> 
     703    </figure> 
     704</para> 
     705<para> 
     706    <figure xml:id="fig_xxx_0703"> 
    643707      <title>Common hovmoeller for xt and yt cuts</title> 
    644           <imageobject> 
    645             <imagedata fileref="figpng/xxx_0703.png"/> 
    646           </imageobject> 
    647     </figure> 
    648 </para> 
    649  
    650 </para></listitem> 
     708      <mediaobject> 
     709  <imageobject> 
     710    <imagedata fileref="figpng/xxx_0703.png"/> 
     711  </imageobject> 
     712      </mediaobject> 
     713    </figure> 
     714</para> 
     715 
     716</listitem> 
    651717</itemizedlist> 
    652718</para> 
     
    655721 
    656722</sect2> 
    657 <sect2 id="multipleplots"><title>Create multiple plots on the same sheet and make them interact</title> 
     723<sect2 xml:id="multipleplots"><title>Create multiple plots on the same sheet and make them interact</title> 
    658724 
    659725<para> 
     
    664730<para> 
    665731To create a plot in another frame double-click in the frame with the 
    666 <mousebutton>middle</mousebutton> button (<abbrev><keycombo action="double-click"><mousebutton>DCM</mousebutton></keycombo></abbrev>). 
     732<mousebutton>middle</mousebutton> button (<keycombo action="double-click"><mousebutton>DCM</mousebutton></keycombo>). 
    667733A black dotted frame will surround the designated frame, the <quote>target</quote> frame. 
    668734A black frame will surround the first plot. 
     
    676742<para>In summary: </para> 
    677743<itemizedlist> 
    678 <listitem><para> 
    679     <figure id="fig_mousedl"> 
     744<listitem> 
     745<para> 
     746    <figure xml:id="fig_mousedl"> 
    680747      <title><abbrev>DCL</abbrev>---><quote>reference</quote> frame</title> 
    681       <mediaobjectco> 
    682         <imageobjectco> 
    683           <imageobject> 
    684             <imagedata fileref="figpng/xxx_mousedl.png"/> 
    685           </imageobject> 
    686         </imageobjectco> 
    687       </mediaobjectco> 
    688     </figure> 
    689 <para> 
    690     <figure id="fig_xxx_0801"> 
     748      <mediaobject> 
     749  <imageobject> 
     750    <imagedata fileref="figpng/xxx_mousedl.png"/> 
     751  </imageobject> 
     752      </mediaobject> 
     753    </figure> 
     754</para> 
     755<para> 
     756    <figure xml:id="fig_xxx_0801"> 
    691757      <title>The reference frame is selected</title> 
    692           <imageobject> 
    693             <imagedata fileref="figpng/xxx_0801.png"/> 
    694           </imageobject> 
    695     </figure> 
    696 </para> 
    697  
    698 </para></listitem> 
    699 <listitem><para> 
    700     <figure id="fig_mousedm"> 
     758      <mediaobject> 
     759  <imageobject> 
     760    <imagedata fileref="figpng/xxx_0801.png"/> 
     761  </imageobject> 
     762      </mediaobject> 
     763    </figure> 
     764</para> 
     765 
     766</listitem> 
     767<listitem> 
     768<para> 
     769    <figure xml:id="fig_mousedm"> 
    701770      <title><abbrev>DCM</abbrev>---><quote>target</quote> frame</title> 
    702       <mediaobjectco> 
    703         <imageobjectco> 
    704           <imageobject> 
    705             <imagedata fileref="figpng/xxx_mousedm.png"/> 
    706           </imageobject> 
    707         </imageobjectco> 
    708       </mediaobjectco> 
    709     </figure> 
    710 <para> 
    711     <figure id="fig_xxx_0802"> 
     771      <mediaobject> 
     772  <imageobject> 
     773    <imagedata fileref="figpng/xxx_mousedm.png"/> 
     774  </imageobject> 
     775      </mediaobject> 
     776    </figure> 
     777</para> 
     778<para> 
     779    <figure xml:id="fig_xxx_0802"> 
    712780      <title>The target frame is selected</title> 
    713           <imageobject> 
    714             <imagedata fileref="figpng/xxx_0802.png"/> 
    715           </imageobject> 
    716     </figure> 
    717 </para> 
    718 </para></listitem> 
    719 <listitem><para> 
    720     <figure id="fig_mousedr"> 
     781      <mediaobject> 
     782  <imageobject> 
     783    <imagedata fileref="figpng/xxx_0802.png"/> 
     784  </imageobject> 
     785      </mediaobject> 
     786    </figure> 
     787</para> 
     788</listitem> 
     789<listitem> 
     790<para> 
     791    <figure xml:id="fig_mousedr"> 
    721792      <title><abbrev>DCR</abbrev>--->erase the frame</title> 
    722       <mediaobjectco> 
    723         <imageobjectco> 
    724           <imageobject> 
    725             <imagedata fileref="figpng/xxx_mousedr.png"/> 
    726           </imageobject> 
    727         </imageobjectco> 
    728       </mediaobjectco> 
    729     </figure> 
    730  
    731 </para></listitem> 
     793      <mediaobject> 
     794  <imageobject> 
     795    <imagedata fileref="figpng/xxx_mousedr.png"/> 
     796  </imageobject> 
     797      </mediaobject> 
     798    </figure> 
     799 
     800</para> 
     801</listitem> 
    732802</itemizedlist> 
    733803<para>Here's a series of commands to show how this works.</para> 
     
    736806<para> 
    737807load xxx with the command: 
    738   <screen format="linespecific"> 
     808  <screen> 
    739809    <prompt>&promptidl;</prompt> <userinput><command>xxx</command>, <parameter>'Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc'</parameter>, <parameter>'tst_initorca05'</parameter></userinput> 
    740810  </screen> 
     
    763833</para> 
    764834<para> 
    765     <figure id="fig_xxx_0901"> 
     835    <figure xml:id="fig_xxx_0901"> 
    766836      <title>Frame with four plot</title> 
    767           <imageobject> 
    768             <imagedata fileref="figpng/xxx_0901.png"/> 
    769           </imageobject> 
     837      <mediaobject> 
     838  <imageobject> 
     839    <imagedata fileref="figpng/xxx_0901.png"/> 
     840  </imageobject> 
     841      </mediaobject> 
    770842    </figure> 
    771843</para> 
     
    785857Add the keyword 
    786858<literallayout>/nocontour</literallayout> 
    787 <para> 
    788     <figure id="fig_xxx_0902a"> 
     859</para> 
     860<para> 
     861    <figure xml:id="fig_xxx_0902a"> 
    789862      <title>Command text area</title> 
    790           <imageobject> 
    791             <imagedata fileref="figpng/xxx_0902a.png"/> 
    792           </imageobject> 
    793     </figure> 
    794 </para> 
     863      <mediaobject> 
     864  <imageobject> 
     865    <imagedata fileref="figpng/xxx_0902a.png"/> 
     866  </imageobject> 
     867      </mediaobject> 
     868    </figure> 
    795869</para> 
    796870</step> 
     
    800874</para> 
    801875<para> 
    802     <figure id="fig_xxx_0902"> 
     876    <figure xml:id="fig_xxx_0902"> 
    803877      <title>The fourth plot with the keyword "nocontour"</title> 
    804           <imageobject> 
    805             <imagedata fileref="figpng/xxx_0902.png"/> 
    806           </imageobject> 
     878      <mediaobject> 
     879  <imageobject> 
     880    <imagedata fileref="figpng/xxx_0902.png"/> 
     881  </imageobject> 
     882      </mediaobject> 
    807883    </figure> 
    808884</para> 
     
    833909</para> 
    834910<para> 
    835     <figure id="fig_xxx_0903"> 
     911    <figure xml:id="fig_xxx_0903"> 
    836912      <title>Frame with five plot</title> 
    837           <imageobject> 
    838             <imagedata fileref="figpng/xxx_0903.png"/> 
    839           </imageobject> 
     913      <mediaobject> 
     914  <imageobject> 
     915    <imagedata fileref="figpng/xxx_0903.png"/> 
     916  </imageobject> 
     917      </mediaobject> 
    840918    </figure> 
    841919</para> 
     
    844922</sect2> 
    845923</sect1> 
    846 <sect1 id="crash"><title>What should I do when it breakdown</title> 
     924<sect1 xml:id="crash"><title>What should I do when it breakdown</title> 
    847925 
    848926<para> 
     
    851929<para> 
    852930In the IDL window type (as many time you click on a button since a problem occurs in xxx !!!), 
    853   <screen format="linespecific"> 
     931  <screen> 
    854932<prompt>&promptidl;</prompt> <userinput>retall</userinput> 
    855933</screen> 
     
    858936<para> 
    859937in the IDL window, type 
    860   <screen format="linespecific"> 
     938  <screen> 
    861939<prompt>&promptidl;</prompt> <userinput>domdef</userinput> 
    862940</screen> 
     
    880958overflow. 
    881959To clean up this memory: 
    882   <screen format="linespecific"> 
     960  <screen> 
    883961<prompt>&promptidl;</prompt> <userinput>ptr_free, ptr_valid()</userinput> 
    884962</screen> 
  • trunk/SRC/Documentation/xmldoc/savesaxo.sh

    r327 r345  
    33# update : 
    44# $Id$ 
     5# fplod 2008-04-16T09:02:45Z aedon.locean-ipsl.upmc.fr (Darwin) 
     6# html files produced from DocBook files are now produced using makefile 
     7# instead of makehtml.sh 
    58# fplod 2007-08-21T09:29:04Z aedon.locean-ipsl.upmc.fr (Darwin) 
    69# follow changes of calling sequence of pro2href.sh 
     
    101104set -u 
    102105# 
    103 docompileall=1 
    104 dohtml=0 
     106docompileall=0 
     107dohtml=1 
    105108dooldtest=0 
    106109doidlwavedoc=0 
     
    208211# 
    209212    cd ${memopwd} 
    210     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 
    211     do 
    212       ./makehtml.sh $(basename ${docxml} .xml) 
    213       status=${?} 
    214       if [ ${status} -ne 0 ] 
    215       then 
    216        echo "eee : pb with makehtml.sh $(basename ${docxml} .xml)" 
    217        exit 1 
    218       fi 
    219     done 
     213    make clean 
     214    make html  
     215    make dbkcheck 
    220216fi 
    221217#------------------------------------------------------------------ 
     
    523519    scp ${localtarbase}/SAXO_*.tar.gz ${lgforge}@forge.ipsl.jussieu.fr:/ipsl/forge/projets/saxo/download/ 
    524520    echo "iii : do not forget to update getsaxo.html" 
    525     echo "iii : \$ ./makehtml.sh getsaxo" 
     521    echo "iii : \$ make ./getsaxo.html" 
    526522    echo "iii : do not forget to clean ${localtarbase}" 
    527523fi 
  • trunk/SRC/Documentation/xmldoc/saxo_html.xsl

    r139 r345  
    11<?xml version='1.0' encoding='ISO-8859-1'?>  
     2<xsl:stylesheet 
     3version="1.0" 
     4xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 
    25<!-- 
    36module : 
     
    1417et mettre pubdate 
    1518--> 
    16 <xsl:stylesheet  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  version="1.0">  
    1719 
    1820<!-- if there is some trouble with network, you can replace the following line 
    1921by this one on Mac 
     22--> 
    2023<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/> 
     24 
     25<!-- for Mac without network  
     26<xsl:import href="/sw/share/xml/xsl/docbook-xsl/html/docbook.xsl"/> 
    2127--> 
    22  
    23  
    24 <xsl:import href="/sw/share/xml/xsl/docbook-xsl/html/docbook.xsl"/> 
    25 <!-- 
    2628<xsl:output method="xml" 
    2729encoding="utf-8" 
     
    3032doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" 
    3133doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/> 
    32 --> 
    3334 
    3435<xsl:include href="titlepage.saxo.xsl"/> 
  • trunk/SRC/Documentation/xmldoc/tiplink.xml

    r183 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 []> 
    5 <!-- 
    6 --> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xml:lang="en" 
     6xml:id="tiplink"> 
    77 
    8 <article> 
    98<title>Tips and Links</title> 
    10   <articleinfo> 
     9  <info> 
    1110    <authorgroup> 
    12       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    13       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     11      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1413    </authorgroup> 
    1514    <keywordset> 
     
    1918    <revhistory> 
    2019      <revision> 
     20        <revnumber>0.1</revnumber> 
     21        <date>April 2008</date> 
     22        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     23      </revision> 
     24 
     25      <revision> 
    2126        <revnumber>0.0</revnumber> 
    2227        <date>May 2006</date> 
    2328        <revremark>First draft</revremark> 
    2429      </revision> 
    25     </revhistory>   
     30    </revhistory> 
    2631    <pubdate>$Id$</pubdate> 
    27   </articleinfo> 
     32  </info> 
    2833 
    2934 
    30 <sect1 id="tips"> 
     35<sect1 xml:id="tips"> 
    3136  <title>Tips</title> 
    3237  <para> 
     
    3439    <itemizedlist> 
    3540      <listitem><simpara> 
    36         <ulink url="http://www.dfanning.com/misc_tips/cursor_on_mac.html">Using the Cursor Command on a Macintosh</ulink> 
     41        <link xl:href="http://www.dfanning.com/misc_tips/cursor_on_mac.html">Using the Cursor Command on a Macintosh</link> 
    3742      </simpara></listitem> 
    3843      <listitem><simpara> 
    39         <ulink url="http://www.dfanning.com/widget_tips/mousewheel.html">Using the Mouse Wheel in UNIX Widgets</ulink> 
     44        <link xl:href="http://www.dfanning.com/widget_tips/mousewheel.html">Using the Mouse Wheel in UNIX Widgets</link> 
    4045      </simpara></listitem> 
    4146    </itemizedlist> 
    4247  </para> 
    4348  <para> 
    44     More can been find on <ulink url="http://www.dfanning.com/documents/tips.html"/> 
     49    More can been find on <link xl:href="http://www.dfanning.com/documents/tips.html"/> 
    4550  </para> 
    4651</sect1> 
    4752 
    48 <sect1 id="links"> 
     53<sect1 xml:id="links"> 
    4954  <title>Links</title> 
    5055  <para> 
    5156    <itemizedlist> 
    5257      <listitem><simpara> 
    53         <ulink url="http://www.dfanning.com/">David Fanning</ulink> web page 
     58        <link xl:href="http://www.dfanning.com/">David Fanning</link> web page 
    5459      </simpara></listitem> 
    5560      <listitem><simpara> 
    56         <ulink url="http://www.talkaboutprogramming.com/group/comp.lang.idl-pvwave/">IDL-PVWAVE news group</ulink> 
     61        <link xl:href="http://www.talkaboutprogramming.com/group/comp.lang.idl-pvwave/">IDL-PVWAVE news group</link> 
    5762      </simpara></listitem> 
    5863      <listitem><simpara> 
    59         <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> 
     64        <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> 
    6065      </simpara></listitem> 
    6166      <listitem><simpara> 
    62         <ulink url="http://iacweb.ethz.ch/staff/dominik/hiphop/">Handy IDL-Program for HDF-Output Plotting from Dominik Brunner</ulink> 
     67        <link xl:href="http://iacweb.ethz.ch/staff/dominik/hiphop/">Handy IDL-Program for HDF-Output Plotting from Dominik Brunner</link> 
    6368      </simpara></listitem> 
    6469    </itemizedlist> 
    6570  </para> 
    6671</sect1> 
    67  
    68  
    6972</article> 
  • trunk/SRC/Documentation/xmldoc/updatesaxo.xml

    r188 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
    5 ]> 
    6 <!-- 
    7 --> 
    8 <article lang="en"> 
    9   <title> 
    10     Update <application>SAXO</application> 
    11   </title> 
    12    
    13   <articleinfo> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xml:lang="en" 
     6xml:id="updatesaxo"> 
     7 
     8  <title> Update <application>SAXO</application> </title> 
     9 
     10  <info> 
    1411    <authorgroup> 
    15       <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    16       <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     13      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1714    </authorgroup> 
    1815    <keywordset> 
     
    2219    <revhistory> 
    2320      <revision> 
     21        <revnumber>0.1</revnumber> 
     22        <date>April 2008</date> 
     23        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     24      </revision> 
     25      <revision> 
    2426        <revnumber>0.0</revnumber> 
    2527        <date>May 2006</date> 
    2628        <revremark>First draft</revremark> 
    2729      </revision> 
    28     </revhistory>   
     30    </revhistory> 
    2931    <pubdate>$Id$</pubdate> 
    30   </articleinfo> 
     32  </info> 
    3133 
    3234 
    33     <sect1 id="saxo_local"> 
    34       <title> 
    35         If you work at IDRIS, IPSL or LOCEAN 
    36       </title> 
     35    <sect1 xml:id="saxo_local"> 
     36      <title> If you work at IDRIS, IPSL or LOCEAN </title> 
    3737      <para> 
    38         If you <ulink url="./getsaxo.html#saxo_local">linked</ulink> your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> to 
     38        If you <link xl:href="./getsaxo.html#saxo_local">linked</link> your <filename class="directory">${HOME}/SAXO_DIR</filename> to 
    3939        <itemizedlist> 
    40           <listitem><simpara>IDRIS, on rhodes: <filename class='directory'>/home/rech/eee/reee217/SAXO_DIR</filename></simpara></listitem> 
    41           <listitem><simpara>IPSL: <filename class='directory'>/home/smlod/SAXO_DIR</filename></simpara></listitem> 
    42           <listitem><simpara>LOCEAN: <filename class='directory'>/usr/home/smasson/SAXO_DIR</filename></simpara></listitem> 
     40          <listitem><simpara>IDRIS, on rhodes: <filename class="directory">/home/rech/eee/reee217/SAXO_DIR</filename></simpara></listitem> 
     41          <listitem><simpara>IPSL: <filename class="directory">/home/smlod/SAXO_DIR</filename></simpara></listitem> 
     42          <listitem><simpara>LOCEAN: <filename class="directory">/usr/home/smasson/SAXO_DIR</filename></simpara></listitem> 
    4343        </itemizedlist> 
    44         your are always using the up-to-date version of SAXO. There is nothing to do. 
     44        you are always using the up-to-date version of SAXO. There is nothing to do. 
    4545      </para> 
    4646    </sect1> 
     
    4848  <!--  2 --> 
    4949 
    50     <sect1 id="saxo_svn"> 
    51       <title> 
    52         If you got SAXO with <ulink url="./getsaxo.html#saxo_svn"><application> Subversion (svn)</application></ulink> 
    53       </title> 
     50    <sect1 xml:id="saxo_svn"> 
     51      <title> If you got SAXO with <link xl:href="./getsaxo.html#saxo_svn"><application> Subversion (svn)</application></link> </title> 
    5452      <para> 
    55         You can check the status of your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> with the following command: 
    56         <screen format="linespecific"> 
    57   <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename></parameter></userinput> 
     53        You can check the status of your <filename class="directory">${HOME}/SAXO_DIR</filename> with the following command: 
     54        <screen> 
     55  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <filename class="directory">${HOME}/SAXO_DIR</filename></userinput> 
    5856        </screen> 
    59         Or, for example, if you only want to check the status of <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename> directory 
    60         <screen format="linespecific"> 
    61   <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> 
     57        Or, for example, if you only want to check the status of <filename class="directory">${HOME}/SAXO_DIR/SRC</filename> directory 
     58        <screen> 
     59  <prompt>$</prompt> <userinput><command>svn</command> <option>status</option> <option>-u</option> <filename class="directory">${HOME}/SAXO_DIR/SRC</filename></userinput> 
    6260        </screen> 
    63         You can update your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> with the following command: 
    64         <screen format="linespecific"> 
    65   <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename></parameter></userinput> 
     61        You can update your <filename class="directory">${HOME}/SAXO_DIR</filename> with the following command: 
     62        <screen> 
     63  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <filename class="directory">${HOME}/SAXO_DIR</filename></userinput> 
    6664        </screen> 
    67         Or, for example, if you only want to update <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename> directory 
    68         <screen format="linespecific"> 
    69   <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <parameter><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR/SRC</filename></parameter></userinput> 
     65        Or, for example, if you only want to update <filename class="directory">${HOME}/SAXO_DIR/SRC</filename> directory 
     66        <screen> 
     67  <prompt>$</prompt> <userinput><command>svn</command> <option>update</option> <filename class="directory">${HOME}/SAXO_DIR/SRC</filename></userinput> 
    7068        </screen> 
    7169        For a quick help on <userinput>svn status</userinput> and <userinput>svn update</userinput> see 
    72         <screen format="linespecific"> 
     70        <screen> 
    7371  <prompt>$</prompt> <userinput><command>svn</command> <option>help</option> <parameter>status</parameter></userinput> 
    7472  <prompt>$</prompt> <userinput><command>svn</command> <option>help</option> <parameter>update</parameter></userinput> 
     
    7977  <!--  3 --> 
    8078 
    81     <sect1 id="saxo_tar"> 
    82       <title> 
    83         If you got SAXO from a <ulink url="./getsaxo.html#saxo_src_tar">tar file</ulink> 
    84       </title> 
     79    <sect1 xml:id="saxo_tar"> 
     80      <title> If you got SAXO from a <link xl:href="./getsaxo.html#saxo_src_tar">tar file</link> </title> 
    8581      <para> 
    86         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>. 
    87       </para>   
     82        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>. 
     83      </para> 
    8884    </sect1> 
    8985 
  • trunk/SRC/Documentation/xmldoc/websaxo.xml

    r289 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 [ 
    5 <!ENTITY hellip "&#x2026;"> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<!DOCTYPE article [ 
     3<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent"> 
     4%isolat1; 
     5<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent"> 
     6%isolat2; 
     7<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent"> 
     8%isogrk3; 
     9<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> 
     10%isopub; 
     11<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent"> 
     12%isotech; 
     13<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent"> 
     14%isonum; 
    615]> 
    7 <article> 
    8 <!-- 
    9 --> 
     16<article version="5.0" 
     17xmlns="http://docbook.org/ns/docbook" 
     18xmlns:xl="http://www.w3.org/1999/xlink" 
     19xmlns:xi="http://www.w3.org/2001/XInclude" 
     20xml:lang="en" 
     21xml:id="websaxo"> 
     22 
    1023<!-- 
    1124 do not forget to modify WikiStart page if you modify this file 
    1225--> 
    13 <title>Main page of SAXO</title>  
    14   <articleinfo> 
     26<title>Main page of SAXO</title> 
     27  <info> 
    1528    <authorgroup> 
    16       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    17       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     29      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     30      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1831    </authorgroup> 
    1932    <keywordset> 
     
    3245        <revremark>rename to websaxo; use whatissaxo</revremark> 
    3346      </revision> 
    34     </revhistory>   
     47      <revision> 
     48        <revnumber>0.2</revnumber> 
     49        <date>April 2008</date> 
     50        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     51      </revision> 
     52 
     53    </revhistory> 
    3554    <pubdate>$Id$</pubdate> 
    36   </articleinfo> 
     55  </info> 
    3756 
    3857  <note><para> 
    39 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. 
     58This 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. 
    4059  </para></note> 
    4160 
    42 <sect1 id="whatissaxo"> 
     61<sect1 xml:id="whatissaxo"> 
    4362<title>What is SAXO</title> 
    4463<xi:include href="./whatissaxo.xml" 
    45                  xpointer="whatissaxo_for_main"  
     64                 xpointer="whatissaxo_for_main" 
    4665                 parse="xml" 
    4766      xmlns:xi="http://www.w3.org/2001/XInclude"/> 
     
    5069 
    5170<xi:include href="./whatissaxo.xml" 
    52                  xpointer="element(/article/sect[1]/p[1])"  
     71                 xpointer="element(/article/sect[1]/p[1])" 
    5372                 parse="xml" 
    5473      xmlns:xi="http://www.w3.org/2001/XInclude"/> 
     
    5675 
    5776<para> 
    58 <ulink url="./whatissaxo.html">More &hellip;</ulink>  
    59 </para> 
    60 </sect1> 
    61  
    62  
    63 <sect1 id="whatsnew"> 
     77<link xl:href="./whatissaxo.html">More &hellip;</link> 
     78</para> 
     79</sect1> 
     80 
     81 
     82<sect1 xml:id="whatsnew"> 
    6483<title>What's new</title> 
    6584<itemizedlist> 
    6685<listitem><para>September 2006: One <emphasis role="bold">unique online_help</emphasis> for IDL and SAXO (requires IDL 6.2 or higher).</para></listitem> 
    6786<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> 
    68 <listitem>  
     87<listitem> 
    6988<para> 
    7089March 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. 
     
    7392<listitem> 
    7493<para> 
    75 More details in <ulink url="./whatsnew.html">What's new in SAXO</ulink> 
     94More details in <link xl:href="./whatsnew.html">What's new in SAXO</link> 
    7695</para> 
    7796</listitem> 
     
    8099 
    81100 
    82 <sect1 id="getsaxo"> 
     101<sect1 xml:id="getsaxo"> 
    83102<title> 
    84103Get SAXO 
     
    86105<itemizedlist> 
    87106<listitem><para> 
    88 <ulink url="./getsaxo.html">Get</ulink> SAXO 
     107<link xl:href="./getsaxo.html">Get</link> SAXO 
    89108</para></listitem> 
    90109<listitem><para> 
    91 <ulink url="./updatesaxo.html">Update</ulink> SAXO 
     110<link xl:href="./updatesaxo.html">Update</link> SAXO 
    92111</para></listitem> 
    93112<listitem><para> 
    94 <ulink url="http://forge.ipsl.jussieu.fr/saxo/browser/trunk">Browse</ulink> SAXO 
     113<link xl:href="http://forge.ipsl.jussieu.fr/saxo/browser/trunk">Browse</link> SAXO 
    95114</para></listitem> 
    96115</itemizedlist> 
    97116</sect1> 
    98117 
    99 <sect1 id="support"> 
     118<sect1 xml:id="support"> 
    100119<title>Support</title> 
    101120<itemizedlist> 
    102121<listitem> 
    103122<para> 
    104 You like SAXO? Please subscribe to SAXO <ulink url="./mailing.html">mailing lists</ulink> (subscription and archives). 
    105 </para> 
    106 </listitem> 
    107 <listitem> 
    108 <para> 
    109 <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>. 
    110 </para> 
    111 </listitem> 
    112 <listitem> 
    113 <para> 
    114 <ulink url="./faqsaxo.html">FAQ</ulink> 
     123You like SAXO? Please subscribe to SAXO <link xl:href="./mailing.html">mailing lists</link> (subscription and archives). 
     124</para> 
     125</listitem> 
     126<listitem> 
     127<para> 
     128<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>. 
     129</para> 
     130</listitem> 
     131<listitem> 
     132<para> 
     133<link xl:href="./faqsaxo.html">FAQ</link> 
    115134</para> 
    116135</listitem> 
     
    119138 
    120139 
    121 <sect1 id="documentation"> 
     140<sect1 xml:id="documentation"> 
    122141<title>Documentation</title> 
    123142<para> 
    124 <ulink url="./firststeps.html">First Steps</ulink> with SAXO. See also plots of First Steps in <ulink url="./all_plots.html">All plots</ulink> 
    125 </para> 
    126 <para> 
    127 A short overview and <ulink url="./mini_notice.html">documentation of xxx widget</ulink> is now available. 
    128 </para> 
    129 <para> 
    130 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>. 
    131 </para> 
    132 <para> 
    133 Some useful <ulink url="./tiplink.html">Tips and links</ulink>. 
    134 </para> 
    135 </sect1> 
    136 <sect1 id="saxoteam"> 
     143<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> 
     144</para> 
     145<para> 
     146A short overview and <link xl:href="./mini_notice.html">documentation of xxx widget</link> is now available. 
     147</para> 
     148<para> 
     149A 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>. 
     150</para> 
     151<para> 
     152Some useful <link xl:href="./tiplink.html">Tips and links</link>. 
     153</para> 
     154</sect1> 
     155<sect1 xml:id="saxoteam"> 
    137156<title>SAXO team</title> 
    138157<variablelist> 
    139158<varlistentry> 
    140159<term> 
    141 Sébastien Masson  
     160Sébastien Masson 
    142161</term> 
    143162<listitem> 
     
    173192<listitem> 
    174193<simpara> 
    175 <ulink url="http://forge.ipsl.jussieu.fr/">IPSL forge</ulink> maintainer 
     194<link xl:href="http://forge.ipsl.jussieu.fr/">IPSL forge</link> maintainer 
    176195</simpara> 
    177196</listitem> 
  • trunk/SRC/Documentation/xmldoc/whatissaxo.xml

    r270 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 
    4 [ 
    5 <!ENTITY hellip "&#x2026;"> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<!DOCTYPE article [ 
     3<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent"> 
     4%isolat1; 
     5<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent"> 
     6%isolat2; 
     7<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent"> 
     8%isogrk3; 
     9<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> 
     10%isopub; 
     11<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent"> 
     12%isotech; 
     13<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent"> 
     14%isonum; 
    615]> 
    7 <!-- 
    8 --> 
    9 <article> 
     16<article version="5.0" 
     17xmlns="http://docbook.org/ns/docbook" 
     18xmlns:xl="http://www.w3.org/1999/xlink" 
     19xml:lang="en"> 
    1020<title>What is SAXO</title> 
    11   <articleinfo> 
     21  <info> 
    1222    <authorgroup> 
    13       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    14       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     23      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     24      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1525    </authorgroup> 
    1626    <keywordset> 
     
    2939        <revremark>add introduction (previously in main.xml)</revremark> 
    3040      </revision> 
     41      <revision> 
     42        <revnumber>0.1</revnumber> 
     43        <date>April 2008</date> 
     44        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     45      </revision> 
    3146    </revhistory> 
    3247    <pubdate>$Id$</pubdate> 
    33   </articleinfo> 
     48  </info> 
    3449 
    35 <sect1 id="whatissaxo"> 
     50<sect1 xml:id="whatissaxo"> 
    3651<title>What is SAXO</title> 
    37 <para id="whatissaxo_for_main"> 
     52<para xml:id="whatissaxo_for_main"> 
    3853SAXO is a package (~400 routines, ~60 000 code lines) used to easily and quickly visualize and analyze models outputs or data observations. 
    39 It is based on <ulink url="http://www.ittvis.com/idl/"><trademark>IDL</trademark></ulink> and contains a Graphic User Interface. 
    40 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. 
    41 It is particularly adapted to the "Arakawa C grid" discretization used in <ulink url="http://www.locean-ipsl.upmc.fr/NEMO/">NEMO</ulink>. 
     54It is based on <link xl:href="http://www.ittvis.com/idl/"><trademark>IDL</trademark></link> and contains a Graphic User Interface. 
     55Developed 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. 
     56It 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>. 
    4257In addition to graphical procedures, interpolation modules and other things &hellip;, it contains a set of programs dedicated to oceanographic diagnostics. 
    4358</para> 
    4459</sect1> 
    4560 
    46 <sect1 id="prerequisites"> 
     61<sect1 xml:id="prerequisites"> 
    4762  <title>Prerequisites</title> 
    4863  <para> 
    49     <application>SAXO</application> needs at least <ulink url="http://www.ittvis.com/idl/"><trademark>IDL</trademark></ulink> 6.0. 
     64    <application>SAXO</application> needs at least <link xl:href="http://www.ittvis.com/idl/"><trademark>IDL</trademark></link> 6.0. 
    5065  </para> 
    51   <para> 
    52     <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> 
    53   </para> 
     66  <note> 
     67    <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> 
     68  </note> 
    5469  <!-- ++un jour peut-être 
    5570<para> 
     
    5873  --> 
    5974</sect1> 
    60 <sect1 id="include"> 
     75<sect1 xml:id="include"> 
    6176  <title>Include</title> 
    6277  <para> 
     
    6479      <listitem><simpara> 
    6580        <application>idl-NetCDF</application> written and maintained by Alan Iwi 
    66         <ulink url="http://www.ittvis.com/codebank/search.asp?FID=261"/> 
     81        <link xl:href="http://www.ittvis.com/codebank/search.asp?FID=261"/> 
    6782      </simpara></listitem> 
    6883      <listitem><simpara> 
    6984        <application>IDLdoc</application> written and maintained by Mike Galloy 
    70         <ulink url="http://www.ittvis.com/codebank/search.asp?FID=100"/> 
     85        <link xl:href="http://www.ittvis.com/codebank/search.asp?FID=100"/> 
    7186      </simpara></listitem> 
    7287      <listitem><simpara> 
    7388        <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 
    74         <ulink url="http://www.dfanning.com"/> 
     89        <link xl:href="http://www.dfanning.com"/> 
    7590      </simpara></listitem> 
    7691      <listitem><simpara> 
    7792        <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 
    78         <ulink url="http://fermi.jhuapl.edu/s1r/idl/s1rlib/local_idl.html"/> 
     93        <link xl:href="http://fermi.jhuapl.edu/s1r/idl/s1rlib/local_idl.html"/> 
    7994      </simpara></listitem> 
    8095      <listitem><simpara> 
    8196        <application>cmapply</application> and <application>cmset_op</application> written and maintained by Craig Markwardt 
    82         <ulink url="http://cow.physics.wisc.edu/~craigm/idl/"/> 
     97        <link xl:href="http://cow.physics.wisc.edu/~craigm/idl/"/> 
    8398      </simpara></listitem> 
    8499      <listitem><simpara> 
    85100        <application>imdisp</application>, <application>saveimage</application> and <application>showimage</application> written and maintained by Liam E. Gumley 
    86         <ulink url="http://cimss.ssec.wisc.edu/~gumley/"/> 
     101        <link xl:href="http://cimss.ssec.wisc.edu/~gumley/"/> 
    87102      </simpara></listitem> 
    88103      <listitem><simpara> 
  • trunk/SRC/Documentation/xmldoc/whatsnew.xml

    r189 r345  
    1 <?xml version='1.0' encoding='iso-8859-1'?> 
    2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
    3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"  
    4 []> 
    5 <!-- 
    6 --> 
    7 <article> 
    8 <title>What's new in SAXO</title>  
    9   <articleinfo> 
     1<?xml version="1.0" encoding="iso-8859-1"?> 
     2<article version="5.0" 
     3xmlns="http://docbook.org/ns/docbook" 
     4xmlns:xl="http://www.w3.org/1999/xlink" 
     5xml:lang="en" 
     6xml:id="whatsnew"> 
     7 
     8<title>What's new in SAXO</title> 
     9  <info> 
    1010    <authorgroup> 
    11       <author><firstname>Sébastien</firstname> <surname>Masson</surname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
    12       <author><firstname>Françoise</firstname> <surname>Pinsard</surname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
     11      <author><personname><firstname>Sébastien</firstname> <surname>Masson</surname></personname> <email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> 
     12      <author><personname><firstname>Françoise</firstname> <surname>Pinsard</surname></personname> <email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> 
    1313    </authorgroup> 
    1414    <keywordset> 
     
    2727        <revremark>add date according to output of svn log</revremark> 
    2828      </revision> 
    29     </revhistory>   
     29      <revision> 
     30        <revnumber>0.2</revnumber> 
     31        <date>April 2008</date> 
     32        <revremark>migration from DocBook 4.2 to Docbook 5.0</revremark> 
     33      </revision> 
     34    </revhistory> 
    3035    <pubdate>$Id$</pubdate> 
    31   </articleinfo> 
     36  </info> 
    3237 
    33 <!-- dans les page trac <ulink url="../changeset/69"> equivalent de [changeset:69] dans la syntaxe TracWiki --> 
     38<!-- dans les page trac <link xl:href="../changeset/69"> equivalent de [changeset:69] dans la syntaxe TracWiki --> 
    3439 
    35 <sect1 id="intro"> 
     40<sect1 xml:id="intro"> 
    3641<title>Introduction</title> 
    3742<para> 
     
    4348</sect1> 
    4449 
    45 <sect1 id="changeset175"> 
     50<sect1 xml:id="changeset175"> 
    4651<title>Changeset 175 (2006-09-13)</title> 
    4752<para> 
     
    4954</para> 
    5055<para> 
    51 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/175">Changeset 175</ulink>. 
     56Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/175">Changeset 175</link>. 
    5257</para> 
    5358</sect1> 
    5459 
    55 <sect1 id="changeset174"> 
     60<sect1 xml:id="changeset174"> 
    5661<title>Changeset 172-174 (2006-09-11/12)</title> 
    5762<para> 
     
    5964</para> 
    6065<para> 
    61 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>. 
     66Details 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>. 
    6267</para> 
    6368</sect1> 
    6469 
    65 <sect1 id="changeset163"> 
     70<sect1 xml:id="changeset163"> 
    6671<title>Changeset 163 (2006-08-29)</title> 
    6772<para> 
    68 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. 
     73Last 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. 
    6974</para> 
    7075<para> 
    71 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/163">Changeset 163</ulink>. 
     76Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/163">Changeset 163</link>. 
    7277</para> 
    7378</sect1> 
    7479 
    75 <sect1 id="changeset152"> 
     80<sect1 xml:id="changeset152"> 
    7681<title>Changeset 152 (2006-08-10)</title> 
    7782<para> 
    78 This revision includes new <ulink type="text" url="../../ToBeReviewed/PLOTS/DESSINE/pltv.pro">pltv</ulink> (a mix between plt and tvplus) plotting procedure. 
     83This 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. 
    7984</para> 
    8085<para> 
    81 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/152">Changeset 152</ulink>. 
     86Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/152">Changeset 152</link>. 
    8287</para> 
    8388</sect1> 
    8489 
    85 <sect1 id="changeset114"> 
     90<sect1 xml:id="changeset114"> 
    8691<title>Changeset 114 (2006-06-19)</title> 
    8792<para> 
    88 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>). 
     93This 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>). 
    8994</para> 
    9095<para> 
    91 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/114">Changeset 114</ulink>. 
     96Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/114">Changeset 114</link>. 
    9297</para> 
    9398</sect1> 
    9499 
    95 <sect1 id="changeset73"> 
     100<sect1 xml:id="changeset73"> 
    96101<title>Changeset 73 (2006-05-22)</title> 
    97102<para> 
     
    99104</para> 
    100105<para> 
    101 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>. 
     106Details 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>. 
    102107</para> 
    103108</sect1> 
    104109 
    105 <sect1 id="changeset69"> 
     110<sect1 xml:id="changeset69"> 
    106111<title>Changeset 69 (2006-05-11)</title> 
    107112<para> 
     
    109114</para> 
    110115<para> 
    111 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/69">Changeset 69</ulink>. 
     116Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/69">Changeset 69</link>. 
    112117</para> 
    113118</sect1> 
    114119 
    115 <sect1 id="chgangeset68"> 
     120<sect1 xml:id="chgangeset68"> 
    116121<title>Changeset 68 (2006-05-09)</title> 
    117122<para> 
     
    119124</para> 
    120125<para> 
    121 See <ulink url="./infoupdatekwd.html">Keywords translation</ulink> 
    122 and <ulink url="./infoupdatecm.html">Commons translation</ulink>. 
     126See <link xl:href="./infoupdatekwd.html">Keywords translation</link> 
     127and <link xl:href="./infoupdatecm.html">Commons translation</link>. 
    123128</para> 
    124129<para> 
    125 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/68">Changeset 68</ulink>. 
     130Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/68">Changeset 68</link>. 
    126131</para> 
    127132</sect1> 
    128133 
    129 <sect1 id="changeset7"> 
     134<sect1 xml:id="changeset7"> 
    130135<title>Changeset 7 (2006-04-24)</title> 
    131136<para> 
     
    133138</para> 
    134139<para> 
    135 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/7">Changeset 7</ulink>. 
     140Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/7">Changeset 7</link>. 
    136141</para> 
    137142</sect1> 
    138143 
    139 <sect1 id="changeset2"> 
     144<sect1 xml:id="changeset2"> 
    140145<title>Changeset 2 (revision date=2002-09-11 actually done 2006-04-13)</title> 
    141146<para> 
     
    143148</para> 
    144149<para> 
    145 Details can be seen in <ulink url="http://forge.ipsl.jussieu.fr/saxo/changeset/2">Changeset 2</ulink>. 
     150Details can be seen in <link xl:href="http://forge.ipsl.jussieu.fr/saxo/changeset/2">Changeset 2</link>. 
    146151</para> 
    147152</sect1> 
Note: See TracChangeset for help on using the changeset viewer.