More documentation fixups

Remove nonexisting API from the headers

I couldn't find any trace of g_application_run_with_arguments.

Add new gmain api to the docs

Update NEWS for 2.27.1

Update Simplified Chinese translation.

Some more GApplication doc tweaks

Properly register the inactivity-timeout property

It is a uint, not a boolean, so register it as such.
Also, only install the service timeout if we are actually registered
as the primary instance.

Move a confusing comment to the right place

Add another example for commandline handling

Also, clarify some aspects in the documentation.

Add some examples to the GApplication docs

Brush up the GApplication docs

Also, fix up inclusions, mark properties for translation, etc.

Fix a typo

GNetworkService: fall back when there is no valid SRV record

RFC 2782 says that if there is no SRV record for
_SERVICE._PROTOCOL.DOMAIN, you should fall back to trying just DOMAIN,
with the default port for SERVICE. Do that.

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

GNetworkService: fix iteration of multiple addresses

Previously if there were multiple SRV records, only the first would
be iterated by the GSocketConnectable interface

GSocket: set protocol when using g_socket_new_from_fd()

Otherwise, attempting to create a GSocketConnection from the socket
will likely return the wrong type, since the protocol won't match any
of the registered subtypes.

Also add the start of a GSocket test program (from davidz).

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

Fix deadlock in g_object_remove_toggle_ref()

The code section guarded with toggle_refs_mutex includes a call to
g_object_unref(), which may call toggle_refs_notify(). As the latter
tries to acquire the same mutex, glib locks up.

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

Protect access to closure, weak refs and toggle refs arrays

This fixes https://bugzilla.gnome.org/show_bug.cgi?id=613822

GApplication: create local commandline properly

Don't pass a gchar** to g_object_new() when a GVariant* is expected.

GPeriodic: pass microseconds to the tick functions

...instead of milliticks, which nobody really cares to understand.

GPeriodic: a periodic event clock

Add a new class, GPeriodic.

We hope to use this as a paint clock that can be shared by GTK and
Clutter.  Many changes are still expected to the API.

GApplication: reduce GVariant abuse

Don't use GVariant* as the representation for the argument array.

Cleanup and doc GApplicationCommandLine

GIO reference doc cleanups (re: GApplication)

GDBus: disable test to work around bug #631379

This test consistently prevents 'make distcheck' from passing on Ubuntu.

GApplication: merge DBus interface into C source

instead of having it in a separate file that causes problems to the
build system (I want to avoid using EXTRA_DIST here).

gio: update symbols

Don't try to dist old GApplication implementations

One of them was deleted already, even.

GApplication: use g_signal_accumulator_first_wins

...instead of our homebrew version.

Change 'Since:' to 2.28 for action classes

GApplication: fill in action group implementation

gio: app info symbol file fixup

gio: symbol file updates (actions, command line)

Rename methods on GActionGroup to include 'action'

Makes explicit the fact that you are interacting with the individual
action rather than the group and removes potential namespace conflicts
with classes implementing the interface (like g_application_activate()
vs g_application_activate_action()).

GApplication: stub-in GActionGroup implementation

GApplication test: test remote commandline

Also, a few small fixes/tweaks to other places in the test.

GApplication: add remote commandline support

GApplication test case

GApplication: fix inactivity-timeout

Create the gobject property for it.

Tweak the logic of having a pending timeout at the time that the
application starts -- run the mainloop with a use count of zero if there
is a timeout active.

new GApplication implementation

Use CSIDL_LOCAL_APPDATA on Windows

Make g_get_user_data_dir() return the CSIDL_LOCAL_APPDATA folder on
Windows, and not CSIDL_PERSONAL. On Windows 7, that corresponds to the
subfolders AppData\Local vs. Documents under the profile ("home")
folder. This matches what Qt does, for instance, and has been widely
requested.

Also make g_get_user_config_dir() return this and not the (roaming)
CSIDL_APPDATA folder. The reason for this change is that it would be
surprising and hard to justify if g_get_user_data_dir() returned the
local application data folder while g_get_user_config_dir() would
return the roaming one. Nothing in the function names or the XDG specs
suggests that any roaming vs. local dichotomy would be involved.

