[pygccxml-commit] SF.net SVN: pygccxml:[1683] pygccxml_dev/docs
Brought to you by:
mbaas,
roman_yakovenko
From: <rom...@us...> - 2009-02-16 08:31:06
|
Revision: 1683 http://pygccxml.svn.sourceforge.net/pygccxml/?rev=1683&view=rev Author: roman_yakovenko Date: 2009-02-16 08:30:56 +0000 (Mon, 16 Feb 2009) Log Message: ----------- update docs Modified Paths: -------------- pygccxml_dev/docs/pygccxml.rest pygccxml_dev/docs/query_interface.rest Modified: pygccxml_dev/docs/pygccxml.rest =================================================================== --- pygccxml_dev/docs/pygccxml.rest 2009-02-15 20:51:18 UTC (rev 1682) +++ pygccxml_dev/docs/pygccxml.rest 2009-02-16 08:30:56 UTC (rev 1683) @@ -1,4 +1,4 @@ -================ +================ pygccxml package ================ @@ -96,7 +96,13 @@ second case. `pygccxml` supports both of them. Actually `pygccxml` supports more caching strategies, read the API documentation for more information. +Binary files parser +------------------- +`pygccxml` contains functionality which allows to extract different information +from binary files ( `.map`, `.dll`, `.so` ) and integrate it with the existing +declarations tree. + ------- License ------- Modified: pygccxml_dev/docs/query_interface.rest =================================================================== --- pygccxml_dev/docs/query_interface.rest 2009-02-15 20:51:18 UTC (rev 1682) +++ pygccxml_dev/docs/query_interface.rest 2009-02-16 08:30:56 UTC (rev 1683) @@ -22,7 +22,7 @@ query = query & ~declarations.access_type_matcher_t( 'public' ) global_ns.member_functions( function=query, arg_types=[None, 'int &'] ) -The example is complex, but still readable. In many cases you will find +The example is complex, but still readable. In many cases you will find yourself, looking for one or many declarations, using one or two declaration properties. For example: @@ -38,11 +38,16 @@ As you already know, ``pygccxml.declarations`` package defines the following classes: -* ``scopedef_t`` - base class for all classes, that can contain other declarations +* :class:`scopedef_t <pygccxml.declarations.scopedef.scopedef_t>` - base class + for all classes, that can contain other declarations -* ``namespace_t`` - derives from ``scopedef_t`` class, represents C++ namespace +* :class:`namespace_t <pygccxml.declarations.namespace.namespace_t>` - derives + from :class:`scopedef_t <pygccxml.declarations.scopedef.scopedef_t>` class, + represents C++ namespace -* ``class_t`` - derives from ``scopedef_t`` class, represents C++ class/struct/union. +* :class:`class_t <pygccxml.declarations.class_declaration.class_t>` - derives + from :class:`scopedef_t <pygccxml.declarations.scopedef.scopedef_t>` class, + represents C++ class/struct/union. So, the query methods defined on ``scopedef_t`` class could be used on instances of ``class_t`` and ``namespace_t`` classes. I am sure you knew that. @@ -64,9 +69,9 @@ header_dir=None, header_file=None, recursive=None ) - + mem_fun = member_function #just an alias - + def member_functions( self, name=None, function=None, @@ -76,7 +81,7 @@ header_file=None, recursive=None, allow_empty=None ) - mem_funs = member_functions + mem_funs = member_functions As you can see, from the method arguments you can search for member function @@ -106,13 +111,13 @@ * ``return_type`` - the function return type. This argument can be string or an object that describes + the function return type. This argument can be string or an object that describes C++ type. .. code-block:: python mem_funcs = my_class.member_functions( return_type='int' ) - + i = declarations.int_t() ref_i = declarations.reference_t( i ) const_ref_i = declarations.const_t( ref_i ) @@ -128,7 +133,7 @@ .. code-block:: python - mem_funcs = my_class.member_functions( arg_types=[ None, 'int'] ) + mem_funcs = my_class.member_functions( arg_types=[ None, 'int'] ) ``mem_funcs`` will contain all member functions, which have two arguments and type of second argument is ``int``. @@ -286,10 +291,8 @@ .. _`call policies`: http://boost.org/libs/python/doc/tutorial/doc/html/python/functions.html#python.call_policies .. _`Call policies`: http://boost.org/libs/python/doc/tutorial/doc/html/python/functions.html#python.call_policies -.. _`SourceForge`: http://sourceforge.net/index.php .. _`Python`: http://www.python.org .. _`GCC-XML`: http://www.gccxml.org .. _`UML diagram` : declarations_uml.png .. _`parser package UML diagram` : parser_uml.png -.. _`ReleaseForge` : http://releaseforge.sourceforge.net .. _`boost::type_traits` : http://www.boost.org/libs/type_traits/index.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |