Greatly simplify and cleanup first page of the documentation

Author: iMichka

docs/index.rst

@@ -1,89 +1,40 @@
 pygccxml
 ========
 
-The purpose of `pygccxml` is to read a generated file and provide a simple
+The purpose of `pygccxml` is to read a generated xml file and provide a simple
 framework to navigate C++ declarations, using Python classes.
 
-What can you do with it?
-------------------------
 Using `pygccxml` you can:
 
-* parse C++ source code
-* create a powerful code generator
-
-  + `Py++ <http://sourceforge.net/projects/pygccxml/files/pyplusplus/>`_ is heavily based on `pygccxml`
-  + generate `WSDL`_ file from sources
-  + ...
-
-* generate UML diagrams
-* build code analyzer
+* Parse C++ source code
+* Create a powerful code generator
+* Generate UML diagrams
+* Build code analyzers
 * ...
 
-Query interface
----------------
-`pygccxml` provides simple and powerful API to query declarations tree.
-
-How many lines are needed to write the following query?
-::
-
-  select all free functions from the project
-  where
-      name equal to "do_smth"
-      return type is void
-      function has two arguments
-      second argument type is int
-
-Only single line of code is needed:
-
-.. code-block:: python
-
-  # global_ns is the reference to declarations, which describes the global(::) namespace
-  # "None" means any type.
-  global_ns.free_functions("do_smth", return_type="void", arg_types=[None, "int"])
+Installing
+==========
 
-If you want to know more about provided API read the :doc:`query interface <query_interface>`
-document or the :doc:`API documentation <apidocs/api>`
+You can use pip to install pygccxml::
 
-Type traits
------------
-`pygccxml` provides a lot of functionality to analyze C++ types and relationship
-between them. For more information please refer to the :doc:`design <design>` document or
-the :doc:`API documentation <apidocs/api>`. A few examples:
+  pip install pygccxml
 
-* ``is_convertible(from, to)``
+To install from source, you can use the usual procedure::
 
-  returns ``True`` if there is a conversion from type ``from`` to type ``to``,
-  otherwise ``False``
+  python setup.py install
 
-* ``is_unary_operator(oper)``
-
-  returns ``True`` if ``oper`` describes an unary operator
-
-
-Declaration dependencies
-------------------------
-You can query a declaration, about it dependencies - declarations it depends on.
-This is a very powerful and useful feature. `Py++ <http://sourceforge.net/projects/pygccxml/files/pyplusplus/>`_, for example, uses this functionality to check that user creates Python
-bindings for all relevant declarations.
-
-Caching
--------
-Consider the following situation: you have to parse the same set of files every
-day. There are 2 possible ways to complete the task:
+Examples
+========
 
-* create a header file that includes all files you need to parse
+The :doc:`examples <examples>` are a good way to learn how to use `pygccxml`.
 
-* parse each file separately and then join the results
+`pygccxml` provides a powerful API. If you want to know more about the provided API
+read the :doc:`query interface <query_interface>` document or the
+:doc:`API documentation <apidocs/api>`.
 
-The difference between these approaches is the caching algorithm used in the
-second case. `pygccxml` supports both of them. Actually `pygccxml` supports
-more caching strategies, read the API documentation for more information.
+Contributing
+============
 
-Binary files parser
--------------------
-`pygccxml` contains a functionality which allows to extract different information
-from binary files (`.map`, `.dll`, `.so`) and integrate it with the existing
-declarations tree.
 
 License
 =======
@@ -105,6 +56,7 @@ Documentation contents
    :maxdepth: 1
 
    download
+   examples
    documentation
    query_interface
    design
@@ -133,4 +85,3 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-