scanner: Remove some dead debugging code

Fix warning for missing (element-type)

While looking for a different bug, I noticed that the introspectable
pass lists was missing GSList.  And the warning was never set up
to fire anyways.  Fix it and add a test.

Add make-check-passed to gitignore

Use INTROSPECTION_SCANNER_ENV in Makefile.introspection

Add a make-check check to pre-commit hook

Avoid most of the special-casing of GObject.Object in the scanner

There were some cases of handling GObject and GInitiallyUnowned which
were not necessary.  Removing special cases from them simplified code
and as a bonus it added 'GObject::notify' signal into GIR, which was
not there previously.

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

add regression test for skipped #define

Add a regress test for a method returning GPtrArray

Revert "xlib: fix the type of XID"

This reverts commit 3553cd0a4631f1b57fb608e3f3f78a1a0cfd602a.

Turns out it was wrong, XID is 64 bit on a 64 bit system. Plus
the scanner doesn't like multiple level typedefs.

xlib: fix the type of XID

XIDs are CARD32, which corresponds to guint32 on all platform, not
gulong (which is 64 bit on x86_64). Fix that, and use alias indirection
to more accurately reflect the typedefs.

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

configure.ac: Do not generate template files

It's not needed as the project uses inline comments
for documentation.

configure.ac: Generate xz tarball with ustar format by default

Update autotools configuration

Replace deprecated autoconf macros
Use new libtool syntax

autogen.sh: Use autoreconf instead custom script

Fix g_irepository_find_by_gtype() for GDK_TYPE_RECTANGLE

Complement fix for g-ir-scanner which converts every GdkRectangle
gtype to CairoRectangleInt.  Make sure that C-side API is also aware
of this workaround.

Use case requiring this patch:

When binding implementation wants to get/set property, it can use either
GI-based approach (g_property_info_xxx() funcs), or just GLib facilities.
Although former is probably preferred, there are cases when latter is still
needed (e.g. gstreamer uses dynamic properties, which are not present in the
gir).  In this case, binding implementation queries the type of the propertyb
(using g_object_class_find_property()), it gets GDK_TYPE_RECTANGLE,
and without the patch it cannot map it to any known type.

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

Properly handle GParamSpec and descendants

GParamSpec is introspected as fundamental class, and all GObject
classes derived from it (e.g. GParamSpecChar) are marked as such.

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

Update annotations from glib git 2cd3c200687751c9cc26774f650b7651bffcc598

Remove MAINTAINERS and add DOAP

add back the fixed_array_out_struct test

tests: build tests only on make check

Use automake's check_ prefix and avoid putting anything nontrivial in
BUILT_SOURCES so that tests are build only on make check.

The dummy -rpath in AM_LDFLAGS in tests/scanner/Makefile.am is needed to
force libtool to build shared libraries for check_LTLIBRARIESS targets
(automake builds check_LTLIBRARIES as static by default); see
http://lists.gnu.org/archive/html/automake/2005-10/msg00107.html

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

doctool: Disable tests for now

They don't work for multiple reasons, and there is still debate
about how the formatting etc. will work.

docbookdescription.py: Fix for PEP-8 compliance

Update annotations from glib git d51e0615f9a6c1aa1898c46f2cf3135ca5ccd463

Add 'Since:' tags to the newly added GIEnumInfo methods

Regenerate Gio/GLib/GObject annotations

Ran misc/update-glib-annotations.py against current glib master.

Add tests for newly added warnings

g-ir-scanner now warns for invalid (element-type) annotations
in GPtrArray and in GByteArray. Test that.

tests/doctool: Remove MALLARD_DIRS from BUILT_SOURCES

so we don't generate the test docs when doing a plain build

Disallow non byte types for GByteArrays

Similarly to GPtrArrays, GByteArrays can only contain bytes. Emit
a warning if an inconsistent (element-type) is placed, and ensure
that the default is guint8 if nothing is added. This way bindings
can support GByteArrays without special casing them.

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

Forbid GPtrArrays holding non-pointer types

It should be safe for bindings to assume that GPtrArrays hold only
pointers (or values as big as it), so there is no need to go through
hoops for converting smaller integers when marshalling.
Libraries that need arrays of integers should use GArray.

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

Docbookwriter: signal flags

In DocBookWriter, remove DocBookEntity and just use the ast nodes directly.

For docbook, make the id attributes the same regardless of language. Only user visible strings should change between C and Python.

Descriptions support for docbook writer.
Includes support for escaping (but not double escaping) entities and CDATA sections.

Add descriptions from GIR to docbook writer.

Allow enums and bitfields to have static methods

This uses the same backcompat machinery that was introduced for static
methods for non-class types, so this change does not break users of the
existing presentations.

New libgirepository API:

    g_enum_info_get_n_methods
    g_enum_info_get_method

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

Teach scanner's girparser about fundamentals

Make sure that fundamental attribute and associated
functions (ref-func, unref-func, set-value-func and get-value-func)
are parsed, otherwise we fail reparse-validating girs containing
fundamentals.

giscanner: Allow passing additional include dirs when parsing a gir

tests/doctools: Properly clean the temporary mallard files

tests/doctool: Update the -expected dirs

tests/doctool: Make sure we regenerate the mallard code when testing

[doctools] use 'or' instead of 'and' when checking for func or constructor

treat constructors like methods when generating the label

[doctool] use different templates for method vs. function output

configure.ac: Change to tar-ustar because PAX gives problems in OpenBSD

Also, it's what other GNOME modules use

