sourcescanner: Fix issues with double constants in the copy

sourcescanner: Fix symbolic references in enum members

We need to copy the source symbols, otherwise we'll
overwrite their values. This isn't good.

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

sourcescanner: Remove unused "id" field

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

docwriter: Use the fully-qualified name for functions and methods

doctool: Use format_xref to format some links to pages

We don't do a full 100% conversion for all link tags, yet,
because I don't want to break too much here. This may come
later.

docwriter: Add support for adding additional attrs to the xref writer

docwriter: Clean up make_page_id

Make it use a simple recursive technique similar to format_page_name.

ast: Fix indentation

ast: Fall back to the namespace for the parent of a Node

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

ast: Rename Class.parent to parent_type

The eventual model I want to have is that .parent is the "container"
of the node. In all the cases where we don't explicitly set the parent,
this is the namespace, but having this under one field name would be
a big cleanup for the docwriter.

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

girparser: Clean up code

This makes it only use kwargs

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

girepository: Document g_enum_info_get_error_domain

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

doctool: Make sure to add "new"

doctool: Don't put curly braces around the construct props if there are none

doctool: Don't link to the namespace from the namespace page

doctool: Rename page_style to page_kind

tests: Clean up doc generation tests

We no longer have to mkdir -p

docmain: Create the output dir for us if it doesn't exist

docwriter: Don't render constants for now

Clutter has thousands of keysym constants, and until we get them
all on one page, this is just tons of tiny files that are just
noise.

doctool: Remove an extra <p> in the signals

Update annotations from glib git

doctool: Remove the ctype from the signal return value

WTF was this here for?

doctool: Add an link for signal methods

doctool: Fix Gjs class signature

doctool: Gjs doesn't have extra signal parameters

doctool: Fix use of <dl> tag in templates

This isn't legal Mallard

docwriter: Skip non-introspectable nodes in introspectable languages

docwriter: Introduce a base formatter for introspectable languages

Introspectable languages share a non-zero set of base semantics,
so it will become easier to implement these shared semantics here,
rather than copy-paste code.

docwriter: Format list types as if they are arrays

Language bindings don't actually care

.gitignore: Update for some testing stuff

I'm building html docs to test, and I don't want git thinking it's
untracked stuff.

giscanner: Suppress deprecation warnings when introspecting types

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

tests/scanner: add Regress-1.0-*-expected to EXTRA_DIST

ast: Allow more options in unresolved_type

If there's an unresolved type for an annotation, it's very likely
it's using a target_giname.

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

tests: Use Regress GIR for doctool

This makes us test a lot more functionality in the doc tool, and
removes the need to have a lot of different test libraries, and
different test infrastructure.

docwriter: Support formatting of types without c:types

This can happen for properties/signals.

docwriter: Support varargs in parameter names

docwriter: Skip lots of special kinds of parameters

Gjs ignores all of these when constructing function signatures.

docwriter: Define a new formatter method for getting params

This will let us gracefully skip over parameters that aren't exposed
by specific language bindings.

It also fixes a bug in the C/Python documentation where we weren't
iterating over the right parameters.

doctool: Don't use zip(range(L))

