From c5034a91566c8db9062e14c4ded83f6f17008645 Mon Sep 17 00:00:00 2001
From: Jean-Paul Chaput <Jean-Paul.Chaput@lip6.fr>
Date: Wed, 6 Jun 2018 23:22:18 +0200
Subject: [PATCH] Typo in CMakeLists.txt : AND instead of "and".

---
 crlcore/doc/crlcore/CMakeLists.txt            |   2 +-
 .../_build/html/_images/fulladder-1.png       | Bin 0 -> 14728 bytes
 .../PythonTutorial/AdvancedTopics.txt         |  36 ++
 .../html/_sources/PythonTutorial/Netlist.txt  | 399 ++++++++++++++++++
 .../_sources/PythonTutorial/RealDesigns.txt   |  51 +++
 .../_sources/PythonTutorial/ToolEngines.txt   | 213 ++++++++++
 hurricane/doc/hurricane/CMakeLists.txt        |   2 +-
 hurricane/doc/viewer/CMakeLists.txt           |   2 +-
 katabatic/doc/CMakeLists.txt                  |   2 +-
 kite/doc/CMakeLists.txt                       |   2 +-
 unicorn/doc/unicorn/CMakeLists.txt            |   2 +-
 vlsisapd/doc/CMakeLists.txt                   |   2 +-
 12 files changed, 706 insertions(+), 7 deletions(-)
 create mode 100644 documentation/_build/html/_images/fulladder-1.png
 create mode 100644 documentation/_build/html/_sources/PythonTutorial/AdvancedTopics.txt
 create mode 100644 documentation/_build/html/_sources/PythonTutorial/Netlist.txt
 create mode 100644 documentation/_build/html/_sources/PythonTutorial/RealDesigns.txt
 create mode 100644 documentation/_build/html/_sources/PythonTutorial/ToolEngines.txt

diff --git a/crlcore/doc/crlcore/CMakeLists.txt b/crlcore/doc/crlcore/CMakeLists.txt
index 93620aaf..2b0a60ce 100644
--- a/crlcore/doc/crlcore/CMakeLists.txt
+++ b/crlcore/doc/crlcore/CMakeLists.txt
@@ -7,7 +7,7 @@
                                      tabs.css
                    )
 
