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

gio: Fix some header/source parameter-naming mismatches

gsubprocess: Add missing transfer annotations to get_*_pipe()

test default GSimpleAction activation

Test the default handling of the "activate" signal on GSimpleAction.

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

strfuncs: Make g_str_tokenize_and_fold introspectable

gsettings: Fix annotations

docs: Add missing GTest functions

The GTest message API is missing from the reference.

glib/gtimezone.c: Check the size of tzi.DaylightName

We need to re-get the size of tzi.DaylightName before we call
RegQueryValue() because the buffer might not have enough room to hold the
value for tzi.DaylightName that would be acquired by RegQueryValueExA(),
even though the size of tzi.DaylightName and tzi.StandardName is the same.

This is a pitfall of RegQueryValue()[1] as not doing this can result in an
ERROR_MORE_DATA (234) failure, causing the acquisition of tzi.DaylightName
to fail.

This will fix the gdatetime/equal test, amongst some other tests in
gdatetime, at least on certain non-English version of Windows.

[1]: http://social.msdn.microsoft.com/Forums/vstudio/en-US/84f90854-e90c-4b63-8fc1-655a0b4645fd/regqueryvalueex-returns-errormoredata

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

Use __asm__ instead of asm

This is a little more robust as various compiler flags make
gcc forget about asm.

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

Fix CFLAGS manipulation

The code for ensuring that CFLAGS contain -g if
--enable-debug has been specified did not work right.

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

GAction: remove a lie

Not only was the link to GtkAction broken, it is not true.

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

Try again to fix the freebsd build

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

Clarify g_strchomp and g_strchug docs

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

Clarify type transformability and comparability

If two GValues are transformable, it implies they are compatible,
so you do not need to check for compatibility yourself. Bump the
documentation to reflect this fact.

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

More GTree and GNode formatting and documentation fixes

Among other things, add images for tree traversal types,
taken from Wikimedia Commons.

Move GTraverseType to gnode docs

GQueue: documentation and formatting fixes

GList: Some further documentation and formatting tweaks

tag: documentation enhancement for novice application developers

Adds some code examples how functions can be used. Adds a hint
to look at GQueue if access to the start and the end of the list
is required.

applying comments from Emmanuele Bassi and adds some more
improvements to clarify how functions should be used.

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

glib-init: make static assertions about platform assumptions

GLib has a pervasive assumption that function and data pointers are
basically interchangeable, which is true in all modern ABIs,
but not actually guaranteed by ISO C. If someone tries to use GLib on a
platform where function and data pointers are different sizes, fail early.

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

GHashTable: statically assert that GHashTableIter works as intended

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

glib-private.h: add _glib_alignof

GMainContext: unref pending sources on destroy

It is possible (but unlikely) that there will be a non-empty list of
pending dispatches when we remove the last ref from a GMainContext.
Make sure we drop the refs on the sources appropriately.

Add a (now-working) testcase that demonstrates how to trigger the issue.

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

Work around broken FreeBSD headers

It seems that including just pthread.h does not define
clockid_t on these systems.

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

Fix the build

The thumbnail-verification test (indirectly) includes individual
headers, so define GIO_COMPILATION to make it work.

win32: silence build warning

glocalfile.c: In function 'g_local_file_measure_size_of_file':
glocalfile.c:2654:3: warning: passing argument 2 of 'g_lstat' from
incompatible pointer type [enabled by default]
   if (g_lstat (name->data, &buf) != 0)
   ^
In file included from glocalfile.c:68:0:
../glib/gstdio.h:135:5: note: expected 'struct GStatBuf *' but argument
is of type 'struct _stati64 *'

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

win32: silence build warning

gdbusauthmechanismexternal.c: In function 'mechanism_client_initiate':
gdbusauthmechanismexternal.c:355:3: warning: 'initial_response' may be
used uninitialized in this function [-Wmaybe-uninitialized]
   return initial_response;
   ^
gdbusauthmechanismexternal.c:332:10: note: 'initial_response' was
declared here

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

win32: silence build warning

glocalfileinfo.c: In function '_g_local_file_info_get':
glocalfileinfo.c:1955:11: warning: passing argument 3 of
'get_thumbnail_attributes' from incompatible pointer type [enabled by
default]
           get_thumbnail_attributes (path, info, &statbuf);
           ^
glocalfileinfo.c:1285:1: note: expected 'const struct GStatBuf *' but
argument is of type 'struct _stati64 *'
 get_thumbnail_attributes (const char     *path,

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

Avoid a deprecation warning

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

Adjust doc to Makefile.decl renaming

g_test_build_filename() API documentation still mentions Makefile.decl, but
it has been renamed to glib.mk in f9eb9eed

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

GSimpleAction: fix mistake in last commit

Some bad copy-paste happening here...

GSimpleAction: add default activate handler

If the action is stateful and the user doesn't have their own activate handler
then do some reasonable things for ourselves.

After a lot of experience using stateful GSimpleAction it turns out that
people almost always end up using it in the same ways:

A boolean-typed stateful action with no parameter is most likely going
to want to be toggled.  Any other type of action that has the parameter
type equal to the state type probably intends for activation to
represent a request to change the state.

This patch implements those two cases.  This will let people stop
writing their own trivial handlers over and over.

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

GOptionContext: add some notes about encodings

Add a note to the overview documentation for GOptionContext about why
you need to be careful about argv encoding on UNIX and about why you
should avoid argv entirely on Windows.  Mention some possible
alternative approaches, including a code example.

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

GApplication: change commandline encoding policy

Clarify in the documentation that the commandline arguments passed
around by GApplication (to local_command_line and returned via
g_application_command_line_get_arguments()) are in the GLib filename
encoding (ie: UTF-8) on Windows, not the system code page.

Fix the mismatch that would result from having argv passed to
g_application_run() in main() on Windows (where it is in the system
code page) by ignoring argc/argv on Windows and calling
g_win32_get_command_line() for ourselves.  Document this.

This might be a slight API break on Windows: we documented that it was
possible to call g_application_run() with arguments other than argc/argv
and now doing that will result in those arguments being ignored.  It has
always been recommended practice to only call g_application_run() from
main() directly, however, and all of our code examples have shown only
this.  We will see if this causes any issues and consider reevaluating
the situation if so.

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

g_file_new_for_commandline_arg: clarify encoding

Add a note to the documentation for g_file_new_for_commandline_arg()
that this function is intended to operate on strings already in the GLib
filename encoding on Windows.

This has been the case for a long time, but this documents the
requirement.

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

win32: add g_win32_get_command_line()

This returns the command line in GLib filename encoding format (ie:
UTF-8) for use with g_option_context_parse_strv().

This will allow parsing of Unicode commandline arguments on Windows,
even if the characters in those arguments fall outside of the range of
the system codepage.

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

g_option_context_parse_strv: use UTF-8 on Windows

Add another difference to the freshly-added g_option_context_parse_strv:
now, on Windows, its arguments on to be in UTF-8 instead of the argv[]
encoding (from the system codepage).

The documentation teases g_win32_get_command_line() which is a new
GLib-filename-encoding-based function that will be added in a following
commit.

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

GOption: don't use "rand" in code example

rand() is a function defined in the libc, so our code example gives
warnings if you try to compile it.  Fix that.

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