[RFC] codegen/doc: Simplify links by allowing `Self::` and `crate::` prefix

A lot of effort was put in to hide these from the final documentation,
by using `[]()` kind of l...

codegen: Emit `crate::` for all global `%` constants except from prelude

doc: Link trait functions in `prelude`

Rust prelude symbols - `true`, `false` and `None` - are explicitly added
to the list of symbols....

Otherwise documentation is repeatedly added on subsequent runs, and
rustdoc-stripper-ignore-next...

Both the symbol name and module it resides in need to be updated for the
resulting link to be va...

We recently removed all `Ext` and `ExtManual` traits from crate roots in
favour of consistently ...

config/function: allow forcing 'constructor' annotation

TryFromGlib support

Types implementing `TryFromGlib` can now be configured to define
how code generation should hand...

Most functions in the `rust_type` modules are designed to pass
a subset of the different argumen...

This allows defining functions such as:

```rust
fn update_flow(&self, ret: Into<FlowReturn>);
`...

Add rename doc aliases

codegen/enums: Keep emitting name of `Self` in string literals

codegen: add missing } for build pattern

oh another issue from my latest PR

Commit 3f36d06 ("Fix some clippy::use_self warnings in generated code")
did away with repeating ...

codegen: only use ret if a builder_postprocess is set

this allows us to enable clippy::let_and_return lint

Fix some clippy::use_self warnings in generated code

Some low-hanging fruit to shorten generated code and making it more
readable at the same time.

out_param: follow aliases for imports

codegen: take Self for Copy types

See https://github.com/gtk-rs/gtk-rs/pull/427#issuecomment-817218736 for details

... instead of the function names.

... is different than in the gir-file name. This includes:

* Name mangling.
* Rust standards en...

build: Rerun if git hash changed

`gir`'s hash in version files gets out of sync quite frequently with the
hash of the submodule. ...

analysis/properties: Remove unused ToValue import for property getters

Following [1] an unnecessary `glib::ToValue` import showed up in auto
code, which does not appea...

[3/3] Emit intra-doc-links for symbol references

codegen/doc: Omit "Feature: `vXXX`" text in favour of doc_cfg

codegen/general: Emit "Since vXXX" in #[deprecated] attributes

docs: manual traits are in prelude only

codegen/object: Only re-export traits from `traits`/`prelude` module

doc: Always consider `trait_name` from `Gir.toml` in implementation docs

ci: Symlink gir directory to ourselves to find generator.py

`generator.py` moved into this repository, and gtk-rs (and friends) now
symlink to `gir/generato...

Following a discussion in [1] we have decided to remove all trait
exports - both manual and auto...

Value trait refactoring

See https://github.com/gtk-rs/gtk-rs/pull/454

fixes #1110

Some types have their trait name overridden for clarity, but this is not
always conveyed in the ...

Import generator.py from gtk-rs

This is fixed in Python 3.8:
https://github.com/python/cpython/commit/744c08a9c75a1a53b7a6521fce...

We have decided to get rid of checked-in documentation in favour of
performing generation and em...

Asyncio is much better suited for spawning complex tasks - in this case
involving process spawni...

Get removal round 2

* Rename child properties getters.
* Add a config to force a specific name for child properties ...

We want to use the generator in the CI to update docs, for which we
don't want to emit updated R...

config,git: Omit gir directory hash and URL if not a submodule

doc: Use intra-doc-links instead of relative paths to html pages

analysis/record: Do not bail on missing memory functions

Fix renamed functions not being documented

This constraint is already enforced with a `panic!` during codegen,
effectively disallowing Gir....

As final step in the intra-doc link conversion this enables generating
links for `#` and `%` ref...

Virtual functions ar generally referred to as #Type.vfunc() which would
get treated as `Type.vfu...

Using intra-doc-links saves quite a bit of code in gir, looks cleaner in
the markdown files and ...

This already exists in the C docs and is clearer to the reader that a
function is referenced and...

Intially plaguing GStreamer-rs this code grabs the git hash from the
root repository if the spec...

Similar to Rusts return and try, just use exceptions and pretty-print
them at the highest level ...

Since the addition of doc regeneration - which also spawns a gir process
for every non-sys crate...

Convenience method to emit documentation for all crates with a
`Gir.toml` file. Optionally take...

Remove get for getters

This is required for enum with get functions since they consume self
and are not considered as g...

- Rename the get functions when applicable.
- Rename the get_property function when applicable.

config: Normalize submodule path before looking it up in .gitmodules

`normalize_path` was introduced in [1] for pretty-printing relative
paths with `../` ParentDir c...

[1/3] Emit intra-doc links for self (`@`) references

git: Read remote url from upstream or origin

`@` is used in few invalid places in the (GStreamer) docs where `#`
should have been used. Inst...

This is using an explicit reference to `Self::` so that there is no
confusion over what to refer...

In the near future we'll want to generate intra-doc-links based on the
reference type in the doc...

`full_rust_name` is only used in two places; one of thich -
`replace_c_types` - does not deal wi...

Neither the module nor struct (wrapped inside `glib::wrapper`) had a
deprecation warning previou...

Nowadays we have the `doc_cfg` feature rendering clean, consistent and
obvious markers for featu...

With the new separate gir directories it is useful to know what repo
(url) a git hash came from,...

As an improvement over the previous commit, which deals with custom
setups where contributors an...