docs: make gtkdoc-mkdb ignore cmph doxygen comment blocks.

When building g-i reference documentation, girepository/cmph/*
was being scanned for GTK-Doc comment blocks by gtkdoc-mkdb.
Unfortunately, cmph uses doxygen comment blocks which also
start with /**. This patch prevents gtkdoc-mkdb from complaining.

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

GIMarshallingTests: Add GVariant property

giscanner: unbreak g-ir-annotationtool...

... and by extension misc/update-glib-annotations.py.

Commit 5c70ef2eb32949f8889e9ae654d50bfbf838951f broke
these by assuming create_source_scanner() is always
called with 'options' and 'args' built by the
OptionParser() defined in scannermain.py's
_get_option_parser().

This is not the case with g-ir-annotationtool, where
annotationmain.py's annotation_main() creates it's
own OptionParser() accepting a different set of
'options' and 'args' as compared to scannermain.py

Update annotations from glib git

gimarshallingtests: Fix return data type

gi_marshalling_tests_genum_returnv() should (and does) return a
GIMarshallingTestsGEnum, not  a GIMarshallingTestsEnum. The latter is already
covered by gi_marshalling_tests_enum_returnv().

gimarshallingtests: Add some GBytes tests

Will be used by gjs for new byte array work.

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

scanner: Emit correct type for unsigned integer constants

Otherwise bindings will break.

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

Update annotations from glib git

tests: work around make check warning

The tests in tests/repository/ depend on libregress.so
from tests/scanner which cannot be loaded during make check.
Fixing this properly would require migrating to non-recursive
automake for the tests, but for now we can just work around
and set LD_LIBRARY_PATH (for linux) and PATH (for win32).

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

tests/offsets: Remove leftover g_type_init() call

cmph: Remove leftover statement-without-effect

Compiler warning introduced from MSVC patches.

scanner: Correctly handle large 64 bit integer constants

In C, positive integer constants are by default unsigned.  This means
an expression like 0x8000000000000000 will be "unsigned long long".

In the actual scanner code, we were parsing them as "gint64", and
storing them as gint64.  This was incorrect; we need to parse them
as guint64, and store the bits we get from that.  This gives us
an equivalent result to what the C compiler does.

However, when we actually return the value as a Python "long"
(arbitrary length integer), we need to treat the value as unsigned if
the result indicated it was.

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

Expand on the documentation tests

Add tests for complex function signatures (including arrays and
callbacks), for enumerations and for static methods.
Add JS reference files.

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

MallardWriter: support cross-references across namespaces

Look in included namespaces when resolving a cross-reference.

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

Add documentation for enumeration members

Enum members were Annotated in the AST, and most code already assumed
they could have docs. What was missing was reading the docs from the
comment blocks and writing them in the XML.

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

Ast: Add parent to Fields

Properties have it, there is no reason for Field not to, and in this
way mallard docs can treat a field almost like a property.

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

Namespace: fix appending of nodes

Traverse appended nodes for methods, so that namespace.symbols contains
all known symbols and not just global functions.
Also, ensure that all relevant nodes are appended when parsing GIRs.

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

regress: Add a test case for skipping a function with an unannotated callback

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

gimarshallingtests: Attempt to avoid using reserved words

"int8" apparently blows up on AIX.  It was kind of lame how we would
just ad-hoc append a _.  Since we only have one value for a lot of
these, let's just go with the couldn't-be-any-simpler "v".

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

gmarshallingtests: Fix prototype () -> (void)

Dear Python programmers, () doesn't mean what you think it means in C.

girepository: Use girepository.symbols for Unix builds too

Rather than having a regex for both builds, but *also* use a symbol
file for the MSVC build which would bitrot quickly, force us to update
the .symbols file by using it for Unix too.

Add some missing symbols.

g-ir-scanner.1: English fix

Add a Windows .bat to generate typelibs

This will enable one to generate the .gir and .typelib files for GLib,
GModule, GObject, GIO and G-I without using a bash-style shell on Windows.

This is also the .bat that is used during the Visual C++ build process to
generate the .gir and .typelib files

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

giscanner/dumper.py: Support Visual C++

-Pass the --msvc-syntax flag to pkg-config when Visual C++ is used.
-Use .obj instead of .o filename extension when running on Visual C++, as
 that is the default object file name extension on visual C++.
-Specify compiler output flags for Visual C++.
-Avoid using -Wl and -rpath on Visual C++, and link to .lib files instead
 when generating a .gir file within the package.
-Avoid unecessary linking under Visual C++ to the .dll files since we
 already linked to the corresponding .lib files.

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

Update autotools for Visual C++ projects creation

-Add Makefile-msvcproj.am to fill in the cmph, girepository and
 g-ir-compiler projects
-Add various Makefile.am's under build/ to distribute the
 Visual C++-related files.

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

Add Visual Studio 2008/2010 Solution files

These are the master solution files that will load the Visual C++ projects
for building/generating gobject-introspection and its related tools and
files.

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

Add Visual Studio projects

These are the Visual C++ 2008/2010 project files that can be used to build
gobject-introspection.  The main girepository dll (along with cmph), tools
(in C), certain test/sample programs dlls are built with this project file
set.

Due to a bug in the Visual C++ 2008 linker, the g-ir-compiler and
g-ir-generator tools have the libgirepository-internals sources built
along side with the sources of these respective tool programs.

In order to ease future maintenance, the cmph, girepository,
g-ir-compiler and property sheets (for the "install" part) are done as
templates where header/source listings are filled in during "make dist",
so that the headers/sources listings are kept up to date between releases.

The GLib and girepository .gir and .typelib files are also generated and
"compiled" as part of the build process, using gengir.bat that
was committed earlier.

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

Add README.txt files for Visual C++ builds

Add instructions to tell people how to build gobject-introspection with
Visual C++, especially as there are special steps and additional
requirements for a successful build.

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

Add a test_gir_cmd.txt file

This is to show how one may be able to generate the .gir files from the
various DLL files in tests\ in a standard Windows cmd.exe prompt, which
will also attempt to demonstrate how .gir files are generated without a
shell.

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

sourcescannermain.py: Add --filelist option

Add a function to put the files to pass to g-ir-scanner in a filelist
file, with one source/header file on a single line.  This is done to
work around the limitation of Windows cmd.exe (and MSYS) where the command
line cannot exceed 8192 characters.

When this option is used, g-ir-scanner will only look for the header/source
files that are specified in the filelist file, which is not too hard to
generate.

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

giscanner/sourcescanner.py: Update for Visual C++ usage

Since the Visual C++ (cl.exe) preprocessor does not accept source input
from stdin (the '-' preprocessor flag, we need to use the GCC preprocessor
as a helper here.

Note that the generated dumper program is still compiled and run by
Visual C++.

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

Add .def files for building the various DLLs (.la's) in test\

This will enable the exports of functions to create the .lib files needed
to create the .gir files.

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

Add girepository.symbols

This is the listing of symbols to export from the main libgirepository
.dll/.so.  This is used for example to generate the .lib file from the
Windows DLL.

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

Add a pre-configured config.h.(win32.in)

This adds a pre-defined config.h for Windows builds, but versioning info
are updated by autotools.

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

giscannermodule.c: Updates for Windows

-Incorporate and extend Dieter's patch regarding possible different CRTs
 used in Windows Python (msvcrt71.dll for Python 2.5, msvcrt90.dll for
 Python 2.6- 3.2, and msvcrt100.dll for Python 3.3+) vs. the CRT used to
 build g-i (msvcrt.dll for MinGW/WinDDK, msvcrt90.dll for stock MSVC 2008
 and msvcrt100.dll for stock MSVC 2010)
-Avoid C99ism for NEW_CLASS as we are having an array without a
 pre-determined length.  There might be better ways to get around this
 though.

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

giscanner/dumper.py: Use os.name instead of os.uname()[0]

os.uname is not available universally, so use something that exists
universally.

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

girepository: Remove C99ism and other updates

-Make code using libgirepository_internals relocatable on Windows,
 like what is done in the GTK+ stack, and the girepository DLL.
-Remove C99isms
-"interface" is a reserved keyword on certain compilers, so change that to
 "giinterface"

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

giscanner/scannerparser.y: Avoid C99ism

Move variable declarations to the start of block.

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

girffi.c: Don't include unistd.h unconditionally

It does not exist on all platforms

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

cmph: Remove C99ism and other fixes

...So that it will compile on non-C99 compilers.  The changes are mainly
moving the variable declarations to the start of the resecptive blocks.

Also, replace the use of buflen in chd.c as it might not be defined for all
platforms, instead using packed_cr_size as it seems to represent the value
that is to be printed/displayed by the debugging output.

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

docs: Show correct path used by g-ir-scanner

Signed-off-by: Colin Walters <walters@verbum.org>
https://bugzilla.gnome.org/show_bug.cgi?id=668193

scanner: Ignore #defines starting with _

This matches our behavior for symbols (and we should probably fix this
more globally...I think we still scan _-prefixed enums).

Noticed from gudev which had #define _GUDEV_INSIDE_H 1

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

Python3-friendly python.m4

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

common: Ensure we use $(CC) from environment when compiling scanned binaries

GNU make will default to "gcc" if "cc" isn't found; we need to
replicate that behavior here.

Patch-suggested-by: ojab <ojab@ojab.ru>
https://bugzilla.gnome.org/show_bug.cgi?id=678678

Update annotations from glib git

Update annotations from glib git

giscanner: Don't prefer identifier prefixes over namespaces in deps

Use namespaces in dependencies before falling back to the deprecated
--identifier-prefix prefixes.

scanner: Deprecate using identifier prefixes in GINames

Instead of crashing.  For more details, see the attached bug.

Based on a patch by Stef Walter <stefw@gnome.org>.

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

Update annotations from glib git

Drop calls to g_type_init()

And bump our GLib requirement.

[gobject-introspection] Add test method for GDestroy with no user data

Added regress_test_callback_destroy_notify_no_user_data.
Updated Regress-1.0-expected.gir

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

gimarshallingtests: Add array/GList uint32/64 in/out API

Add in/out API for testing arrays containing uint64, as well as GList
containing uint32 (GList and GHash can't contain 64 bit values as they store
them in pointers).

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

Make gtk-doc not a hard dependency of gobject-introspection

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

Release 1.34.0

Update annotations to glib 2.34.0

configure: Post-release version bump

Release 1.33.14

Update annotations from glib git

regress: Add API to test signals with (u)int64 params

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

Co-Authored-By: Martin Pitt <martinpitt@gnome.org>

Update annotations from glib git

gimarshallingtests: Add in/out int64 GValue method arguments

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

GLib-2.0.gir: Add glib-unix.h

So we pick up g_unix_signal_add() for example.

Update annotations from glib git

ginvoke: support conversion of fundamental type GParamSpec values

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

Update tests to show off some new features

These includes more proper links and fundamentals.

mallardwriter: Fix fundamental false alarms for the C formatter

Just use a constant translation dictionary. If somebody needs something
more fancy they can use a custom match.

mallardwriter: Fix formatting the function name

This is not what format_type is for.

girparser: Track methods/constructors by symbol

In order to be able to linkify a constructor/method, we need
to first track it by symbol.

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

ast: Remove what looks to be a copy/paste error

A symbol isn't a ctype. None of the tests failed when I removed
this, git blame wasn't very enlightening, and we don't remove this
in the remove method, so I'm thinking it's an error.

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

.gitignore: Add doctool examples output

tests: Don't error out if there is no existing directory

mallardwriter: Remove some silly code

This silly code was part of a debugging harness.

mallardwriter: Fix whitespace

The whitespace should come included with the surrounding 'other'
tokens. We shouldn't need to add any.

mallardwriter: Fix property and signal output

giscanner: Fix make check issues

Whoops.

mallardwriter: Hack a lot more on document block processing

Use a new regex scanner to parse the contents of document blocks
and emit the proper XML document for it.

mallardwriter: Remove a silly try/except

This isn't necessary as far as I can tell

mallardwriter: Use a more generic system for language formatting

mallardwriter: Remove some unused stuff

docmain: Fix error message

girepository: Fix leak in g_vfunc_info_get_address

We need to fix the struct info here.

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

girepository: Add g_interface_info_find_signal

Add the convenience method g_interface_info_find_signal, mirroring
g_object_info_find_signal.

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

scanner: methods cannot have an out-arg as their first arg

This ensures that if the first argument of a function like

  gboolean gdk_rgba_parse (GdkRGBA *rgba, const gchar *spec);

is annotated as being an out-arg, the result is a class function with two
arguments, not a method with one argument.  Previously, the (out) annotation
was simply ignored.

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

Post-release version bump

gimarshallingtests: Add GParamSpec return and (out) argument

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

Co-Authored-By: Martin Pitt <martinpitt@gnome.org>

girffi: Fix g_callable_info_prepare_closure for certain callables

Namely, those that are methods and those that throw GErrors.
We have very similar code in two places that calculate arg lengths and
argument types to stick into libffi. Merge, clean up, and correct both.

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

gicallableinfo: Add two new convenience methods: is_method and can_throw_gerror

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

Release 1.33.9

Update annotations from glib git

Makefile.introspection: Add gir dependency to example

build: Ensure cairo-gobject always ends up in cairo.gir

We were conditionalizing on the presence of cairo in the buildroot,
but that's super lame since it makes a huge mess of the build
dependency graph.

Let's just always stick cairo-gobject in there.  I doubt anyone cares
anymore about building g-i on really old systems without it.

If they do...well, we can revisit this again.

Revert "Implement "rename to" annotation for records"

This reverts commit 764366f7e4ef5a765a24ffac8c60b811f38b9ad9.

It can't work right now because to really use the structures, you need
to register them as a boxed, and that means we also need to rename the
boxed type.

A future version of this patch will need to handle both the structure
name and the GType name.

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

tests: Fix coding style and compiler warning in regress

Previous commit used old-style declarations which was broken.

Test typedef in #define

requires "handle unsigned properly for type of defined size" patch.

scanner: handle unsigned properly for type of defined size

giscanner: special case G_GINT64_CONSTANT and G_GUINT64_CONSTANT + misc

This let the macro expands to its value as gint64/guint64.

Also
- fix lexer identifier/typdef detection for macro and misc

- do not discard cast

gimarshallingtests: More useful assertions

Convert the simple g_assert() statements into g_assert_cmp*, to show what the
actual value is in case of a failure. This makes it easier to port
g-i/pygobject/etc. to new architectures which exhibit bugs, like powerpc64.

Regress: Update expected gir for previous changes

gimarshallingtests: Squash compiler warning

tests: Fix comment about expected result