scanner: Add c_type for callbacks

We weren't doing this consistently, which broke nsname != cprefix
cases.

https://bugzilla.gnome.org/show_bug.cgi?id=629683

tests: Don't build regress if we don't HAVE_CAIRO

https://bugzilla.gnome.org/show_bug.cgi?id=629359

typelib compiler: Passthrough <doc> at any point

This should have been in the previous commit.

scanner: Parse annotations for typedefs

* Explicitly check for ast.Alias in annotation pass
* Add "generic" attribs handling for aliases like docs, introspectable=0
  etc.

https://bugzilla.gnome.org/show_bug.cgi?id=629668

scanner: Handle G_TYPE_HASH_TABLE

Our Type creation from GType names didn't know how to handle
the GObject boxeds for GHashTable, GArray etc.

scanner: Consistently use ctype for documentation blocks

The "c_name" is really a fallback; use "ctype" if available which
matches the C structure name.

This fixes scanning at least TelepathyGLib where the namespace is
different from the C prefix "Tp".

scanner: Add a test for G_TYPE_ARRAY and (element-type uint)

Similar to TelepathyGlib.

scanner: Add GType for GVariant

This needs a manual override since GVariant is a fundamental.

scanner: Bomb out more obviously if a namespace contains class name = namespace

If you pass --namespace=FooBar, and have a GObject named FooBar, we'd
assert.  Give the user an obvious error message.

Annotate g_variant_builder_end

Add a few notes to HACKING

[test] Fix a leftover rename

The gir name got renamed, update the rules to reflect that

[test] Add typelib/girs to CLEANFILES

So they are removed during uninstall

[test] Use INTROSPECTION_SCANNER

Since it sets the PYTHONPATH properly

Do not use install-data-local

Instead use xxxdir + xxx_DATA which uninstalls correctly

Do not require .git to be present

If .git is not present, do not require the pre-commit
hook to be present either

[tests] Add  to EXTRA_DIST

[tests] Remove left over variable

So make dist passes again

Add annotation for g_variant_get_string

scanner: Readd support for --strip-prefix

We still really do want people to port to --identifier-prefix
(and --symbol-prefix if necessary) because there's no ambiguity.
Before the way we were casefolding was just a terrible mess.

scanner: Allow gstreamer's GParamSpecMiniObject through

It's wrong, but they can't change it now, so work around it here.

https://bugzilla.gnome.org/show_bug.cgi?id=550616

https://bugzilla.gnome.org/show_bug.cgi?id=629306

build: Also use $DESTDIR for regress.[ch]

build: Use $DESTDIR in install-data-local

gio-2.0.c: Add more annotations for GVolume and GVolumeMonitor

Add annotations fixing warnings in in GVolume and GVolumeMonitor

build: Update EXTRA_DIST, fix random stray + in Makefile

gio: annotate g_volume_get_drive

scanner: Skip functions with leading '_'

Multiple modules have '_' prefixed symbols in "public" headers
meaning "don't use this in your app".

scanner: Mark '_'-prefixed fields as introspectable=0

Typically these contain reserved callbacks; in any case we take
a leading underscore to mean 'private'.

Foreign structs can have constructors

gio: Annotate a few more functions

Use Node.ctype instead of Node.c_name when looking up comment blocks

We were missing some annotation blocks for structs in typelibs with
a name different to the C prefix.

gio: Annotate g_mount_get_drive

scanner: Unify parsing of compounds

Avoids duplicate code.

scanner: Fix style for previous commit

gio: annotate g_mount_get_volume

Print helpful error message if --strip-prefix option is used.

scanner: Kill glibast

It was a stupid abstraction split, we only support GObject.

* Clean up how we handle c:type - we only set it if we've actually
  seen a corresponding structure.
* Add a warning if we don't see the structure typedef for an
  interface, since that's pretty bogus.  (And fix regress.h to have
  one)
* Rename the "type_name" attribute internally to "gtype_name"
  for clarity.

scanner: Don't mark as constructors things that are more obviously methods

If the first parameter matches the origin, don't scan as a constructor.
Happened in practice with meta_screen_append_new_workspace from mutter.

scanner: Fix object hierarchy traversal in constructor scanning

We weren't properly hitting GObject.

scanner: Don't attempt to pair methods/constructors with foreign namespaces

See test case, hit in practice in gnome-shell.

Add missing annotations

Add some more (transfer full) annotations left out in commit cd0de25.

Handle casing better for constants

Instead of handling constants by lower-casing them, stripping the
lower-case prefix and upper-casing them again, leave them in the
original case and check against upper-cased versions of
namespace.symbol_prefixes.

Wwe detect what version to test against by looking at the first character
of the identifier, so we assume that --symbol-prefix options are always
in lowercase. If that needs to be relaxed, then we'll have to check all
symbols against both sets of prefixes.

Add tests for constants to Regress.h and fix tests/warn/unresolved-type.h
for a warning message that improved with this change.

https://bugzilla.gnome.org/show_bug.cgi?id=629007

Add missing annotations to GLib and Gio

Add (transfer full) and (array zero-terminated=1) to various GLib
and Gio functions.

scanner: Automatically skip callables which contain a skipped node

For legacy library author convenience, propagate (skip) on e.g.
structures to all callables which use them.

[girepository] Add a missing include

tests: Update expected gir for previous commits

Go back to previously handling of static methods on non-GObjects

Previous to the scanner rewrite, static methods were only handled
for GObject subclasses. Go back to that for full compatibility
with existing bindings and code. See bug 572408 for the topic
of changing the API.

The code for writing out static methods for records and boxed is
left as future proofing, and the same handling is added for
interfaces.

