**************************
Adopted formatting choices
**************************

The *user's guides* source files were written according to the following 
formatting conventions:


>>>***********
>>>Page Titles
>>>***********

>>>| ***********
>>>| Page Titles
>>>| ***********


>>>Section Titles
>>>==============

>>>| Section Titles
>>>| ==============


>>>Subsection Titles
>>>-----------------

>>>| Subsection Titles
>>>| -----------------


>>>.. describe:: Lists of commands

>>>| .. describe:: Lists of commands



>>> Tables

>>>========  ==========  ========== 
>>>Col1      Col2        Col3       
>>>--------  ----------  ----------
>>>unit      unit        unit      
>>>========  ==========  ==========
>>>Text1     1           1        
>>>Text2     2           2       
>>>========  ==========  ========== 

>>>| ========  ==========  ==========  
>>>| Col1      Col2        Col3        
>>>| --------  ----------  ----------  
>>>|           unit        unit        
>>>| ========  ==========  ==========
>>>| Text1     1           1         
>>>| Text2     2           2         
>>>| ========  ==========  ==========