- if (BUILD_DOC and DOXYGEN_FOUND)
+ if (BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( documentation ALL
                         cd ${CRLCORE_SOURCE_DIR}/doc/crlcore
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/documentation/_build/html/_images/fulladder-1.png b/documentation/_build/html/_images/fulladder-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..21445b49a1ba985c7f9af92c56e8531875e43f49
GIT binary patch
literal 14728
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

literal 0
HcmV?d00001

diff --git a/documentation/_build/html/_sources/PythonTutorial/AdvancedTopics.txt b/documentation/_build/html/_sources/PythonTutorial/AdvancedTopics.txt
new file mode 100644
index 00000000..61ec706d
--- /dev/null
+++ b/documentation/_build/html/_sources/PythonTutorial/AdvancedTopics.txt
@@ -0,0 +1,36 @@
+.. -*- Mode: rst -*-
+.. include:: ../etc/definitions.rst
+.. include:: ./definitions.rst
+
+
+9. Advanced Topics
+==================
+
+This is a place holder as well as a reminder to myself to write this part of
+the documentation.
+
+
+9.1 Occurrence
+~~~~~~~~~~~~~~
+
+The trans-hierarchical workhorse.
+
+
+9.2 RoutingPads
+~~~~~~~~~~~~~~~
+
+Unlike the Plugs_ that only make connexions between two **adjacent**
+hierarchical levels, RoutingPads_ can refer to a deeply buried terminal.
+
+
+9.3 HyperNets
+~~~~~~~~~~~~~
+
+This class is part of the *virtual flattening* mechanisms, it allows to
+go through all the components of a trans-hierarchical net.
+
+
+9.4 Miscellaeous trans-hierarchical functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For a starter, how to get all the leaf cells...
diff --git a/documentation/_build/html/_sources/PythonTutorial/Netlist.txt b/documentation/_build/html/_sources/PythonTutorial/Netlist.txt
new file mode 100644
index 00000000..0d9c99dc
--- /dev/null
+++ b/documentation/_build/html/_sources/PythonTutorial/Netlist.txt
@@ -0,0 +1,399 @@
+.. -*- Mode: rst -*-
+.. include:: ../etc/definitions.rst
+.. include:: ./definitions.rst
+
+
+6. Making a hierarchical Cell -- Netlist
+========================================
+
+To illustrate the topic, we will build the netlist of a fulladder from
+standard cell.
+
+|fulladder_1|
+
+
+6.1 Creating an Instance_
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Creating an Instance_ is straigthforward, the constructor needs only three
+parameters:
+
+#. The Cell_ **into which** the instance is to be created.
+#. The name of the instance.
+#. The **master cell**, the Cell_ model it refers to. The master cell
+   will be part of the hierarchical level just below the ``fulladder``
+   cell.
+
+.. note:: Do not confuse the cell the instance is create into (``fulladder``)
+	  and the cells it refers to (the *master cell* ``xr2_x2``).
+
+.. code-block:: Python
+
+   af     = AllianceFramework.get()
+   xr2_x2 = af.getCell( 'xr2_x1', Catalog.State.Views )
+    
+   fulladder = af.createCell( 'fulladder' )
+   xr2_1     = Instance.create( fulladder, 'xr2_1', xr2_x2 )
+    
+
+6.2 Creating Nets and connecting to Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+An Instance_ as one Plug_ for each external net of the *master cell*.
+The plug allows to create a **logical** connexion bewteen a Net_ of
+``fulladder`` and a net from an Instance_ *master cell*.
+
+A plug is somewhat equivalent to an *instance terminal* in others
+well known databases.
+
+Therefore, a plug is related to two nets:
+
+#. The net of the *master cell* it is linked to. Obviously that
+   net cannot be changed. You can access the master net with the
+   function ``plug.getMasterNet()``.
+
+#. The net of ``fulladder`` the plug is connected to. This can
+   be set, it is how we build the netlist. To set the net, use
+   the function ``plug.setNet( net )``. It the argument is ``None``,
+   the plug is *disconnected*.
+
+To find the plug of an instance associated to a given net in
+the *master cell*, use ``instance.getPlug( masterNet )``.
+The ``masterNet`` argument being an object of class net (not
+it's name).
+
+Building the :cb:`a` net of ``fulladder``:
+
+.. code-block:: Python
+
+   a = Net.create( fulladder, "a" )
+   a.setExternal( True )
+   xr2_1.getPlug( xr2_x2.getNet("i0") ).setNet( a )
+   a2_1 .getPlug(  a2_x2.getNet("i0") ).setNet( a )
+
+
+.. note:: **Limitation of Hurricane Netlists.** There is no explicit
+	  terminal object in the |Hurricane| database. Plugs are
+          generated *on the fly* for each *external net* of the
+          instance. One important consequence is that a *net*
+	  cannot appear on the interface as two differently named
+	  terminals (sometimes referred as *weekly connected*
+	  terminals). There is a strict bijection between external
+	  nets and plugs.
+
+	  While it may be restrictive, it enforce cleaner designs
+          and make it possible for the HyperNet_ concept/class.
+
+
+6.3 Power supplies special case
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For supplies, it may  be tedious to connect the Plugs_ of each  cell one by one
+(and  create a  lot of  uneeded objects).  To avoid  that, we  may use  **Named
+connections**.  If a  signal in ``fulladder`` is set to  *global*, then it will
+be considered as connected  to any signal with the *same  name* and *global* in
+the master cell of the instances.
+
+.. code-block:: Python
+
+   vdd = Net.create( fulladder, "vdd" )
+   vdd.setExternal( True )
+   vdd.setGlobal  ( True )  # Will be connected to all the instances.
+	  
+
+6.4 Creating the physical view of a Cell netlist
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Even if loaded in the viewer, an Instance will not be displayed
+until it is placed.
+
+
+6.4.1 Transformation
+--------------------
+
+To place an Instance, we apply a Transformation_ to the coordinate system
+of the *master cell*. A transformation is composed of two operations :
+
+#. An Orientation_, which can be a symmetry or a rotation (or a combination
+   of those two). The Orientation **is applied first** to the coordinate
+   system of the *master cell*. The complete list of Orientation and their
+   codes are given on the Orientation documentation page.
+
+#. A **Translation**, applied in second. Translation are represented by
+   Points_.
+
+The transformation is a change of coordinate system, be aware that if the
+abutment box lower left corner of the *master* cell is **not** at ``(0,0)``
+the result of the Transformation may not be what you expect. To simplificate
+the computation of the transformation of an instance, always place the
+lower left corner of the abutment box at ``(0,0)``
+
+
+6.4.2 Placing an Instance
+-------------------------
+
+Assuming that we want to place the cells of the ``fulladder`` into two rows,
+that the abutment box lower left corner is at ``(0,0)`` (same for the
+``xr2_x2`` *master cell* layout). Here is the code to place the ``xr2_1``
+instance to left of the second row.
+
+Setting the translation on an Instance_ is not enough to make it be displayed,
+we also must set it's *placement status* to ``Instance.PlacementStatus.PLACED``. 
+
+.. code-block:: Python
+
+   xr2_1.setTransformation( Transformation( DbU.fromLambda(  0.0)
+                                          , DbU.fromLambda(100.0)
+                                          , Transformation.Orientation.MY ) )
+   xr2_1.setPlacementStatus( Instance.PlacementStatus.PLACED )
+
+
+6.4.3 Nets -- From Plugs to RoutingPads
+---------------------------------------
+
+As was stated before, Plugs_ represent a logical connexion between two
+levels of hierarchy. To make the physical connexion to the *master net*
+in the instance, we now must create, in the ``fulladder``, a special
+component which is a kind of *reference* to a component of the
+*master net* (in the master cell).
+
+The so called *special component* is a RoutingPad_.
+
+The ``RoutingPad`` can be considered as an equivalent to ``pin`` in others
+well known databases.
+
+.. code-block:: Python
+
+   rp = RoutingPad.create( a
+                         , Occurrence( xr2_1.getPlug( xr2_x2.getNet("i0")) )
+			 , RoutingPad.BiggestArea )
+
+For the second parameter, we must pass an Occurrence_. Occurrence objects will
+be explained in detail later, for now, suffice to say that we must construct the
+Occurrence object with one parameter : the Plug_ for which we want to create a
+physical connexion.
+
+The RoutingPad_ ``rp`` will be a component of the ``a`` net.
+
+The third argument ask the constructor of the RoutingPad_ to select in the
+master net, the component which has the biggest area.
+
+.. note:: **Component selection.** Not all the components of a net can be
+	  selected for connexion through a RoutingPad_. The candidates must
+	  have been flagged with the NetExternalComponents_ class.
+
+	  See `3.6.3 Creating a Component`_.
+
+
+6.4.4 Nets -- Regular wiring
+----------------------------
+
+After the creation of the RoutingPads_, the wiring is to be created with
+ordinary layout components (Horizontal_, Vertical_ and Contact_ possibly
+articulated). Here is the complete code for net ``a``. We made an articulated
+layout where contacts are created over RoutingPads_ then segments over
+contacts.
+	  
+.. code-block:: Python
+
+   # Build wiring for a.
+   # Create RoutingPads first.
+    rp1      = RoutingPad.create( a
+                                , Occurrence( xr2_1.getPlug( xr2_x2.getNet("i0")) )
+                                , RoutingPad.BiggestArea )
+    rp2      = RoutingPad.create( a
+                                , Occurrence(  a2_1.getPlug(  a2_x2.getNet("i0")) )
+                                , RoutingPad.BiggestArea )
+
+   # Then regular wiring.
+    contact1 = Contact.create( rp1, via12, toDbU( 0.0), toDbU(-15.0) )
+    contact2 = Contact.create( rp2, via12, toDbU( 0.0), toDbU( 10.0) )
+    turn     = Contact.create( a  , via23, toDbU(10.0), toDbU( 35.0) )
+    Horizontal.create( contact2, turn     , metal2, toDbU(35.0), toDbU(2.0) )
+    Vertical  .create( turn    , contact1 , metal3, toDbU(10.0), toDbU(2.0) )
+
+
+.. note:: In order to better see the layout of the wiring only, open the
+	  ``Controller`` and in the :fboxtt:`Filter` tab, uncheck
+          :fboxtt:`Process Terminal Cells`.
+
+		   
+6.5 The Complete Example File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The example file ``fulladder.py`` can be found in the ``share/doc/coriolis2/examples/scripts/``
+directory (under the the root of the |Coriolis| installation).
+
+.. code-block:: Python
+
+   #!/usr/bin/python
+   
+   import sys
+   from   Hurricane import *
+   from   CRL       import *
+   
+   
+   def toDbU ( l ): return DbU.fromLambda(l)
+   
+   
+   def doBreak ( level, message ):
+       UpdateSession.close()
+       Breakpoint.stop( level, message )
+       UpdateSession.open()
+   
+   
+   def buildFulladder ( editor ):
+   
+      # Get the Framework and all the master cells.
+       af     = AllianceFramework.get()
+       xr2_x2 = af.getCell( 'xr2_x1', Catalog.State.Views )
+       a2_x2  = af.getCell( 'a2_x2' , Catalog.State.Views )
+       o2_x2  = af.getCell( 'o2_x2' , Catalog.State.Views )
+   
+       UpdateSession.open()
+   
+       fulladder = af.createCell( 'fulladder' )
+       fulladder.setAbutmentBox( Box( toDbU(0.0), toDbU(0.0), toDbU(90.0), toDbU(100.0) ) )
+   
+       if editor:
+         UpdateSession.close()
+         editor.setCell( fulladder )
+         editor.fit()
+         UpdateSession.open()
+       
+      # Create Instances.
+       a2_1  = Instance.create( fulladder,  'a2_1',  a2_x2 )
+       a2_2  = Instance.create( fulladder,  'a2_2',  a2_x2 ) 
+       xr2_1 = Instance.create( fulladder, 'xr2_1', xr2_x2 )
+       xr2_2 = Instance.create( fulladder, 'xr2_2', xr2_x2 )
+       o2_1  = Instance.create( fulladder,  'o2_1',  o2_x2 )
+       
+      # Create Nets.
+       vss = Net.create( fulladder, "vss" )
+       vss.setExternal( True )
+       vss.setGlobal  ( True )
+     
+       vdd = Net.create( fulladder, "vdd" )
+       vdd.setExternal( True )
+       vdd.setGlobal  ( True )
+
+       cin = Net.create( fulladder, "cin" )
+       cin.setExternal( True )
+       xr2_2.getPlug( xr2_x2.getNet('i0') ).setNet( cin )
+       a2_2 .getPlug(  a2_x2.getNet('i0') ).setNet( cin )
+       
+       a = Net.create( fulladder, 'a' )
+       a.setExternal( True )
+       xr2_1.getPlug( xr2_x2.getNet('i0') ).setNet( a )
+       a2_1 .getPlug(  a2_x2.getNet('i0') ).setNet( a )
+       
+       b = Net.create( fulladder, 'b' )
+       b.setExternal( True )
+       xr2_1.getPlug( xr2_x2.getNet('i1') ).setNet( b )
+       a2_1 .getPlug(  a2_x2.getNet('i1') ).setNet( b )
+       
+       sout_1 = Net.create( fulladder, 'sout_1' )
+       xr2_1.getPlug( xr2_x2.getNet('q' ) ).setNet( sout_1 )
+       xr2_2.getPlug( xr2_x2.getNet('i1') ).setNet( sout_1 )
+       a2_2 .getPlug(  a2_x2.getNet('i1') ).setNet( sout_1 )
+       
+       carry_1 = Net.create( fulladder, 'carry_1' )
+       a2_1.getPlug( a2_x2.getNet('q' ) ).setNet( carry_1 )
+       o2_1.getPlug( o2_x2.getNet('i1') ).setNet( carry_1 )
+   
+       carry_2 = Net.create( fulladder, 'carry_2' )
+       a2_2.getPlug( a2_x2.getNet('q' ) ).setNet( carry_2 )
+       o2_1.getPlug( o2_x2.getNet('i0') ).setNet( carry_2 )
+   
+       sout = Net.create( fulladder, 'sout' )
+       sout.setExternal( True )
+       xr2_2.getPlug( xr2_x2.getNet('q') ).setNet( sout )
+       
+       cout = Net.create( fulladder, 'cout' )
+       cout.setExternal( True )
+       o2_1.getPlug( o2_x2.getNet('q') ).setNet( cout )
+   
+      # Instances placement.
+       a2_1.setTransformation( Transformation( toDbU(0.0)
+                                             , toDbU(0.0)
+                                             , Transformation.Orientation.ID ) )
+       a2_1.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Placed a2_1' )
+   
+       xr2_1.setTransformation( Transformation( toDbU(  0.0)
+                                              , toDbU(100.0)
+                                              , Transformation.Orientation.MY ) )
+       xr2_1.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Placed xr2_1' )
+   
+       a2_2.setTransformation( Transformation( toDbU(25.0)
+                                             , toDbU( 0.0)
+                                             , Transformation.Orientation.ID ) )
+       a2_2.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Placed a2_2' )
+   
+       xr2_2.setTransformation( Transformation( toDbU( 45.0)
+                                              , toDbU(100.0)
+                                              , Transformation.Orientation.MY ) )
+       xr2_2.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Placed xr2_2' )
+   
+       o2_1.setTransformation( Transformation( toDbU(65.0)
+                                             , toDbU( 0.0)
+                                             , Transformation.Orientation.ID ) )
+       o2_1.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Placed o2_1' )
+   
+      # Add filler cells.
+       tie_x0    = af.getCell(    'tie_x0', Catalog.State.Views )
+       rowend_x0 = af.getCell( 'rowend_x0', Catalog.State.Views )
+       filler_1  = Instance.create( fulladder, 'filler_1',    tie_x0 )
+       filler_2  = Instance.create( fulladder, 'filler_2', rowend_x0 )
+   
+       filler_1.setTransformation( Transformation( toDbU(50.0)
+                                                 , toDbU( 0.0)
+                                                 , Transformation.Orientation.ID ) )
+       filler_1.setPlacementStatus( Instance.PlacementStatus.PLACED )
+   
+       filler_2.setTransformation( Transformation( toDbU(60.0)
+                                                 , toDbU( 0.0)
+                                                 , Transformation.Orientation.ID ) )
+       filler_2.setPlacementStatus( Instance.PlacementStatus.PLACED )
+       doBreak( 1, 'Filler cell placeds' )
+       
+      # Getting the layers.
+       technology = DataBase.getDB().getTechnology()
+       metal2     = technology.getLayer( "METAL2" ) 
+       metal3     = technology.getLayer( "METAL3" ) 
+       via12      = technology.getLayer( "VIA12"  ) 
+       via23      = technology.getLayer( "VIA23"  ) 
+   
+      # Build wiring for a.
+      # Create RoutingPads first.
+       rp1      = RoutingPad.create( a
+                                   , Occurrence( xr2_1.getPlug( xr2_x2.getNet("i0")) )
+                                   , RoutingPad.BiggestArea )
+       rp2      = RoutingPad.create( a
+                                   , Occurrence(  a2_1.getPlug(  a2_x2.getNet("i0")) )
+                                   , RoutingPad.BiggestArea )
+   
+      # Then regular wiring.
+       contact1 = Contact.create( rp1, via12, toDbU( 0.0), toDbU(-15.0) )
+       contact2 = Contact.create( rp2, via12, toDbU( 0.0), toDbU( 10.0) )
+       turn     = Contact.create( a  , via23, toDbU(10.0), toDbU( 35.0) )
+       Horizontal.create( contact2, turn     , metal2, toDbU(35.0), toDbU(2.0) )
+       Vertical  .create( turn    , contact1 , metal3, toDbU(10.0), toDbU(2.0) )
+   
+       UpdateSession.close()
+
+       af.saveCell( fulladder, Catalog.State.Views )
+       return
+   
+   
+   def ScriptMain ( **kw ):
+       editor = None
+       if kw.has_key('editor') and kw['editor']:
+         editor = kw['editor']
+   
+       buildFulladder( editor )
+       return True 
diff --git a/documentation/_build/html/_sources/PythonTutorial/RealDesigns.txt b/documentation/_build/html/_sources/PythonTutorial/RealDesigns.txt
new file mode 100644
index 00000000..1bbe68a8
--- /dev/null
+++ b/documentation/_build/html/_sources/PythonTutorial/RealDesigns.txt
@@ -0,0 +1,51 @@
+.. -*- Mode: rst -*-
+.. include:: ../etc/definitions.rst
+.. include:: ./definitions.rst
+
+
+7. Working in real mode
+=======================
+
+The AllianceFramework_ only manage *symbolic* layout as |Alliance| do.
+But |Coriolis| is also able to work directly in *real* mode, meaning
+that distances will be expresseds in microns instead of lambdas.
+
+The *real* mode will be illustrated by working with the FreePDK45_.
+
+We will assume that the FreePDK45_ archives is installed under: ::
+
+  /home/dks/
+
+
+7.1 Loading a |LEF| file
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Importing a |LEF| file is simple, you just call the static function
+``LefImport.load()``. Multiple |LEF| file can be imported one after
+another.
+
+.. code-block:: Python
+
+   # You must set "DKsdir" to where you did install the NCSU FreePDK 45nm DK.
+   DKsdir  = '/home/dks'
+
+   library = LefImport.load( DKsdir + '/FreePDK45/osu_soc/lib/files/gscl45nm.lef' )		
+
+
+.. note:: **Technology checking.**  The first imported |LEF| file must contains the
+	  technology. The technology described in the |LEF| file will be checked
+	  against the one configured in the running instance of |Coriolis| to look
+	  for any discrepencies.
+
+
+7.2 Loading a |Blif| file -- |Yosys|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The |Blif| format is generated by the Yosys_ logic synthetizer. Here again, it is
+pretty straightforward: call the static function ``Blif.load()``. If you did make
+your synthesis on a cell library not managed by AllianceFramework_, For example
+the one of the FreePDK45, you must load it prior to calling the |Blif| loader.
+
+.. code-block:: Python
+
+   cell = Blif.load( 'snx' ) # load "snx.blif" in the working directory.
diff --git a/documentation/_build/html/_sources/PythonTutorial/ToolEngines.txt b/documentation/_build/html/_sources/PythonTutorial/ToolEngines.txt
new file mode 100644
index 00000000..9b3f68b8
--- /dev/null
+++ b/documentation/_build/html/_sources/PythonTutorial/ToolEngines.txt
@@ -0,0 +1,213 @@
+.. -*- Mode: rst -*-
+.. include:: ../etc/definitions.rst
+.. include:: ./definitions.rst
+
+
+8. Tool Engines (CRL Core)
+==========================
+
+The ToolEngine_ class is the base class for all tools developpeds in
+|Coriolis|. In the rest of the tutorial we will use the names ``tool``
+or ``engine`` as synonyms.
+
+
+8.1 Placer -- Etesian
+~~~~~~~~~~~~~~~~~~~~~
+
+To run the placer, create the |Etesian| engine, then call the ``place()``
+function.
+
+.. code-block:: Python
+
+   import Etesian
+
+   # [...]
+
+   etesian = Etesian.EtesianEngine.create(cell)
+   etesian.place()
+
+You can configure the placer in two ways:
+
+#. Prior to the creation of the engine, setup an abutment for the cell.
+   The placer will fit the cells into that area. If the area is too
+   small, it will issue an error.
+
+#. Setup |Etesian| parameters through the ``settings.py`` configuration
+   file. For example:
+
+   .. code-block:: Python
+
+      parametersTable = \
+          ( ("etesian.effort"           , TypeEnumerate , 2       )
+          , ('etesian.uniformDensity'   , TypeBool      , True    )
+          , ('etesian.spaceMargin'      , TypePercentage, 3.0     )
+          , ('etesian.aspectRatio'      , TypePercentage, 100.0   )
+          )
+
+   With this setup, the cells will be spread uniformally over the
+   area (``etesian.uniformDensity``), with ``3.0%`` of free space
+   added and an aspect ratio of ``100%`` (square shape).
+
+
+8.1 Router -- Katana
+~~~~~~~~~~~~~~~~~~~~
+
+Like for |Etesian|, you have to create the engine on the cell then call
+the sequence of functions detailed below.
+
+.. note:: **Kite vs. Katana.** There are currently two router in |Coriolis|,
+	  |Kite| is the old one and digital only. |Katana| is a re-implementation
+	  with support for mixed routing (digital **and** analog).
+	  Until |Katana| is fully implemented we keep both of them.
+
+.. code-block:: Python
+
+   import Anabatic
+   import Katana
+
+   # [...]
+
+   katana = Katana.KatanaEngine.create(cell)
+   katana.digitalInit      ()
+   katana.runGlobalRouter  ()
+   katana.loadGlobalRouting( Anabatic.EngineLoadGrByNet )
+   katana.layerAssign      ( Anabatic.EngineNoNetLayerAssign )
+   katana.runNegociate     ( Katana.Flags.NoFlags )
+
+
+8.2  A Complete Example
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The example file ``toolengines.py`` can be found in the ``share/doc/coriolis2/examples/scripts/``
+directory (under the the root of the |Coriolis| installation).
+
+This script automatically place and route the ``fulladder`` netlist as seen
+previously. The call to the ToolEngines_ is made inside the new function
+``placeAndRoute()``.
+
+.. note:: As the ``ToolEngine`` take care of opening and closing UpdateSession_, we
+	  do not need the wrapper function ``doBreak()`` around the breakpoints.
+          We directly call Breakpoint_.
+
+.. note:: The space margin for this example is very high (``30%``), it's only
+	  because it's too small for the placer to run correctly. For normal
+	  case it is around ``3%``.
+
+.. code-block:: Python
+
+   #!/usr/bin/python
+   
+   import sys
+   from   Hurricane import *
+   from   CRL       import *
+   import Etesian
+   import Anabatic
+   import Katana
+   
+   # Everybody needs it.
+   af = AllianceFramework.get()
+   
+   
+   def toDbU ( l ): return DbU.fromLambda(l)
+   
+   
+   def buildFulladder ( editor ):
+   
+      # Get the Framework and all the master cells.
+       xr2_x2 = af.getCell( 'xr2_x1', Catalog.State.Views )
+       a2_x2  = af.getCell( 'a2_x2' , Catalog.State.Views )
+       o2_x2  = af.getCell( 'o2_x2' , Catalog.State.Views )
+   
+       UpdateSession.open()
+   
+       fulladder = af.createCell( 'fulladder' )
+       
+      # Create Instances.
+       a2_1  = Instance.create( fulladder,  'a2_1',  a2_x2 )
+       a2_2  = Instance.create( fulladder,  'a2_2',  a2_x2 ) 
+       xr2_1 = Instance.create( fulladder, 'xr2_1', xr2_x2 )
+       xr2_2 = Instance.create( fulladder, 'xr2_2', xr2_x2 )
+       o2_1  = Instance.create( fulladder,  'o2_1',  o2_x2 )
+       
+      # Create Nets.
+       vss = Net.create( fulladder, "vss" )
+       vss.setExternal( True )
+       vss.setGlobal  ( True )
+   
+       vdd = Net.create( fulladder, "vdd" )
+       vdd.setExternal( True )
+       vdd.setGlobal  ( True )
+   
+       cin = Net.create( fulladder, "cin" )
+       cin.setExternal( True )
+       xr2_2.getPlug( xr2_x2.getNet('i0') ).setNet( cin )
+       a2_2 .getPlug(  a2_x2.getNet('i0') ).setNet( cin )
+       
+       a = Net.create( fulladder, 'a' )
+       a.setExternal( True )
+       xr2_1.getPlug( xr2_x2.getNet('i0') ).setNet( a )
+       a2_1 .getPlug(  a2_x2.getNet('i0') ).setNet( a )
+       
+       b = Net.create( fulladder, 'b' )
+       b.setExternal( True )
+       xr2_1.getPlug( xr2_x2.getNet('i1') ).setNet( b )
+       a2_1 .getPlug(  a2_x2.getNet('i1') ).setNet( b )
+       
+       sout_1 = Net.create( fulladder, 'sout_1' )
+       xr2_1.getPlug( xr2_x2.getNet('q' ) ).setNet( sout_1 )
+       xr2_2.getPlug( xr2_x2.getNet('i1') ).setNet( sout_1 )
+       a2_2 .getPlug(  a2_x2.getNet('i1') ).setNet( sout_1 )
+       
+       carry_1 = Net.create( fulladder, 'carry_1' )
+       a2_1.getPlug( a2_x2.getNet('q' ) ).setNet( carry_1 )
+       o2_1.getPlug( o2_x2.getNet('i1') ).setNet( carry_1 )
+   
+       carry_2 = Net.create( fulladder, 'carry_2' )
+       a2_2.getPlug( a2_x2.getNet('q' ) ).setNet( carry_2 )
+       o2_1.getPlug( o2_x2.getNet('i0') ).setNet( carry_2 )
+   
+       sout = Net.create( fulladder, 'sout' )
+       sout.setExternal( True )
+       xr2_2.getPlug( xr2_x2.getNet('q') ).setNet( sout )
+       
+       cout = Net.create( fulladder, 'cout' )
+       cout.setExternal( True )
+       o2_1.getPlug( o2_x2.getNet('q') ).setNet( cout )
+   
+       UpdateSession.close()
+   
+       af.saveCell( fulladder, Catalog.State.Views )
+       return fulladder
+   
+   
+   def placeAndRoute ( editor, cell ):
+      # Run the placer.
+       etesian = Etesian.EtesianEngine.create(cell)
+       etesian.place()
+   
+       if editor:
+         editor.setCell( cell )
+         editor.fit()
+   
+       Breakpoint.stop( 1, 'After placement' )
+   
+      # Run the router.
+       katana = Katana.KatanaEngine.create(cell)
+       katana.digitalInit      ()
+       katana.runGlobalRouter  ()
+       katana.loadGlobalRouting( Anabatic.EngineLoadGrByNet )
+       katana.layerAssign      ( Anabatic.EngineNoNetLayerAssign )
+       katana.runNegociate     ( Katana.Flags.NoFlags )
+   
+       af.saveCell( cell, Catalog.State.Views )
+       return
+   
+   
+   def ScriptMain ( **kw ):
+       editor = None
+       if kw.has_key('editor') and kw['editor']:
+         editor = kw['editor']
+   
+       fulladder = buildFulladder( editor )
+       placeAndRoute( editor, fulladder )
+       return True 
diff --git a/hurricane/doc/hurricane/CMakeLists.txt b/hurricane/doc/hurricane/CMakeLists.txt
index 2770e097..59f8236c 100644
--- a/hurricane/doc/hurricane/CMakeLists.txt
+++ b/hurricane/doc/hurricane/CMakeLists.txt
@@ -7,7 +7,7 @@
                                      tabs.css
                    )
 
- if(BUILD_DOC and DOXYGEN_FOUND)
+ if(BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( hurricaneDoc ALL
                         cd ${HURRICANE_SOURCE_DIR}/doc/hurricane
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/hurricane/doc/viewer/CMakeLists.txt b/hurricane/doc/viewer/CMakeLists.txt
index 455dfe40..5f5d91f7 100644
--- a/hurricane/doc/viewer/CMakeLists.txt
+++ b/hurricane/doc/viewer/CMakeLists.txt
@@ -7,7 +7,7 @@
                                      tabs.css
                    )
 
- if(BUILD_DOC and DOXYGEN_FOUND)
+ if(BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( viewerDoc ALL
                         cd ${HURRICANE_SOURCE_DIR}/doc/viewer
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/katabatic/doc/CMakeLists.txt b/katabatic/doc/CMakeLists.txt
index 4d909b20..5358ace4 100644
--- a/katabatic/doc/CMakeLists.txt
+++ b/katabatic/doc/CMakeLists.txt
@@ -8,7 +8,7 @@
                                      tabs.css
                    )
 
- if(BUILD_DOC and DOXYGEN_FOUND)
+ if(BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( doc ALL
                         cd ${KATABATIC_SOURCE_DIR}/doc
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/kite/doc/CMakeLists.txt b/kite/doc/CMakeLists.txt
index 5b0ac841..96e5be16 100644
--- a/kite/doc/CMakeLists.txt
+++ b/kite/doc/CMakeLists.txt
@@ -8,7 +8,7 @@
                                      tabs.css
                    )
 
- if (BUILD_DOC and DOXYGEN_FOUND)
+ if (BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( doc ALL
                         cd ${KITE_SOURCE_DIR}/doc
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/unicorn/doc/unicorn/CMakeLists.txt b/unicorn/doc/unicorn/CMakeLists.txt
index 33d42ccb..156ecfcd 100644
--- a/unicorn/doc/unicorn/CMakeLists.txt
+++ b/unicorn/doc/unicorn/CMakeLists.txt
@@ -7,7 +7,7 @@
                                      tabs.css
                    )
 
- if (BUILD_DOC and DOXYGEN_FOUND)
+ if (BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target ( documentation ALL
                         cd ${UNICORN_SOURCE_DIR}/doc/unicorn
                      && ${DOXYGEN_EXECUTABLE} doxyfile
diff --git a/vlsisapd/doc/CMakeLists.txt b/vlsisapd/doc/CMakeLists.txt
index a0eac6e0..d09c1d01 100644
--- a/vlsisapd/doc/CMakeLists.txt
+++ b/vlsisapd/doc/CMakeLists.txt
@@ -1,5 +1,5 @@
 
- if(BUILD_DOC and DOXYGEN_FOUND)
+ if(BUILD_DOC AND DOXYGEN_FOUND)
  add_custom_target( doc ALL
                     cd ${VLSISAPD_SOURCE_DIR}/doc && ${DOXYGEN_EXECUTABLE} doxyfile )
  endif()