annotationparser: correct "maximium" in error messages

"Maximium" is not an English word. Even if corrected to "maximum" (which
is), "at maximum" is not conventional usage: "at most" is more
idiomatic.

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

annotationparser: remove duplication of annotation names

Previously, the validation code compared each option name to a constant
(such as OPT_ALLOW_NONE) which expands to the string used in a source
file, and if they matched it would typically pass that same string to
_validate_option(). But the annotation name was written out longhand
each time, which seemed strange to me.

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

giscanner: Don't run pkg-config when there's no packages specified

This prevents a simple error from pkg-config, "Must specify package names
on command line"

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

Avoid _get_func() consuming reference from input info

Fix of leak in 4c9424e18d71237f438a99bc5f2d45ae7de60b78 was a bit
overaggressive, stealing also one reference from input 'info'
argument.

Also fixes another bug in that commit - local 'func' shadowing the
return value, causing that function always returned NULL even when
some result was actually found.

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

Split parameter and tag storage in annotationparser parse tree

This avoids tags overwriting parameters if they happen to
share the same name. For example, this was triggered by
valid code in libgnome-keyring.

tests/scanner/regress.c and tests/scanner/regress.h test
written by Colin Walters <walters@verbum.org>.

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

Don't extract annotations from headers

The headers are already parsed as they are passed
in to g-ir-scanner. This avoids quite a few warnings triggered
with the new annotation parser.

Update annotations from git.

This removes also all the headers as it's the first run
with the updated extraction tool.

Do the filename filtering in scannerlexer

This avoids a bit of python work and reduces the
amount of allocations.

Don't parse doc comments in dependencies

Only parse doc comments for the files we pass in
on the command line to g-ir-scanner, not the included dependencies.

