Convert external links to markdown syntax

Don't use <filename> in docs

Switch to simpler markdown, `foo`.

Don't use <envar> in docs

Switch to simpler markdown, `foo`.

updated kn.po

gvariant: Document the need to cast varargs when constructing GVariants

Slightly expand on the documentation about casting varargs when
constructing GVariants, and link to it from all the functions where it’s
a necessary consideration.

Add an example of passing flags to a ‘t’ type variable (guint64).
Assuming the flags enum does not have many members, the flag variable
will be 32 bits wide, and needs an explicit cast to be passed into
g_variant_new() as a 64-bit value.

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

return_if_fail vs. return_val_if_fail fix

gobject: box GVariantDict

We will want to use this in GApplication for a signal and a property.

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

add GVariantDict

...the long-requested mutable dictionary helper for GVariant.

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

Bump version

2.39.4

Updates

Fix a typo

gmain: Note that g_source_destroy() can be called multiple times

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

Updated Traditional Chinese translation(Hong Kong and Taiwan)

tests: Remove a compiler warning

array: Remove a compiler warning

The GRealPtrArray variable is not necessary: we're accessing only public
fields of GPtrArray.

array: Fix compilation

gio: extend the system_internal lists with BSD paths

GVariant: Convert docs to markdown

Specifically, convert the sections to markdown syntax.

Don't use the varname tag

This is just an environment variable, after all.

gmain: Convert docs to markdown

Specifically, convert sections to markdown syntax and
drop all the para tags.

Don't use the quote tag

It was only used in two places, and we can easily do without.

Remove an unnecessary paragraph

Make gtk-doc find another symbol

GTree: formatting fixes

gstrfuncs: Fix up gtk-doc warnings

grand: formatting cleanups

Formatting cleanups

Avoid another gtk-doc warning

Avoid a gtk-doc warning

GIOChannel: Move some docs where they are looked for

Avoid some gtk-doc warnings

Drop another use of xinclude

GArray: Documentation cleanups

Docs: Avoid a 'returns' at the beginning of the line

This confuses gtk-doc.

Add some more deprecation guards to shut up gtk-doc

Drop use of xinclude in GTestDBus docs

Docs: Remove another use of xinclude

Fix up missing symbols in glib-sections.txt

Drop use of the command tag

It is more useful to link to the included man page, anyway.

Docs: Drop use of indexterm tags

These have not been making it into the index, anyway.

Annotate all examples with their language

The C ones, at least.

GApplicationCommandline: Shorten embedded examples

Just show relevant fragments of the three examples inline,
and link to the full sources. This lets us get rid of
xinclude markup.

docs: Stop using the function tag

Don't use computeroutput tag

There was one occurrence of this.

Docs: Big entity cleanup

Strip lots of entity use from |[ ]| examples (which are now
implicit CDATA). Also remove many redundant uses of <!-- -->.

GModule: Move docs away from markup

gtestdbus: Use markdown for sections

GSettings: use markdown for sections

gconvert: Stop using footnotes

These don't really work in the generated docs, so just copy
the content in the few places.

GObject: Convert docs to markdown

In particular, convert lists to markdown syntax.

gregex: Convert docs to markdown

In particular, convert lists to markdown syntax.

goption: Convert docs to markdown

In particular, convert lists to markdown syntax.

gmessages: Convert docs to markdown

In particular, convert lists to markdown syntax.

gmarkup: Convert docs to markdown

In particular, convert lists to markdown syntax.

gmain: Convert docs to markdown

In particular, convert lists to markdown syntax.

GKeyFile: Convert docs to markdown

In particular, convert lists to markdown syntax.

GIOChannel: remove unneeded markup from the docs

ggettext: Convert docs to markdown

In particular, convert lists to markdown syntax.

fileutils: Convert docs to markdown

In particular, convert lists to markdown syntax.

GError: Convert docs to markdown

In particular, convert lists to markdown syntax.

GDateTime: Convert docs to markdown

In particular convert sections and lists to markdown syntax.

gconvert: Convert docs to markdown

In particular, we convert sections and lists to markdown syntax
here.

kqueue: Don't use doc comments

This is not public API, so no need to confuse gtk-doc by
documentation that it needs to ignore. Also, no need for
markup in here.

GVariantType: convert docs to markdown

Convert lists to markdown syntax, and remove lots of <literal>.

GVariant: convert docs to markdown

Convert lists to markdown syntax, and remove a lot of <literal>.

gthread: Convert docs to markdown

Convert lists to markdown syntax.

testutils: Convert docs to markdown

Convert lists to markdown.

GApplication: Convert docs to markdown

gdbusnameowning: Convert docs to markdown

GDBusConnection: Convert docs to markdown

And straighten out capitalization across the file.

GIcon: Convert docs to markdown

GDBusProxy: Convert docs to markdown

GMenuModel: Convert docs to markdown

GSimpleProxyResolver: convert docs to markdown

GSocketClient: convert docs to markdown

GTask: convert long desc to markdown

Use markdown sections and lists here.

gio/tests/network-address: fix for systems with large ifindexes

In some virtualization setups, ifindexes can end up becoming very
large, and so the existing code that assumes that *some* interface
must have an index less than 255 fails.

Fix this by explicitly looking for "lo" first. And then if that fails
(on Windows, or other systems where the loopback interface is not
called "lo"), try indexes up to 1024 rather than 255.

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

Unbreak glib/tests/markup-parse after FSF address change patch

gnetworkmonitornetlink: filter out IPv6 LL MC changes

For some reason, IPv6 link-local multicast routing changes all the
time. GNetworkMonitorBase was already ignoring them for purposes of
emitting network-changed, but GNetworkMonitorNetlink would still
trigger a re-dump after getting one, so network-changed would end up
getting emitted anyway.

Fix the docs build

Docs: Don't use the code tag

Docs: Convert examples to |[ ]|

Docs: Don't use the emphasis tag

Most of the time, the text read just as well without the extra
boldness.

Docs: don't use the warning tag

More markup removal

Docs: Don't use the note tag

More markup avoidance.

Restore executability for other files

Restore executability on data-to-c.pl

Updated FSF's address

Docs: don't use the type tag

Just avoid explicit docbook markup.

Docs: don't use the structname tag

Just avoid explicit docbook markup.

Docs: don't use structfield tags

They don't add anything over @foo, and we want to avoid explicit
docbook markup as far as possible.

Docs: don't use <footnote>

It basically does not work in the HTML output.

Tamil Translations Updated

Drop a no-longer-existing example from the docs

gapplication-example-menu.c was dropped in
0c094d660769a00564ef33a775a387f62cf2ff41, two years ago.
Time to remove its inclusion in the docs too.

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

gobject: Add missing transfer annotation to g_boxed_copy

gio: Add missing transfer annotation to g_simple_proxy_resolver_new

glib/goption.c: Fix build on MSVC

Use #ifdef rather than #if, as MSVC does not like #if <macro> without
parens, and this is the normal usage in other cases like this.

glib: annotate some memory functions with allow-none

Assamese translation updated