[pygccxml-commit] source/pyplusplus/docs pyplusplus.rest,1.6,1.7

[Roman <rom...@us...>]

Update of /cvsroot/pygccxml/source/pyplusplus/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv19394/pyplusplus/docs

Modified Files:
	pyplusplus.rest 
Log Message:
1. adding scripts to run py++ gui from command line
2. updating pyplusplus introduction

Index: pyplusplus.rest
===================================================================
RCS file: /cvsroot/pygccxml/source/pyplusplus/docs/pyplusplus.rest,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** pyplusplus.rest	6 Apr 2006 12:34:45 -0000	1.6
--- pyplusplus.rest	6 Apr 2006 17:44:46 -0000	1.7
***************
*** 17,21 ****
  This introduction will describe code generation process using `pyplusplus`_. 
  I hope, that after you finished to read it, you will understand how powerful
! `pyplusplus`_. 
  
  -----------------------
--- 17,21 ----
  This introduction will describe code generation process using `pyplusplus`_. 
  I hope, that after you finished to read it, you will understand how powerful
! `pyplusplus`_ is. 
  
  -----------------------
***************
*** 24,40 ****
  
  `boost.python`_ library allows you to expose C++ code to `Python`_ in quick and 
! elegant way. Almost the whole process of exposing declarations can be automated. 
! Lets see the code generation process definition:
! 
! .. image:: ./code_generation_process.png
! 
! 
! Next few paragraphs will explain more about every step.
  
  *"read declarations"*
  ---------------------
  
! `pyplusplus`_ uses `pygccxml`_ to read all declaration from source files. 
  
  
  *"build module"*
--- 24,46 ----
  
  `boost.python`_ library allows you to expose C++ code to `Python`_ in quick and 
! elegant way. Almost the whole process of exposing declarations can be automated
! by use of `pyplusplus`_. Code generation process, using `pyplusplus`_ consists
! from few steps. Next paragraphs will tell you more about every step.
  
  *"read declarations"*
  ---------------------
  
! `pyplusplus`_ does not reinvent the wheel. `pyplusplus`_ uses 'GCC C++ compiler`_
! to parse C++ source files. To be more precision, the tool chain looks like this:
  
+ 1. source code is passed to `GCC-XML`_
+ 2. `GCC-XML`_ passes it to 'GCC C++ compiler`_
+ 3. `GCC-XML`_ generates an XML description of a C++ program from GCC's internal 
+    representation.
+ 4. `pyplusplus`_ uses `pygccxml`_ package to read `GCC-XML`_ generated file.
+ 
+ In short, you can be sure, that all your declarations are read correctly.
+ 
+ .. _`GCC C++ compiler` : http://www.gnu.org/software/gcc
  
  *"build module"*
***************
*** 46,53 ****
  
      1. which declarations should be exported    
!     2. how this specific declaration should be exported
  
! Of course `pyplusplus`_ can not answer those question, but it provides maximum
! help for you to implement an user requirements. 
  
  How can `pyplusplus`_ help you with first question? `pyplusplus`_ provides very 
--- 52,61 ----
  
      1. which declarations should be exported    
!     2. how this specific declaration should be exported or, if I change a little
!        a question, what code should be written in order I get access from Python
!        to that functionality
  
! Of course, `pyplusplus`_ can not answer those question, but it provides maximum
! help to implement an user requirements. 
  
  How can `pyplusplus`_ help you with first question? `pyplusplus`_ provides very 
***************
*** 55,59 ****
  
  For example in one line of code you can select all free functions that have 
! two arguments, where first one is ``int &`` and second one is any:
  ::
  
--- 63,68 ----
  
  For example in one line of code you can select all free functions that have 
! two arguments, where the first argument has type ``int &`` and the type of the 
! second argument is any:
  ::