Instead, remove it entirely (since we don't need the index) or instead
use enumerate().

docmain: Support an include path for GIRs

We need this to replace the test infrastructure so it can find
Utility-1.0.gir

build: Enable g-ir-doctool if mako is found

Let's lift it out of the disabled-by-default ghetto.

scanner: remove backcompat copies more safely

Instead of modifying the namespace while we are iterating over it, which
leads to nodes not being tested, set an 'internal_skipped' property on the
function and read it in the GIR writer.

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

scanner: Fix use of undeclared variable in previous commit

Fixes the NetworkManager build.

transformer: Ensure that types aren't resolved if we can't find them

This ensures that things can't try to reference undefined/invalid types
without emitting warnings, and that users need to include other GIRs at
build time if they want to reference another type.

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

ast: Add a quick __repr__ to Field and Member

Nothing too specific, just something to help with debugging.

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

annotation: Fix invalid type

I'm quite sure this is a typo rather than an intended thing. This
will gain a test and a warning soon.

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

transformer: Warn on unnamed params in declarations

These params are unannotatable and undocumentable. They really
should not be allowed.

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

warningtester: Sort the list of warnings

This means that we can simply put all warnings at the bottom,
unrelated to the order that they're emitted in the code, keeping
line numbers more stable.

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

tests: Move do_moo to warnlib

We want to warn on unnamed params in declarations to ensure that
all functions are bindable. Thus, we need to move a test containing
unnamed params to WarnLib so it can be tested.

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

tests: Move TestInherit into Regress

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

tests: Move Foo into Regress

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

tests: Move Annotation into Regress

The goal here is to have one master library for testing lots of
edge cases for GIRs rather than lots of individual libraries.

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

Update .gitignore

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

tests: Support warning tests in modern automake

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

tests: Update Makefile.am

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

gimarshalingtests: fix spelling mistake in new vfunc object helpers

build: Really fix make dist

build: Fix make dist

Update annotations from glib git

doctool: Rebrand mallardwriter as docwriter

We eventually want to stop using Mallard as a documentation language.
Rationale incoming when I convert all templates back to DocBook.

giscanner: Add a new quick hack module for scanning section files

This will be used to group symbols into documentation sections.

doctool: Move signal/vfunc templates to extend function.tmpl

doctool: Update templates to include the actual instance parameter

Rather than fabricating one with a fake name.

mallardwriter: Fix code for self-parameter forcing

doc-examples-obj: Rename @self to @obj in doc_examples_obj_method

This will be used to test Python "self" parameter forcing.

ast: Allow lookup of the instance parameter by name

This will be used by the doctool to properly identify the
instance parameter.

doc-examples-obj: Fix documentation for doc_examples_obj_method

We need to properly document the first argument, here. We don't
actually iterate over the instance parameter yet, so this will
just affect the documentation for @first_arg.

ast: Add a new all_parameters property to Callable

This will be used by the doctool to show the self parameter in C
and Python docs.

doctool: Switch to UI v1.0

This is to shut yelp up about experimental UI and expanded.

doctool: Initial import of a Gjs language that we support

Copy/pasted from Python.

ast: Make sure to export c:type for signals and properties

mallardwriter: Clean up node filtering

Instead of checking strings, pass this to the Formatter, which is
really mostly about language semantics now.

mallardwriter: Don't set content for links

These are set automatically.

mallardwriter: Use xmlwriter for xrefs

doctool: Use a base template for all node kinds that make sense

doctool: Rename templates to exclude mallard/the language

As templates are in their own directory and segregated into language
already, this is sort of repeating the issue. At the same time, always
explicitly use relative ("./") or absolute ("/") lookups for templates.

We want to eventually have base templates to share between languages, so
to do so without namespace clashes makes sense.

mallardwriter: Use lookup_typenode to look up a Type node

Functions that do what we want? What a concept!

mallardwriter: Simply use the parent page name for nested pages

If we have a parent page, we might as well use it so that parent
names are consistent across pages.

mallardwriter: Don't use function symbols for vfuncs/signals

doctool: Use definition lists instead of tables

doctool: Define a standard order of items for all pages

doctool: Use a base template for all pages

tests: Don't remove the built doctool directories if we're done

tests: Ignore whitespace differences in template comparisons

Adding more Mako code to reduce duplicate code will add newlines to
the output. Ignore these.

doctool: Use a standard title for both links and for page titles

mallardwriter: Fix format_page_name for Namespace

Namespace doesn't have a namespace member.

doctool: Switch to a computed page_style for all page templates

This is a quick cleanup before we inherit from a common template
for all pages.

mallardwriter: Remove unused import

mallardwriter: Parse %ENUM_FIELDs

mallardwriter: Use the same code to lookup fundamentals as the rest

Also, put <code> blocks around fundamentals.

mallardwriter: Use mkdtemp

We should not litter /tmp

girparser: Serialize and read back the instance_parameter

g-ir-doc-tool wants to use the instance parameter to read docs
and the parameter name, so it needs to be shuttled through the
GIR.

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

girparser: Clean up passthrough handling

Instead of remembering to have to set unknown_depth, smarten up
state_switch to do it for us.

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

girparser: Move <doc> handling to passthrough

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

giscanner: Apply standard annotations to constant values

While there's no particular reason I need to do this, there
really isn't any reason to not do this, and it helps with doctool
or whatever in the future if we want to document when a constant
showed up. g-ir-compiler also keeps track of constant deprecations,
so this fixes constants not ever being deprecated.

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

ast: Track enum/bitfield member parents

We need this for the doctool so that we can link to an enum
definition when we reference one of the member values.

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

ast: Track enum members by symbol

The doctool eventually wants to parse inline references to
constant values like %GTK_TEXT_DIRECTION_LTR, so we need to
have a way to look up the original symbol value for an enum
member.

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

tests: %NULL-terminated is wrong

This translates into "None-terminated" in Python, which is bad.
We should eventually strip this phrase entirely for certain languages
with a prefilter.

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

Remove the insane pre-commit hook

I'm sick and tired of this.

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

Update .gitignore

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