summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* scanner: Add --include-uninstalledColin Walters2010-09-021-4/+8
| | | | | | | | We need a way to add a .gir file, without also attempting to load the pkg-config file for it (since it may not be installed yet). Example: clutter builds multiple .gir files, Cally-1.0 depends on Clutter-1.0.
* scanner: Add --accept-unprefixedColin Walters2010-09-011-0/+4
| | | | This is necessary for Mutter right now.
* [GIRepository] Rename GTypelib to GITypelibJohan Dahlin2010-08-311-1/+1
| | | | | Keep a typedef for backwards compatibility, until the major bindings has moved over.
* Major rewriteColin Walters2010-08-311-39/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | One of the first big changes in this rewrite is changing the Type object to have separate target_fundamental and target_giname properties, rather than just being strings. Previously in the scanner, it was awful because we used heuristics around strings. The ast.py is refactored so that not everything is a Node - that was a rather useless abstraction. Now, only things which can have a GIName are Node. E.g. Type and Field are no longer Node. More things were merged from glibast.py into ast.py, since it isn't a very useful split. transformer.py gains more intelligence and will e.g. turn GLib.List into a List() object earlier. The namespace processing is a lot cleaner now; since we parse the included .girs, we know the C prefix for each namespace, and have functions to parse both C type names (GtkFooBar) and symbols gtk_foo_bar into their symbols cleanly. Type resolution is much, much saner because we know Type(target_giname=Gtk.Foo) maps to the namespace Gtk. glibtransformer.py now just handles the XML processing from the dump, and a few miscellaneous things. The major heavy lifting now lives in primarytransformer.py, which is a combination of most of annotationparser.py and half of glibtransformer.py. annotationparser.py now literally just parses annotations; it's no longer in the business of e.g. guessing transfer too. finaltransformer.py is a new file which does post-analysis for "introspectability" mainly. girparser.c is fixed for some introspectable=0 processing.
* Makefile.introspection: Add _EXPORT_PACKAGES variable.Luca Bruno2010-08-281-3/+9
| | | | This new variable maps to --pkg-export.
* Remove --noclosure argumentColin Walters2010-08-171-3/+0
| | | | It's obsoleted by the introspectable=0 handling.
* [man] Mention XDG_DATA_DIRSJohan Dahlin2010-08-131-1/+4
|
* Add new API g_typelib_require_private()Steve Frécinaux2010-08-031-0/+1
| | | | | | | This is equivalent to g_typelib_require() but intended for use with private typelibs, which get loaded from the provided directory. https://bugzilla.gnome.org/show_bug.cgi?id=625672
* [girepository] Update documentationJohan Dahlin2010-07-281-0/+1
|
* [GIRepository] Rename g_irepository_enumerateJohan Dahlin2010-07-281-0/+1
| | | | Rename it to g_irepository_enumerate_versions
* Don't conditionalize reference/ build on gtk-doc being enabledColin Walters2010-07-121-4/+1
| | | | gtk-doc already does that for us
* Add support for non-GObject fundamental objectsJohan Dahlin2010-07-091-0/+13
| | | | | | | | | | | | | | This patch adds support for instantiable fundamental object types, which are not GObject based. This is mostly interesting for being able to support GstMiniObject's which are extensivly used in GStreamer. Includes a big test case to the Everything module (inspired by GstMiniObject) which should be used by language bindings who wishes to test this functionallity. This patch increases the size of the typelib and breaks compatibility with older typelibs. https://bugzilla.gnome.org/show_bug.cgi?id=568913
* In verbose mode, print out the dump compilationColin Walters2010-07-071-0/+3
| | | | | | | | | | | | When debugging the dumper, it's extremely useful to be able to see the argument it's passing to the compiler/linker. This patch makes g-ir-scanner work the same way as libtool basically; we default to printing out stuff, and add a --quiet option. The Makefile.introspection handles passing --quiet automatically. https://bugzilla.gnome.org/show_bug.cgi?id=622751
* Allow attributes on parameters and return valuesDavid Zeuthen2010-06-241-0/+2
| | | | | | | | | | | | | | | | | | Any annotation where the key has a dot in the name will go into the attribute list. For example * @arg: (foo.bar baz): some arg the parameter @arg will get the attribute with key foo.bar and value baz. This also works for. * Returns: (foo.bar2 baz2): the return value Also add tests for this new feature. See https://bugzilla.gnome.org/show_bug.cgi?id=571548 Signed-off-by: David Zeuthen <davidz@redhat.com>
* Support introspectable=no attribute, add warnings frameworkColin Walters2010-06-171-0/+6
| | | | | | | | | | | | | | | | | | This work allows us to move closer to replacing gtk-doc, among other things. We add a generic attribute "introspectable", and inside the typelib compiler if we see "introspectable=no", we don't put it in the typelib. This replaces the hackish pre-filter for varargs with a much more generic mechanism. The varargs is now handled in the scanner, and we emit introspectable=no for them. Add generic metadata to Node with references to file/line/column, which currently comes from symbols. Add scanner options --warn-all and --warn-error. https://bugzilla.gnome.org/show_bug.cgi?id=621570
* [docs] Add missing symbolsJohan Dahlin2010-06-111-2/+20
|
* Support the (transfer) annotation for properties.Tomeu Vizoso2010-06-081-0/+1
| | | | | | | | | | | | * girepository/*: Add g_property_info_get_ownership_transfer() and write the transfer attribute of properties into the typelib. * giscanner/*: Parse the (transfer) annotation and write it into the .gir. * tools/generate.c: Read the transfer annotation for properties and write to the .tgir. https://bugzilla.gnome.org/show_bug.cgi?id=620484
* [docs] Fix a typo in the overviewJohan Dahlin2010-05-312-41/+131
| | | | Regenerate PNG
* [docs] Add an overview pageJohan Dahlin2010-05-305-1/+467
| | | | | Add an overview page for the documentation with a simple diagram explaining the relationship between the main components.
* [docs] Link to top of pagesJohan Dahlin2010-05-281-17/+17
|
* [docs] SignalInfo is a sub-struct of CallableInfoJohan Dahlin2010-05-271-1/+1
|
* Remove g_arg_info_is_dipper from documentationJohan Dahlin2010-05-271-1/+0
|
* [docs] Add a struct hierarchy pageJohan Dahlin2010-05-252-0/+45
|
* [docs] Reorganize sectionsJohan Dahlin2010-05-191-25/+27
| | | | | | Mark macros as standard and a couple of structs as private. Remove multiple defintion of GITypelib to reduce gtk-doc spew.
* [docs] Remove multiple GIFunctionInfo linkJohan Dahlin2010-05-191-1/+0
|
* [docs] Remove title from gi-sections.txtJohan Dahlin2010-05-191-19/+0
| | | | They will be defined in inline gtk-doc comments.
* [docs] Reorganize structs into chaptersJohan Dahlin2010-05-182-123/+237
| | | | | | Instead of displaying all structures and methods in girepository.h on one page, split them out to a bunch of pages.
* [girepository] Document most of the structsJohan Dahlin2010-05-181-1/+2
|
* [doc] Add missing symbolsJohan Dahlin2010-05-181-4/+20
|
* [doc Makefile] Remove html/ xml/ and tmpl/Johan Dahlin2010-05-181-1/+5
| | | | | When invoking make clean, remove the directories with generated documentation
* [doc] Update to work with latest gtk-doc releaseJohan Dahlin2010-05-181-20/+9
| | | | Use xi:includes instead of sgml entities
* [doc] Remove private API from docsJohan Dahlin2010-05-182-68/+11
|
* * docs/g-ir-scanner.1: Man page for g-ir-scanner(1) had long options with ↵Saleem Ansari2010-04-261-27/+27
| | | | | | three dashes, changed to two dashes. https://bugzilla.gnome.org/show_bug.cgi?id=616837
* [docs] Remove reference to girwriter.cJohan Dahlin2010-03-251-1/+0
|
* Update NEWSGOBJECT_INTROSPECTION_0_6_3Johan Dahlin2009-06-221-1/+0
|
* Remove orphan text, left over from parent document.C. Scott Ananian2009-05-121-6/+0
|
* Bug 571548 - Generic attributesColin Walters2009-03-031-1/+2
| | | | | | | | We now support an extensible mechanism where arbitrary key-value pairs may be associated with almost all items, including objects, methods, and properties. These attributes appear in both the .gir and the .typelib.
* Disable more of the build if gtk-doc is disabledJohan Dahlin2009-02-272-2/+6
|
* Bug 572434 - Associate interfaces with their C structuresColin Walters2009-02-251-1/+2
| | | | | | | | Similar to GObject class structs, we pair up GInterfaces with their C structures. Also, move some GLib-specific things into glibast.py, and make the naming more generic.
* Bug 571373 - Move typelib docs from typelib-format.txt into girepository.hColin Walters2009-02-183-1170/+45
| | | | | | typelib-format.txt was growing out of date; a good solution to this is to move it closer to the code it's documenting. By doing this we also gain the ability to use gtk-doc on it.
* gtk-doc fixes: Require 1.10, fix --name-space argument typo, change Typelib ↵Colin Walters2009-02-182-2/+2
| | | | section title
* Remove generated tmpl/ directory; we will use inline section commentsColin Walters2009-02-189-2496/+0
| | | | | | | The gtk-doc manual suggests using inline comments: http://library.gnome.org/devel/gtk-doc-manual/stable/documenting.html.en So we'll do that.
* Various gtk-doc fixes: only require 1.11, remove generated files, add docs ↵Colin Walters2009-02-182-1875/+0
| | | | | | | | | | to SUBDIRS The gtk-doc introductory commit introduced some generated files; remove those. We apparently only require 1.11, so downgrade to that. Finally, the docs directory was missing from the toplevel SUBDIRS.
* Avoid a couple of gtk-doc warningsJohan Dahlin2009-02-142-0/+116
| | | | | Do this by including the generated annotation glossary.
* Begin to document the GIR formatJohan Dahlin2009-02-123-5/+36
|
* Add gtk-doc supportJohan Dahlin2009-02-1218-0/+4763
|
* g-ir-scanner.1: add information about include paths for source files.Xan Lopez2009-02-081-0/+6
| | | | svn path=/trunk/; revision=1092
* Bug 551738 - Associate classes with their structsColin Walters2009-02-061-3/+12
| | | | | | | | | | | | | | | | | | | | | Inside glibtransformer, we now look at structures ending in "Class" and see if they have an associated GlibObject (i.e. a structure of the same name without the "Class" suffix). If found, pair them up. The .gir file for <class> gains an attribute denoting its associated class struct. Any <record> many now have a glib:is-class-struct-for annotation which tells which (if any) <class> for which it defines the layout. In the .typelib, we record the association between the class and its structure. Generic structures however just have a boolean saying whether they're a class struct. (Going from a generic class struct to its class should not be necessary). Finally, we expose GIRepository APIs to access both bits of information from the .typelib. svn path=/trunk/; revision=1088
* Bug 556489 – callback annotationsAndreas Rottmann2009-01-031-2/+30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2008-01-03 Andreas Rottmann <a.rottmann@gmx.at> Bug 556489 – callback annotations * giscanner/transformer.py * tools/generate.c (write_callable_info): Write out the new scope, closure and destroy attributes. * giscanner/transformer.py (Transformer._type_is_callback): New method, checking if a given type is a callback. (Transformer._augment_callback_params): New method; adds information (closure, destroy) to callback parameters. (Transformer._handle_closure, Transformer._handle_destroy): New methods, auxiliary to _augment_callback_params. (Transformer._create_function): Call _augment_callback_params(). (Transformer._create_parameter): Handle scope option. (Transformer._create_typedef_callback): New method, creates a callback, and registers it in the typedef namespace (Transformer._create_typedef): Use _create_typedef_callback() instead of the plain _create_callback(). * giscanner/ast.py (Parameter): Added callback-related fields. * giscanner/girwriter.py: Write out new Parameter fields. * girepository/girnode.h (GIrNodeParam): Added fields scope, closure and destroy. * girepository/gtypelib.h (ArgBlob): Ditto. * girepository/girparser.c (start_parameter): Handle new fields. * girepository/girmodule.c (g_ir_module_build_typelib): Adjust arg_blob_size, bump major version due to this change. * girepository/girnode.c (g_ir_node_get_full_size_internal) (g_ir_node_build_typelib) * girepository/gtypelib.c (g_typelib_check_sanity): ArgBlob size adjustments. (g_ir_node_build_typelib): Fill in new ArgBlob flags from param. * girepository/girepository.h (GIScope): New enumeration, listing the different possible scopes for callbacks. * girepository/ginfo.c (g_arg_info_get_scope) (g_arg_info_get_closure, g_arg_info_get_destroy): Accessors for callback-related argument indices (callback scope, closure for a callback, destroy notification for a callback). * tests/scanner/: Added testcases for new features. svn path=/trunk/; revision=998
* Add --libtool option which we expect Automake-using people to passColin Walters2008-11-261-0/+3
| | | | svn path=/trunk/; revision=977
View Lorry Controller Status