Index: jrst2/doc/en/index.rst
diff -u jrst2/doc/en/index.rst:1.1 jrst2/doc/en/index.rst:1.2
--- jrst2/doc/en/index.rst:1.1	Wed May 30 17:07:06 2007
+++ jrst2/doc/en/index.rst	Fri Nov 30 14:43:10 2007
@@ -1,37 +1,64 @@
-JRst
-====
+==============================
+reStructuredText parser : JRst
+==============================
 
-.. contents::
+Presentation
+------------
 
+reStructuredText format is a document description format. Like other LaTex
+or DocBook, it can be converted toward a multitude of formats. These formats
+have usually invading syntax which, if it is necessary for very specific
+documents, becomes useless when it is used to quickly creating a simple
+document. RST has a so simple syntax that it  becomes almost invisible.
 
-Présentation
-------------
+JRST is a Java ReStructuredText parser enabling to create a tree representation
+document. It becomes easy to generate document representation towards differents
+fomats.
+
+How to use it
+-------------
+
+JRST parser takes a reStructuredText file and generates XML file. Which could be used to produce
+various files formats with generation XSL files. The available output formats are HTML, xhtml,
+rst, pdf, docbook, odt(Open-Office), rtf, or XML.
+
+::
+
+   JRST myfile.rst   
 
-JRst is Java ReStructuredText parser.
+This command converts myfile.rst toward XML file, displayed to the standard output (console).
+Several options are available :
 
-Internaly Rst document is a dom4j tree that represent python docutils xml.
-You can generate docbook, xhtml, xdoc or your own files with your own XSL
-files.
+-o file,--outFile=file          to write toward a file.
+-t format,--outType format      to specify exit format, so using generation XSL file(s).
+                                Several formats are available xhtml, docbook, xml, HTML, xdoc, rst, pdf, odt, rtf. 
+-x xslFile,--xslFile xslFile    to specify generation XSL file at using.
+--force                         to overwrite, if file exists, it will be replaced by the new one.
+--help                          to display available options :
 
-Usage
------
+::
 
-To generate python docutils xml just write::
+   Usage: [options] FILE
+      [--force] : overwrite existing out file
+      [--help] : display this help and exit
+      [--outFile -o value] : Output file
+      [--outType -t /xhtml|docbook|xml|html|xdoc|rst/] : Output type
+      [--xslFile -x value] : XSL file list to apply, comma separated
 
-  JRST myfile.rst
+NOTE : Only html, xhtml, DocBook, xdoc and pdf are available for the moment.
 
-To generate html::
+ex :
 
-  JRST -t html myfile.rst
+::
 
-To generate in specified file::
+   JRST --force -t html -o myfile.html myfile.rst   
 
-  JRST -t xdoc -o myfile.xml myfile.rst
+This command produces html file (myfile.html) from rst file (myfile.rst) 
+even if myfile.html already exists.
 
 
-Plugin maven
+Maven Plugin
 ------------
 
-Un plugin maven est disponnible à l'adresse suivante 
-http://jrst.labs.libre-entreprise.org/maven-jrst-plugin . Il permet l'utilisation 
-depuis maven de JRst.
+Maven plugin is available at the following links : http://jrst.labs.libre-entreprise.org/maven-jrst-plugin.
+It enables the use of JRST from Maven.