tests/doctool: Better way of copying the .gir

configure.ac: Add tar-pax to AM_INIT_AUTOMAKE

output namespace.class.methodname for python methods in the doctools

tests/doctool: Compare -expected directories instead of single files

fix up Python doc backend to output correct names

tests/doctool: Switch to test the mallard formatter

first pass at python backend for doc tools

tests/doctool: Add the right -expected files to dist

tests/doctool: Update expected files

g-ir-doc-tool: Fix PEP-8 issues

g-ir-doc-tool: print class declaration line in Python

giscanner/mallardwriter: Adding experimental Mallard output to g-ir-doc-tool

g-ir-doc-tool: Use namespace.class for Python

g-ir-doc-tool: Ignore for now properties with no known type

g-ir-doc-tool: Use the array type when rendering [element-type]

g-ir-doc-tool: Add -expected test for Python docbook

g-ir-scanner: Stop going up the hierarchy once we reach GObject

Make sure we have UNINSTALLED_INTROSPECTION_SRCDIR when running tests

Regress-1.0-expected: Update for previous change

annotationparser: Don't eat lines that look like parameters outside param list

If we're done parsing parameters, previously we would simply eat lines that looked like
    @foo: blah blah

Example is in gtkcssprovider.c.

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

Recognize constructors ending in 'newv'

Like gtk_list_store_newv and gtk_tree_store_newv.

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

Merge remote-tracking branch 'origin/gir-docbook'

Conflicts:
.gitignore
tests/scanner/Regress-1.0-expected.gir

Try harder to preserve c:type

When we replace a type using annotation we should keep
the ctype of the original type.

Make sure signal works when there isn't one specified

Make sure signal works when there isn't one specified

g-ir-doc-tool: Add support for varargs

tests/doctool: Updated -expected to match the code in the repo

Add signal flags

This adds all GSignalFlags into the gir.

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

Update gitignore

g-ir-doc-tool: Add alias elements (typedef)

Add signal flags

This adds all GSignalFlags into the gir.

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

annotationparser: Only accept certain tags

Previously we were eating any line form "* [A-Za-z]: " as a tag,
but this is a problem since e.g. gtk/gtk/gtkcssprovder.c had literal
CSS e.g. block: which erroneously matched.

Fix this by only accepting particular tags, similar to what gtk-doc
does (although we accept a superset, e.g. transfer too).

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

Update gitignore

remove the flat struct array test and replace with object pointer array test

Update expected after rebase

Move doctool over to common.mk

Update .gitignore

scanner: add a moved_to property to backcompat functions

Use it to remove backcompat copies of functions that non introspectable
anyway.

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

scanner: handle static methods on all types

Instead of just handling static methods for classes, handle them for:

  - Records and boxed
  - Unions
  - Interfaces

Based on a patch by Owen Taylor.

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

Avoid broken emacs syntax highlightning

scanner: Don't throw away blank lines in the docs

For generating documentation, we actually want to preserve these.

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

Add g_irepository_find_by_error_domain()

Add a method to look up a GIEnumInfo given its associated error quark.

Based on a patch from Colin Walters.

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

Switch to storing string form of error quarks

Instead of storing the name of the function to call to get the
error quark, store the string form of the error quark, which
we derive from the introspection binary during scanning.

Update EnumBlob and GIEnumInfo to include the new information.

This will allow determining a back-mapping from error quark
to error domain without having to dlsym() and call all the
known error quark functions.

Based on earlier patches from Owen Taylor and Maxim Ermilov.

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

Deprecate ErrorDomain

The previous ErrorDomain blob was never actually scanned or used, and
it was kind of a lame API conceptually.

To keep some compatibility, rather than removing the enumeration
values, rename them to _INVALID, and don't bump the typelib version.
This should in theory allow a new libgirepository to read an old
typelib.

Based on a patch from Colin Walters

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

girepository: fix some doc comment syntax

Add Regress method for a closure taking and returning a GVariant

Automatically turn Gdk.Rectangle gtype into cairo.RectangleInt

Gdk.Rectangle is 'boxed alias', which is not currently weel supported
by g-i.  Work around by transforming Gdk.Rectangle gtype into
cairo.RectangleInt.

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

g-ir-doc-tool: Add structs (no fields yet) and thus fix arguments links

g-ir-doc-tool: Use same link ids as gtk-doc-mkdb does

g-ir-doc-tool: Move out the * from the return value link

g-ir-doc-tool: Move the * out the type link

scanner: Don't throw away blank lines in the docs

For generating documentation, we actually want to preserve these.

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

g-ir-doctool: Add annotations (some)

Add g_irepository_find_by_error_domain()

Add a method to look up a GIEnumInfo given its associated error quark.

Based on a patch from Colin Walters.

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

Switch to storing string form of error quarks

Instead of storing the name of the function to call to get the
error quark, store the string form of the error quark, which
we derive from the introspection binary during scanning.

Update EnumBlob and GIEnumInfo to include the new information.

This will allow determining a back-mapping from error quark
to error domain without having to dlsym() and call all the
known error quark functions.

Based on earlier patches from Owen Taylor and Maxim Ermilov.

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

Deprecate ErrorDomain

The previous ErrorDomain blob was never actually scanned or used, and
it was kind of a lame API conceptually.

To keep some compatibility, rather than removing the enumeration
values, rename them to _INVALID, and don't bump the typelib version.
This should in theory allow a new libgirepository to read an old
typelib.

Based on a patch from Colin Walters

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

girepository: fix some doc comment syntax