Update NEWS

Bug 584423 – Add short/ushort support

Add type tags for short and ushort, plus all of the requisite code needed
to utilize them in libgirepository.
Add support in the scanner's AST files.
Add test functions to the everything library and the expected gir file.

gtypelib.c constant validation fixed by Colin Walters <walters@verbum.org>

Update annotation expected "tgir" for previous commit

Since we're not writing out the zero-terminated flag now when
we shouldn't, update the tests too.

Bug 585328 - Only set zero_terminated flag for types we know are

Rationalize our setting of the zero_terminated flag; we shouldn't
set it if the gir doesn't say to.

Everything: add a boxed property to TestObj

Make sure the scanner and compiler are able to find libeverything.so.1

and that it uses the uninstalled version.
Fixes make check (when libeverything.so.1 was uninstalled).

Bug 585579: actually check Everything-1.0-expected.gir

As discussed in bug 585908, we also rename CHECKGIRS and EXPECTEDGIRS to
match the naming in tests/scanner/Makefile.am.

Fix distcheck. A couple of files was missing from EXTRA_DIST.

Annotate g_get_system_*_dirs ()

Bug 585579: Update Everything-1.0-expected.gir to match recent array/strv changes.

Bug 585373: Add annotations for g_spawn_* functions.

Bug 585584: Fix warnings in girparser backtrace functionality and compiler.c

Bug 585374: Fix misspelling of 'infinite'.

Bug 581685: Parse parameterized types (using <>) in annotations.

You can now specify a nested parameterized type in annotations as
(for example):
  @param: (type GLib.HashTable<utf8,GLib.HashTable<utf,utf>>)
or
  @param: (element-type utf8 GLib.HashTable<utf,utf>)

New test functions for the Everything typelib show how it works.

Make g-ir-compiler find files installed by make install

When ./configure --prefix $HOME/some/where is used gobject-introspection
will happily install the files into $HOME/some/where/data/gir-1.0 but
it will refuse to find them. Apply the same trick as in
girepository/girepository.c:init_globals to find the gir files.

Unifiy the name gir-1.0 in GIR_SUFFIX and use it throughout the
project, introduce GIR_DIR which holds the path to the gir files and
update girparser and transformer.py to look into this path.

Don't fail if no --output option is specified

Printing to stdout is legitimate.

Remove duplicate typelib installation rules

No need to list them twice, and it confuses/breaks some install tools.

Bug 577546 - More annotations for GLib, GObject, Gio

Patch modified from one by Norbert Freese <nf2.email@gmail.com>.

Bug 577534 - Use rename to write new typelibs, instead of in-place overwrite

This avoids having processes with the typelibs currently open exploding
immediately.

Bug 584453 - Handle char ** correctly (and const variation)

This patch fixes our default handling of char **.  We add Return
node types as a case where we test for array handling.

Remove the hardcoded assumption of array = "no transfer", just
use the separate Parameter/Return cases.  This change causes
inout char ** to be transfer="full", but that seems more correct.

Add a test_strv_out which is unannotated, rename current to test_strv_out_container

We need a test case for a plain unannotated char ** return value, which
should be an array.

Keep the old annotated test as a test case for the container transfer.

Bug 585081 - Correct everything linkage

We need to link with gobject.

Move Everything into gir/, since it's a public library

Everything isn't a test for quite a while now, it's a public library.
So move it to gir/.

Add an Everything-1.0-expected.gir, test Everything versus it

We should be testing the Everything library as well.

Add GLclampf to the GL GIR

The GLclampf type is missing from the GL definitions.

http://bugzilla.gnome.org/show_bug.cgi?id=584816

Annotations for g_option_context_parse.

These annotations match those for gtk_init(), which takes the same
types of arguments.

A few transfer-related tests for "Everything"

Fix pep8.py and its invocation.

pep8.py:input_file() normally returns the number of errors found in a
given file, but it returns an empty dict if the file is excluded.  Change
it to return 0 instead.

config.py is auto-generated with a prefix that may be longer than
80 characters.  Exclude config.py in the pep8.py check.  This fixes
4042.

Better handle classes with non-standard to_underscore names.

Previously we tried to guess what the "underscore version" of a class name
would be, but for classes like NMSetting8021x we'd guess "nm_setting8021x"
instead of "nm_setting_802_1x".  All such guesses are subject to error:
instead let's try to use the prefix of the _get_type() method instead, and
only guess if that doesn't work.

We do this for both class names and when detecting methods.  An additional
type with a "non-standard" underscored version (TestWi8021x) added to the
everything.[ch] test suite to test proper conversion.

GdkWindow and GObject have unusual get_type methods; add special quirks
to handle these (at least until the methods are renamed upstream).