Replace ''' with """, to avoid confusing syntax highlightning in emacs

Fix malformed GTK-Doc comment blocks:

- add missing colons
- invalid annotations
- invalid parameters and tags
- correct parameter name
- preserve description indentation
- no description parts
- comment end marker
- invalid empty lines
- line numbers

AnnotationParser now emits warnings which are considered as
errors by "make check" so fix those warnings...

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

Now make AnnotationParser do what gobject-introspection needs it to do.

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

Update GLib annotations, using the improved annotation parser.

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

update-glib-annotations.py: reduce code duplication

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

Make AnnotationParser._parse_comment() do what gtk-doc does.

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

Don't munch /* and */ comment start and end markers.

In Sandro Sigala's original c-c++-grammars code, this function
was known as "static void skip_comment(void)". It was built this
way instead of a lex pattern because it didn't need to save the
matched comment in the "yytext" buffer. This is still true as
we directly assign the matched comment to the scanner object.
So simply prepend and append the markers back where they belong.

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

Add comment documenting we're ignoring C++ style comments.

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

Update glib annotations from git

Add tests for vfuncs with callbacks as arguments

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

Signed-off-by: Martin Pitt <martinpitt@gnome.org>

Make g_callable_info_invoke public

So it can be used for invoking callbacks

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

Signed-off-by: Martin Pitt <martinpitt@gnome.org>

Add regression tests for GHashTable holding GValue

Add a couple of functions which can be used to test
marshalling/demarshalling of GHashTables having GValue as keys.

This is related to a python-gobject bug:
https://bugzilla.gnome.org/show_bug.cgi?id=668903

Signed-off-by: Martin Pitt <martinpitt@gnome.org>

Release 1.32.0

Release 1.31.22

Update glib annotations to 2.31.22

configure: Comment why doctool is disabled by default for now

g-ir-doc-tool: Fix -o option, use abspath instead of dirname

scanner: Remove array fields from List.clone()

These were apparently copied by mistake.

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

repository: Remove extraneous leftover assignment to rvalue.

Signed-off-by: Michel Dänzer <michel@daenzer.net>
https://bugzilla.gnome.org/show_bug.cgi?id=668902

Fix matching of methods named *_get_type()

The code which heuristically turned functions into class methods would always
ignore any function called *_get_type or *_get_gtype. However, the code which
looked for GI metadata functions to execute them was much more comprehensive,
checking not just the name, but also that it had no parameters and that it
returned a GType.

This change abstracts the more comprehensive check into the Function class, and
uses the same check in both places.

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

repository: Add new public gi_type_info_extract_ffi_return_value() API

Dealing with FFI and return values is very tricky; this API allows
sharing the bits to do it between gobject-introspection and gjs (and
potentially other FFI binding consumers).

**NOTE** I swapped the order of the arguments, under the premise that
out arguments should generally be last.

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

repository: Fix conversion of FFI values on big-endian architectures

Adapted from the fixes for (see bug 665152). It makes sure values are
properly converted between glib and FFI, which is critical for big
endian architectures.

Patch adjusted to use GIArgument instead of custom union types
by Colin Walters <walters@verbum.org>

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

Release 2.31.20

Update glib annotations to 2.31.20

introspection.m4: Set enable_introspection to yes/no consistently

Some people want the ability to use it inside their configure scripts.

http://git.gnome.org/browse/totem/commit/?id=e57d75f555eaad98ec3eee31cf94336ba885174c

g-ir-doc-tool: Add missing files

tests: Fix make dist

g-ir-doc-tool: Remove class structs from Python docs

g-ir-doc-tool: Add support for virtual functions

g-ir-doc-tool: Add a method in the tests

g-ir-doc-tool: Update .gitignore

g-ir-doc-tool: Remove constructors from python docs

g-ir-doc-tool: Add class to its own hierarchy tree

g-ir-doc-tool: Add tests for signals

g-ir-doc-tool: Add the first argument of signals to the Python docs

g-ir-doc-tool: Create a GIR file specific for testing doc generation

This will also serve as a reference of the syntax that is currently
supported by g-ir-doc-tool.

build: Add --enable-doctool option

g-ir-doc-tool: Update expected tests

Update annotations for GLib 2.31.18

g-ir-doc-tool: Add enum templates to the Makefile

g-ir-doc-tool: Add missing file: giscanner/mallard-C-enum.tmpl

g-ir-doc-tool: Change the -o option to receive a directory

Merge branch 'mallard-templates'

g-ir-doc-tool: Update expected tests, some whitespace has been removed

Mention g-ir-doc-tool in the README

g-ir-doc-tool: Add some more stuff to Enum pages

g-ir-doc-tool: Display the hierarchy tree for classes

g-ir-doc-tool: Install the Mako template files

g-ir-doc-tool: Add AM_CHECK_PYMOD macro and use it to check for Mako

g-ir-doc-tool: Remove stale DocBook files

g-ir-doc-tool: Properly link to property pages

g-ir-doc-tool: Fix names of xref links

g-ir-doc-tool: Move constructor example to follow the class doc body

g-ir-doc-tool: Properly link to signal pages

g-ir-doc-tool: Fix the id of signal pages for Python

g-ir-doc-tool: Qualify the class name in the constructor with the module name

g-ir-doc-tool: Add links to properties in the constructor

g-ir-doc-tool: Fix link

g-ir-doc-tool: Show how to construct instances in the Class page

g-ir-doc-tool: Add details for properties in Python

g-ir-doc-tool: Add param information to signal pages in Python

g-ir-doc-tool: Implement intra-namespace cross references

g-ir-doc-tool: Use instances of MallardFormatter* instead of class methods

g-ir-doc-tool: Remove some occurrences of empty Returns: lines

g-ir-doc-tool: use True and False instead of %TRUE and %FALSE

g-ir-doc-tool: Remove module and class from the function signature

g-ir-doctool: Use template caching

g-ir-doc-tool: Use None instead of %NULL

g-ir-doc-tool: Use the ctype for the return type in signatures

g-ir-doc-tool: Display Returns: even if there's no args

g-ir-doc-tool: Update expected, some whitespace was removed

g-ir-doc-tool: Add Since: tag to classes

g-ir-doc-tool: Add Since: tag to mallard docs

g-ir-doctool: Add function argument docs to the C template

g-ir-doctool: Add argument docs to the Python template

repository: Ensure error is set if we're parsing a malformed file

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

g-ir-doctool: Don't instantiate MallardFormatter for unknown languages

g-ir-doc-tool: Update expected mallard for the doc tests

g-ir-doc-tool: Consolidating the function templates

g-ir-doc-tool: Added MallardFormatter class

g-ir-doc-tool: More Mallard work, using experimantal api extension

g-ir-doc-tool: Templates for signals/properties, class docs

g-ir-doctool: Move to Mako templates for generating Mallard

Also removes the docbook writer

Add test for a GPtrArray return with transfer full

This complements the already existing
regress_test_garray_container_return() test.

Update glib annotations

Updated to glib 2.31.16-56-gd240b88, which includes one change
to GKeyFile.

Add tests for GType of GValue

Some language bindings (like gjs) attempt to automatically infer the
GType from a native object when creating a GValue. This checks that
indeed the GValue has the right GType.

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

giscanner: Add better errors for unknown param names

Exclude the names we've already matched up from the "should be one of..." list

girffi: Virtual functions are methods

scanner: Allow adding annotations to vfuncs directly

Some vfuncs may not have public invokers. In these cases, annotations
may still be needed to correctly implement or chain up to a virtual
method from a subclass's implementation.

typelib: Fix invalid alignment assumptions

The current source has invalid assumptions about structure alignment
that break on platforms like m68k where 32-bit integers are aligned to
16-bit only. Fix this by introducing explicit structure padding for
32-bit quantities following odd numbers of 16-bit quantities and
structure trail padding, to make the binary representation generated
by the compiler match the text of the specification exactly.

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

tests/scanner: Update Regress-1.0-expected.gir