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

g-ir-doc-tool: Generate parameter list in the detail

tests/doctool: use GIRepository gir instead of Regress

Add Regress method for a closure taking and returning a GVariant

g-ir-doc-tool: Add DOCTYPE

tests/doctool: Sync -expected.xml

[docbook] Print out element types of arrays, lists and hashtables.

tests/doctool: Add an echo while building the docbook

g-ir-doc-tool: Generate a <refentry> element at the top of chapters

g-ir-doctool: Fix a PEP-8 issue

Add a way to check for unintended effects of changes in g-ir-doctool

[doctool] Add local object hierarchy and stubs for props and signal details.

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

[docbook] Allow formatter to change page name.

[docbook] use C symbol for function title.

[docbook] add signals section

Use a classmethod and s/Transformer/cls/ + s/transformer/self/

[docbook] Add properties section.

[docbook] Entity -> method

[docbook] Add Properties section

[docbook] Add "Details" title above all methods.

[docbook] only show Class Record and Interface at the top level

[docbook] Make DocBookWriter use Transformer

[docbook] remove namespace page. There is nothing in it.

g-ir-doctool: Don't render the * in link targets

[docbook] fix exception when there is no ctype.

WIP doctool

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

Make the Transformer respect 'skip' annotations

 * In order to suppress unnecessary warnings on macros which are skipped
   at later passes of the scanning, we use the annotations to skip
   AST stuff being created for symbols that are skipped.

Fix symbols being reported in invalid files

 * Due to the way that flex/bison works, the symbols were being added
   to the scanner after additional lines are parsed.
 * If these lines are #line directives, then scanner->current_filename
   can change between when the symbol is parsed and when it's added.
 * Change so that symbol gets filename when parsing rather than when
   being added to the scanner.

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

Don't use deprecated G_CONST_RETURN

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