(Slightly modified for PEP8 compliance by Colin Walters)

Signed-off-by: Colin Walters <walters@verbum.org>

Update doc comments.

The enumeration values cited here were out of date.  Rewrite to eliminate
the explicit mention of the enumeration value, to prevent it from
drifting out of date again in the future.

Add GHash tests to Everything test GI library.

Fix the list comparison assertions.

We weren't checking the length of the input list, and we were erroneously
comparing every element in the test sequence against the *first* element
of the passed-in list.

Everything: more tests for integer array parameters.

Fix annotations for GList and GSList tests.

Enable the utf8 tests in the everything module.

We needed to tweak a couple of the tests for correctness.

Allow the use of the "Rename To" annotation for literal method renaming.

As originally implemented, this annotation was only used for method
overloading (argument signature polymorphism).  Allow it to be used to
clean up historically poorly-named methods as well.

Remove orphan text, left over from parent document.

Remove (out) annotation for now from Everything structs

Right now these annotations don't work; (out) is for callee-allocates.
For more information see
http://bugzilla.gnome.org/show_bug.cgi?id=573314

Fix typo in the TestInterface gtype name

Add an interface to Everything

Add element type annotations for GList arguments

g_app_info_launch and g_app_info_launch_uris needed element type annotations
for their GList arguments.

Avoid writing out empty array if we have no _get_type functions

Zero length arrays are a GNU C extension, so this way we don't
fail on non-GCC.

Fix 'Could not find GIR file ...' error to use right filename.

Also plug a leak; girname was previously only freed on error.

Bug 576605 - Get rid of GI_SCOPE_TYPE_OBJECT

Remove support for (scope object) as it lacks a real use case.

Annotate g_filename_completer_get_completions

Remove spurious addition of 'GSList *handlers' in last commit

Additions to the 'Everything' namespace

- Make the destroy-notfied callback test harder by retaining the
  callbacks until test_callback_thaw_notifications() is called.

Bug 576323 - Fix inner constant parsing Signed-off-by: Didier 'Ptitjes <ptitjes@free.fr>

Signed-off-by: Colin Walters <walters@verbum.org>

Include g-ir-scanner.in in the distribution

and other make distcheck fixes.

Add a test signal with an argument flagged as G_SIGNAL_TYPE_STATIC_SCOPE

Add several GLib annotations

Bug 574284 - Add support for a 'closure' and 'destroy' annotations

This allows to annotate cases where the heuristics don't work.

TODO: According to Juerbi, there are cases where two callbacks refer
      to the same user_data, which is prohibited by the current
      implementation.

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Some small cosmetic tweaks

* Fix compiler warnings:

- Missing return value in annotation-testing code

- Fix two function declarations to have a (void) parameter list --
  this is not C++ ;-)

* Add tools/g-ir-scanner to .gitignore, as it's now generated

Bug 556475 – support Shadows: annotation

Add support for the 'Rename To:' annotation for functions and methods.

Bug 564016 - Include c:prefix in typelib, use it to optimize find_by_gtype

Parse the c:prefix from the .gir, include it in the header.  Armed with this
information, we can now optimize lookups of GTypes because we
have the requirement that GTypes must start with the c:prefix.  We do
fall back though if a lookup fails.

Bug 564016 - Add c:prefix to .gir

This has a few use cases; the main one in mind right now is that
when we place this in the .typelib as well, we can use it to optimize
lookups based on GType names, by skipping entirely typelibs whose
c:prefix is not a prefix of the target type lookup.

Bug 575613 - Enum stripping with common prefix, also use "_" consistently

Some enums have members which have a common prefix which doesn't
match that of the enum name, but it also longer than the global
namespace prefix.  Instead, try stripping the common prefix first,
and only if that fails fall back to the global strip.

Also, for glib-registered enums we were using the nick, which
typically has "-" as a separator.  Replace that with "_" for
consistency between unregistered enums and registered.

utils.py:strip_common_prefix is now unused, delete.

Substitute g-ir-scanner in Makefile, not in configure.ac

This avoids issues with unexpanded variables, i.e. ${exec_prefix}/libdir

Bug 565147 - Add (type) annotation to override the C type definition

We previously supported (type) on signals only, extend it to all cases.
This is useful for a few cases where libraries use a superclass like GtkWidget*
for C convenience, where the actual type is a subclass.

Bug 574501 - Install giscanner Python module to private directory

We don't want to pollute the global namespace with our private
libraries.  Also, this sidesteps all the craziness that is happening
with OS vendors changing how Python installs modules.

Bug 574139 – There is no way to identify 'user_data' arguments in the callback signature