Document the new semantics and the fact that these two functions now
return the same directory on Windows.

Note that in reality, code that really truly wants to support Windows
as well as possible probably will not use these GLib functions anyway,
but Win32 APIs directly to be sure what it is doing...

Should hopefully satisfy complaints in bug #620710 and related bugs.

Prevent error pileup

GSignal: fix trivial docs typo

GObject: add g_signal_accumulator_first_wins

Deals with the case where we want exactly one signal handler to run.

gthemedicon: Fix annotation for g_themed_icon_get_names

Updated Spanish translation

gtypemodule: Mention g_object_run_dispose correctly in a warning

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

gobject: Improve install_properties()

Cache the parent type outside of the loop, and fix a typo in the
documentation.

Initialise lengths in GvdbReader to silence warnings

Initialise lengths in GDbusAuth to silence warnings

Mention g_object_run_dispose correctly in tutorial

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

Updated British English translation

Remove g_desktop_app_info_lookup_get_type symbol from gio.types

It was removed in 9b262f1c5fe5a6fd879f17cd7b80d8c54e33d80c

Don't call close() on -1

Of course, a proper implementation of close() will just ignore an
invalid parameter silently, and set errno. But apparently the "debug"
version of the Microsoft C library generates some noise in this
case. So avoid that. Thanks to John Emmas for reporting.

Updated Hebrew translation.

Replace "gio-desktop-app-info-lookup" extension point

With a native version, that looks for desktop items supporting
x-scheme-handler/foo, when looking for a handler for the "foo"
URI scheme handler.

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

volume monitor: don't unref NULL

Fix a couple more cases of blindly calling g_object_unref() on the
result of a function that is documented as sometimes returning NULL.

GVariant tests: fix bad allignment assumption

One of the GVariant test cases allocates a pair of character arrays on
the stack and then passes them to functions that assume that they will
be aligned to a multiple of two.

This is not the case for some versions of GCC (4.0.3 on PowerPC).

GSettings test: fix error match strings

The name of the internal function that appears in an assertion message
has changed.  Update the tests.

gsettings-tool: Add 'range' subcommand

Provides access to the g_settings_get_range() functionality, converting
its return value to something that's reasonable for printing at the
console and potentially parseable.  The format may change.

Bug #631264.

gsettings-tool: implement range-checking

Prevent assertion messages from spewing forth and also ensure that we
exit with an error status in the event that the value was out of range.

Bug #631264.

Update symbols and docs sections

GSettings: add g_settings_range_check() API

Checks if a given value is within the correct range for a key.

Bug 631263 - GSettings needs range/choice APIs

Add g_settings_get_range() to describe the possible values that may be
provided to g_settings_set_value() without causing an error.

Add a test case.

schema compiler: Don't store zero-valued flags

Don't store the "none" value for flags into the compiled schema file.
"none" should never appear as a value -- no flags set is indicated by an
empty array.

Bug 627126 - gsettings schemas on FreeBSD

Rewrite the install rule for GSettings schemas to not depend on an
obscure chunk of non-portable sed that nobody understands the purpose
of.

Instead, use make's VPATH feature to resolve the paths of the files that
need to be installed.  No need to depend on the .valid targets here
since automake already ensures that 'make all' is complete before 'make
install' is permitted to run.

glib-compile-schemas: write strinfo little endian

Ensure that the strinfo is output in little-endian byte order on big
endian machines.

GSettings is now passing all of its tests on PowerPC.

Bug #630968 is closed.

GSettings strinfo: byteswap integers

strinfo is always strictly little endian, so ensure that we byteswap to
native when comparing and returning.

GSettings endian: missed a spot

Missed an instance of get_value -> get_raw_value search/replace.

GSettings big endian tweaks

GSettings relies on parts of the schema infromation remaining
unbyteswapped (the strinfo database, for example) while requiring other
parts to be in native order (the default value, constraints, etc.).

Lift the byteswapping into a place where we can do it selectively.

Merge remote branch 'gvdb/master'

Add gvdb_table_get_raw_value() API for GSettings

GSettings test: fix unsafe GObject properties use

