valid RST

slapos/README.console.txt

 console
-=======
+-------
 
 The slapconsole tool allows to interact with a SlapOS Master throught the SLAP
 library.
@@ -12,7 +12,8 @@ defined and initialized.
 
 
 Initialization and configuration file
-=====
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Slapconsole allows to automatically connect to a Master using URL and SSL
 certificate from given slapos.cfg.
 Certificate has to be *USER* certificate, manually obtained from SlapOS master
@@ -20,6 +21,7 @@ web interface.
 
 Slapconsole tools reads the given slapos.cfg configuration file and use the
 following informations :
+
  * Master URL is read from [slapos] in the "master_url" parameter.
  * SSL Certificate is read from [slapconsole] in the "cert_file" parameter.
  * SSL Key is read from [slapconsole] in the "key_file" parameter.
@@ -28,7 +30,8 @@ See slapos.cfg.example for examples.
 
 
 Global functions
-=====
+~~~~~~~~~~~~~~~~
+
  * request() is a shorthand for slap.registerOpenOrder().request() allowing
    to request instances.
  * supply() is a shorthand for slap.registerSupply().supply() allowing to
@@ -39,33 +42,44 @@ documentation.
 
 
 Global aliases
-=====
+~~~~~~~~~~~~~~
+
 "software_list" is a list containing all the Software Release URLs defined in
 client slapos.cfg configuration file.
 
 Also, each Software Release defined in this configuration file is translated
 into a global variable to ease the request of those Sofware Releases.
 
-This allows to request instances in a few words, i.e
-request("http://www.url.com/path/to/kvm/software.cfg", "mykvm")
-can be simplified into : 
-request(kvm, "mykvm")
-If the slapos.cfg file contains : 
-alias = 
+This allows to request instances in a few words, i.e::
+
+  request("http://www.url.com/path/to/kvm/software.cfg", "mykvm")
+
+can be simplified into ::
+
+  request(kvm, "mykvm")
+
+If the slapos.cfg file contains ::
+
+  alias =
     kvm http://www.url.com/path/to/kvm/software.cfg
 
 
 Global objects
-=====
+~~~~~~~~~~~~~~
+
 "slap" is an instance of the SLAP library. It is only used for advanced usages.
-"slap" instance is obtained by doing : 
-slap = slapos.slap.slap()
-slap.initializeConnection(config.master_url,
+"slap" instance is obtained by doing ::
+
+  slap = slapos.slap.slap()
+  slap.initializeConnection(config.master_url,
     key_file=config.key_file, cert_file=config.cert_file)
     
 
 Examples
-=====
+~~~~~~~~
+
+::
+
   >>> # Request instance
   >>> request(kvm, "myuniquekvm")