Add a heuristic to the scanner that flags arguments of callbacks that
are named 'user_data' (exact match) and have a 'any (void*) type.

These arguments are marked by setting the 'closure' field of ArgBlob
to the index of themselves.

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Bug 557383 - Virtual method support

Broadly speaking, this change adds the concept of <vfunc> to the .gir.
The typelib already had most of the infrastructure for virtual functions,
though there is one API addition.

The scanner assumes that any class callback slot that doesn't match
a signal name is a virtual.  In the .gir, we write out *both* the <method>
wrapper and a <vfunc>.  If we can determine an association between
them (based on the names matching, or a new Virtual: annotation),
then we notate that in the .gir.

The typelib gains an association from the vfunc to the function, if
it exists.  This will be useful for bindings since they already know
how to consume FunctionInfo.

Bug 573332 - Allow annotation of enums as bitfields

Add support for a `(type bitfield)' annotation for enums.

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Introduce documentation-block options

Allow a documentation block to have options, e.g.:

/*
 * SomeType: (OPT-NAME VALUE) ...
 */

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Add XftGlyphSpec to xft-2.0.gir

For PangoXft.

Add XTrapezoid to xlib-2.0.gir

This is necessary for PangoXft.

Bug 571548 - Generic attributes

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.

Keep TestStructA as simple by moving GObject member to a new structure

The change in commit 2912b broke the gjs test suite which was relying
on TestStructA being "simple" (i.e. only having primitive fields as members).

Remove hand-written .gir files, move PEP-8 inquisition into top Makefile.am

We have more comprehensive testing in tests/scanner and tests/everything,
and these tests were designed from a time when we were trying to make
the g-ir-generate output exactly match the .gir, which has not been true
for some time and will not be in the future.

Add a parent parmeter to g_ir_node_build_typelib

This will be useful for later changes which need to inspect the parent.

Add srcdir, so distcheck passes

Dist m4 files

Add GObject-2.0.xpath to EXTRA_DIST

Disable more of the build if gtk-doc is disabled

Add --all option to g-ir-generate

Add --all option, which is intended to show some information not
usually included in the GIR.

Currently, it shows the size of structs and unions.

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Additions to "Everything" test namespace

Add a signal and a "bare" member (i.e. a member without getter/setter)
to TestObj.

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Revert "Bug 557383 - Virtual function support"

This reverts commit 4470a24e8cf3827efaddcfe240c3271cf1a0d6c0.

Needs more work as it turns out, we need to figure out the binding
story.

Bug 573306 – Relax callback grouping detection rules

Make the callback grouping heuristic more lax: consider all pointer
parameters ending in 'data' to be the user_data parameter (instead of
requiring an exact 'user_data' name).

Signed-off-by: Andreas Rottmann <a.rottmann@gmx.at>

Merge branch 'bug557383-vfuncs'

Bug 557383 - Virtual function support

In order to determine whether a method is virtual, by default we look
at the class table to find a callback field.  This should be fairly reliable,
but we may also later need annotations to more finely control this
in the case of a name clash with a signal.

Don't assume _pkgconfig_packages is set.

This fixes a cache issue where the pickle in the cache doesn't
have self._pkgconfig_packages set in its instance

Bug 572434 - Associate interfaces with their C structures

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 555964 - Parse floating-point #defines

Previously we just supported int and string, add double to this.
Technically we should probably differentiate between float and
double, but it's not likely to be very useful in practice to do so.

Merge commit 'origin'

Fix a typo, reel -> real

Handle multiple arguments for $CC

This makes the dumper not fail for people who set $CC to e.g. "distcc gcc".

Bug 572790 - Don't register #defines from .c files as constants

We keep track of the source filename for every symbol.  This enables
us to later filter symbols based on that name.

Bug 572965 – Allow generic marshaller to be called without parameters

girepository/ginvoke.c: handle the case where n_param_values == 0.
tests/invoke/genericmarshaller.c: add a test case for this.

Bug 561604 - Don't fail on va_list*

gvariant uses va_list *; we were previously skipping va_list, we should
skip indirect variants as well.

Punt on building with older gtk-doc; version skew in gtk-doc.make makes patching hard

We'll just require 1.12, which is the version fixed to work with shave.

shave fix: Patch gtk-doc.make if we don't have it yet

This fixes the build with gtk-doc enabled.

Do not include yyoutput in the generated lexer

Avoids a compilation warning (unused function)
in the generated lexer output.

Handle the return value to fwrite properly

Fix warnings pointed out by GCC

Be less verbose

Mention that we're generating a GIR

Reformat the output to fit shave

Disable a UTF-8 warning per default

Update .gitignore for gtk-doc

Use shave to reduce compiling output

Which let's us focus on the important warnings.