[scanner] Support private/public directives

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

[scanner] Add a Position class

Add a position class which will make it easier to
send filename/line/column information to the message
class.

[scanner] Only store types in cache store

Only store types that can be referenced in the cache store
this reduces the size of the serialized Gtk-3.0.gir in the store
from 5.7M to 366k on my system.

It also reduces the time it takes to create a gir in gtksourceview
by 35% and the time to run the warnings test by more than 50%

This also disables the cache for passthrough mode since it needs
access to the whole serialized tree.

Remove leftover, type is set above

[maintransformer] Make warning more robust

Instead of assuming that a parent node is always passed in,
make sure to handle that case.

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

[message] Set file_positions to an empty list

So we can always pass it into len() without breaking

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

Include proper line number for scope warning

[sourcescanner] Rewrite linemarks parser

Rewrite the pre-processor linemark parser so we end
up with accurate filenames and linenumbers.

Include proper filename and lineno in doc warning

[annotationparser] Preserve line numbers

Make sure that the linenumbers of the documentation blocks
and tags are preserved and accurate so they can be used in
warning messages. Also:
* Rename Options to DocOptions for consistency
* Add a reference to the docblock a tag and an option belong to

Save the line number of a source comment

[maintransformer] Do not warn for returns and varargs

Add a few more special case parameters which we will
not warn if they don't exist as a parameter

Set c_symbol_prefix in the GVariant special case

Make Full the default transfer for returned foreign structs.

For that we also need to read the annotations for foreign structs
before guessing the transfer mode of return values.

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

Update AUTHORS

Update CONTRIBUTORS

build: post-release version bump

Release 0.9.6

[maintransformer] Do not warn for vararg docs

Allow varargs "..." to be documented without warning

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

Add a warning for unresolved types

Warn when using an annotation which will end up as
unresolved.

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

gio-2.0.c: Add missing annotations

Add 'transfer mode' annotations for GAction, GActionGroup, GAppInfo,
GApplication and GAsyncInitable

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

scanner: Add temporary workaround for GStreamer

Also document/bug link the other workarounds; just made up a
convention for ## WORKAROUND ##

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

NEWS->git shortlog

Update annotations for GIRepository.Repository.

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

Box GIBaseInfo structure.

This puts it into typelibs and allows to use it safely from scripts.

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

Add a parameter mismatch warning

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

[gio] Fix a broken doc string

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

[warningtester] Do not sort expected warnings

Instead just take them in the order they are in the file

[warningtester] Invert expected/actual

It makes it a little less confusing reading the error messages

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