https://bugzilla.gnome.org/show_bug.cgi?id=628967

trick scanner into marking a symbol as a function instead of a method

scanner: Fall back to searching all includes when uncertain

The scanner by default tries hard to ensure that we know immediately
from seeing an identifier "FooBarBaz" that the namespace is "Foo".
But libraries using --accept-unprefixed here screws this over.
Potentially we could add --unstripped-identifier-prefix, but it's
ugly.  The best long term fix is to fix the namespacing in the library.

Revert "[scanner] Revert static method pairing"

This reverts commit 144cb10d51888a9565721088d2b61794468742e9.

[girepository] Support strict align platforms

Such as Sparc64.

https://bugzilla.gnome.org/show_bug.cgi?id=620769

[scanner] Make fatal warnings exit

Even if warnings are not enabled

[scanner] Fundamental problems are not fatal

scanner: Add various static debug hooks in GI_SCANNER_DEBUG

For backwards compat, keep the presence of the environment
variable at all to mean "exception".

Also start a HACKING file.

[scanner] Make it compatible with Python 2.5 again

with statement is available in python 2.5, but only
if you import it from __future__

Enhancement #612253 - add configure --with-glib-src=PATH

This enables glib documentation to be added to the generated gir using the original source
eg. --with-glib-src=/usr/src/glib

Revert "Fix non-source-dir build failure"

This reverts commit 26c66df6bdc3e3ce836c7462958fa38cc3e1062f.

[scanner] Revert static method pairing

Static method pairing changes the API and should be futher
discussed in https://bugzilla.gnome.org/show_bug.cgi?id=572408

[scanner] Clarify exception message

Fix non-source-dir build failure

Make sure all giscanner python files are available in builddir, so the module
is invokable during build time.

https://bugzilla.gnome.org/show_bug.cgi?id=571591

Signed-off-by: Theppitak Karoonboonyanan <thep@linux.thai.net>

[pep8] Skip emacs backup files

[scanner] Remove a bunch of unused functions

Bug 628594 — Handle slashes when building _gir_name

Convert slashes to underscores in _gir_name so that non-recursive builds can
use Makefile.introspection. Closes: bgo#628594

Remove extra lines from the license comment

[VFuncBlob] Unknown struct offset should be 0xFFFF

Documentation says about g_vfunc_get_offset():

 "Obtain the offset of the function pointer in the class struct.
  The value 0xFFFF indicates that the struct offset is unknown."

But g-ir-compiler did set the value to 0 when the offset is unknown.
This patch fixes it.

https://bugzilla.gnome.org/show_bug.cgi?id=628270

[tests] Link libfoo against girepository

To avoid undefined references to gi_cclosure_marshal_generic

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=625995

Update CONTRIBUTORS

[girepository] Document GIStructInfo & GIUnionInfo

https://bugzilla.gnome.org/show_bug.cgi?id=628753

scanner: Add backwards compatibility with some annotation types

These were listed on the wiki up until just now...

scanner: Don't clear out ctype on annotation strings if we fail to resolve

We don't have an "annotation source" for Type right now; so as a quick
hack, stuff it in the ctype but only if we fail to resolve.

scanner: Fix previous rename-to handling commit

scanner: Fix rename-to handling

We were writing the attributes backwards.  Also actually use
the attribute in the typelib generation.

scanner: Fix misuse of message.warn_symbol

The "symbol" is actually just a string identifier, not
a real symbol.  We already added the file positions when
parsing earlier.

scanner: Readd --warn-error to tests, fix test case

Commit b6fb70f9 wrongly disabled fatal warnings - in fact there
is a way to make this test case work, and it was a bug in the
scanner not processing virtual function annotations correctly.

Add a different test case for un-named parameters that doesn't
have a callback.

Remove old everything.[ch]

scanner: Actually exit with code 1 on fatal warnings again

Fix typo (reported by philn-tp)

[scanner] Move a function from transformer to ast

It doesn't use any internal state, so it can easily
be moved over to the type as a factory function

[test] Add warning tests for enums

[tests] Handle multiple errors per file better

girepository: Call init_globals()

This fixes the search path initialization if g_irepository_require
is called first thing.

[scannermain] Use mkstemp

Since the delete parameter of NamedTemporaryFile is only
available on python 2.6

[giscanner] Make pyflakes happy

[tests] Add callback scope tests

And fix a bug in the warning call in the scanner

[tests] Rework tester to be executed once per test

Instead of running all tests in the same instance

[tests] Add test infrastructure for warnings

Add an infrastructure for testing warnings, add two
examples how to verify warnings

[scanner] Improve an error message, include lineno

[message] exit after calling message.fatal()

scanner: Associate constructors with correct class

scanner: Add --include-uninstalled

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.

[scannermain] Create a new option parser

Create a new option parser when parsing pkg-config output

[message] Add an output parameter

[scanner] Remove old logging functions

And migrate over to using the message logger

[scanner] Move over remaining callsites to message

Move the remaining callsites over to the new message
module

[scanner] Simplify strip_identifer/strip_symbol

The strip_* functions are problematic since they
have a fatal switch which determines if the message should
kill the scanner. Change the api to make it easier to extend
with other logging categories and move over the callsites to
use the new message module

[scanner] add a message module

This module will be used to report warnings, which
doesn't explicitly depend on the transformer instance.

scanner: Don't throw an exception on unresolved types

Instead we'll warn in the introspectablepass.

[scanner] Allow nameless parameters for vfuncs

Add a test case and disable fatal warnings since there's
currently no way to avoid the warning(s)

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=628567

[scanner] Move namespace out of Transformer

[transformer] Don't pass around source scanner

Pass around its symbols instead