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

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