The test case was passing a guint16 to g_object_get() for a guint
property.  That's invalid on all systems, although it works (more or
less) on little endian ones.  On big endian it's a total no-go.

GVariant: avoid byteswapping in some cases

Make g_variant_byteswap() merely return a new reference on the given
value in the event that we know that byteswapping will have no effect
(ie: types which have no alignment requirement).

This fixes a somewhat complicated interaction between GVariant,
GSettings and GVDB on big endian machines:  GSettings assumes that it
can unref values returned from GVDB without losing access to the
underlying data.  This only works if the underlying data is in the
mapped file -- not a freshly-allocated buffer that GVariant byteswapped
into.

Merge remote branch 'gvdb/master'

Fix reader on big endian

Some of the hashtable code was failing to byteswap properly.

allow libtool 2.4

It's released now and it seems to work OK.

Bug 623400 - acquire context before dispatching

For GSettings.

Use the functionality introduced in the last commit to simplify our
notify dispatching and increase the safety of doing so (by ensuring that
the context is acquired in the current thread for the duration of the
dispatch).

This closes bugs #623400 and #629849.

Bug 618737 - "dispatch to context" functionality

Adds a new function g_main_context_invoke() (and _full() variant).

This function takes a main context, a function and a user_data.  If the
main context is already acquired in the current thread, the function is
invoked directly.  If the main context is the default main context of
the current thread and it can be acquired then the function is invoked
directly while the context is owned.  Otherwise, the function is
scheduled as an idle on the context.

Updated Lithuanian translation by Aurimas Černius <aurisc4@gmail.com>

gsettings-tool: Rewrite

Rewrite the GSettings tool.

Improvements/changes:

 - simplify the code by performing common actions (like creating a
   schema) in only one place instead of one per-command

 - new features (list schemas, list keys, monitor multiple, etc)

 - factor-out bash completion and implement in shellscript

 - input validation: should never abort due to invalid inputs

Still to do:

 - proper error checking for ranges/choices

 - support for querying range/choice information

 - bash completion support for enums

Closes bug #629289, possibly among others.

GSettings: implement .property_get('path')

This was unimplemented in g_settings_get_property(), leading to a failed
'g_assert_not_reached()'.

Add 'Since:' tags for schema listing APIs

Clean up g_settings_list_schemas()

In its previous form, g_settings_list_schemas() was not useful as a tool
to prevent aborts due to using g_settings_new() with an invalid schema
name.  This is because g_settings_list_scheams() also listed relocatable
schemas, and calling g_settings_new() for those would abort just the
same as if you called it for a non-existent schema.

Modify g_settings_list_schemas() so that it only returns schemas for
which it is safe to call g_settings_new().  Add another call for sake of
completeness: g_settings_list_relocatable_schemas().

Updated Bulgarian translation

Improve .gitignore

Bug 628937 - gracefully handle broken schemas

Implement the second feature requested in the bug: silently ignore
override files that attempt to override schemas that are not currently
installed.

Also, support 'strictness' being optional for other errors when parsing
override files (ie: inability to open the file, unknown key name, parse
errors, out of range).  We don't completely back out the file in this
case — as that is difficult with the current implementation — but just
ignore the override for the single key.

glib-compile-schemas: improve error accuracy

We wrote "<enum> must contain at least one <value>" for empty <flags>.
Fix that.

Bug 628937 - gracefully handle broken schemas

Implement the first of two features requested in the bug: when
encountering a broken .xml schema file, back out the changes in that
file and continue to parse other files.

This prevents a single broken .xml file from messing up GSettings for
everyone else.

Add a --strict option to get the old behaviour.  Use this from the test
cases.

Bug 630077 - GDateTime week number support

Fully implement support for ISO 8601 week dates in GDateTime and
document that this is the case.

Add an exhaustive test case to ensure correctness.

message_to_write_data_free: Don't unref data->message if it is NULL

After the recent changes to message filtering, it can happen that
data->message is NULL when we get here.

l10n: Updated Greek translation for glib

Updated Polish translation

introspection: Fix one annotation syntax

Updated Hungarian translation

Updated French translation

Update Czech translation

Updated Slovenian translation

Updated Galician translations

Updated Slovenian translation

Updated Slovenian translation