configure.ac: tweak inotify check

Our check for inotify_init1() being defined is broken.  We happily
declare that inotify is supported, even if the check fails.

This was originally intended to check for inotify_init1 in the libc so
that we could fall back to inotify_init if it was not yet defined.

FreeBSD has a libinotify that emulates the inotify API via kqueue.  It
installs a <sys/inotify.h> header and requires linking to -linotify.  We
don't want to falsely detect working inotify in this case.

Treat the lack of inotify_init1() in the libc as a lack of inotify
support.  This requires only a new libc -- we still support old kernels:
in the case that inotify1_init() fails, we fall back to inotify_init().

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

gtask: fix trivial doc typo

g_test_run: return 0 if all tests are skipped in TAP mode

Exit status 77 is special to Automake's default test driver, but is
treated as an error by TAP.

Bug: https://bugzilla.gnome.org/show_bug.cgi?id=724124
Reviewed-by: Dan Winship <danw>

glib/tests/collate.c: run to completion when skipping all tests

Otherwise, we don't produce valid TAP output, and fail with:

    ERROR: collate - missing test plan

Bug: https://bugzilla.gnome.org/show_bug.cgi?id=724124
Reviewed-by: Dan Winship <danw>

gsocketconnection: Document closing connections with g_io_stream_close()

It’s not enough to close a connection by calling g_input_stream_close()
and g_output_stream_close() on its two substreams: to close the
underlying socket, one must use g_io_stream_close(). Document that.

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

gsocketservice: Clarify g_socket_service_stop() documentation

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

g_child_watch_source_new: POSIX pid must be positive

If we used a non-positive pid, we'd call waitpid(that_pid, ...)
which is exactly the situation this function can't deal with.

On Windows, GPid is a HANDLE (pointer), so I don't think the same thing
applies.

Bug: https://bugzilla.gnome.org/show_bug.cgi?id=723743
Reviewed-by: Ryan Lortie

Be more clear that g_return_if_fail is undefined behaviour

In particular, it is not incorrect to g_return_if_fail (..., FALSE)
in a function returning a "success" gboolean and a GError: "failure to
meet the preconditions is an error" takes precedence over the
GError documentation's guarantee that the error will be set on failure.

Bug: https://bugzilla.gnome.org/show_bug.cgi?id=660809
Reviewed-by: Emmanuele Bassi

po/nb.po: Fix mismatched translation

Missing '\n' at the end of the string broke building under CI.

Updated Norwegian bokmål translation

Updated Indonesian translation

gsubprocess: Fix ‘Since’ lines in documentation to read 2.40

GSubprocess was introduced in GLib 2.40, not 2.36.

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

gsubprocess: Fix a broken link in the documentation

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

Updated Norwegian bokmål translation

[l10n] Updated Italian translation.

Fix a misformatting in GVariant docs

The + at the beginning of the line was misinterpreted
as markdown for a list.

Docs: Drop entities, switch away from sgml mode

Since all element markup is now gone from the doc comments,
we can turn off the gtk-doc sgml mode, which means that from
now on, docbook markup is no longer allowed in doc comments.

To make this possible, we have to replace all remaining
entities in doc comments by their replacement text, &amp; -> &
and so on.

Convert remaining examples to links

REmove another table

Remove some informalexamples

Another stray <programlisting>

Another stray litreal

Strip out a remaining programlisting

Convert another table to a list

Convert more xincluded examples to external links

Docs: Remove an example tag that has snuck back in

Docs: convert another table to a list

Convert GVariantType table to a list

Remove a new literal tag that has crept in

Remove a few leftover <simplelist>s

Remove a stray <em> tag

Remove tables from GFileAttribute docs

Eradicate links and xrefs

These are all replaced by markdown ref links.

Updated Spanish translation

Updated Galician translations

Remove a few overlooked literals

Stop using replaceable tags

Stop using <para> for ids

Instead, use the id support in markdown headings.

Updated Brazilian Portuguese translation

Docs: replace <literal> by `

Docs: use quotes instead of firstterm

Docs: don't use option tags

Stop using starttag elements

Use markdown for images

Use a code block instead of <screen>

GApplication: parse command line options

Add support for parsing command line options with GApplication.

You can add GOptionGroup and GOptionEntry using two new APIs:
g_application_add_option_group() and
g_application_add_main_option_entries().

Also add a "handle-local-options" signal that allows handling of
commandline arguments in the local process without having to override
local_command_line.

As a special feature, you can have a %NULL @arg_data in a GOptionEntry
which will cause the argument to be stored in a GVariantDict.  This
dictionary is available for inspection and modification by the
"handle-local-options" signal and can be forwarded to the primary
instance in cases of command line invocation (where it can be fetched
using g_application_command_line_get_options()).

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

GOption: fix bug in strv mode

We are a bit too aggressive about freeing memory in strv mode.  Only
free it in the case that we actually set the pointer to NULL.

Uncovered by the GApplication tests.

Updated Thai translation

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.