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

Updated Lithuanian translation (thanks Aurimas Cernius).

[i18n] Updated German translation

Updated Brazilian Portuguese translation

Updated Bulgarian translation

clean up g_date_time_get_week_day()

No functionality changes here.

Vastly simplify the algorithm for calculating the day of the week.

Fix the documentation (which is incorrectly stating that 1 means
Sunday) and clarify that the number we return is in line with ISO 8601
week day numbering.

Updated Dutch translation by Wouter Bolsterlee

Updated Romanian translation

Add a lot of missing annotations

[introspection] Add GObject annotations

These were moved in from gobject-introspection

[introspection] Move over annotations

Move all the annotations over from gobject-introspection.

They will not be used directly by the introspection scanner for now,
instead they will be extracted by a script and updated manually
until introspection is properly integrated into the glib build

Correct error message when GUnixOutputStream fails to write

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

Add missing file to POTFILES.in

GDBus: Don't use abstract sockets in test code

It doesn't really work right now because of a dbus-daemon(1) bug - see
the comment added in the TODO section of gdbusconnection.c. So revert
to old behavior. The downside is a lot of files in /tmp but right now
that's better than not being able to run tests in a loop.

Signed-off-by: David Zeuthen <davidz@redhat.com>

GDBus: Use abstract namespace in test cases to avoid littering all over /tmp

Signed-off-by: David Zeuthen <davidz@redhat.com>

GDBusConnection: Use correct GMainContext when invoking free functions

Without this fix, the ./gdbus-connection test case occasionally fails, see

 https://bugzilla.gnome.org/show_bug.cgi?id=629945#c5

like this

 /gdbus/connection/basic: OK
 /gdbus/connection/life-cycle: **
ERROR:gdbus-connection.c:223:test_connection_life_cycle: assertion failed:
(!quit_mainloop_fired)
 cleaning up bus with pid 21794
 Aborted (core dumped)

because the callback didn't happen on the same thread as where we are
running the loop.

Signed-off-by: David Zeuthen <davidz@redhat.com>

build: fix out of srcdir build

The gtk-doc makefile rules do cd srcdir && cp $(HTML_IMAGES) target/ and this
breaks for "srcdir" != ".".

GDBus: fix name test cases

Since we make message buses come and go, we need to ensure that the
singleton connection instance goes away before attempting to call
g_bus_get_sync() or similar.

Signed-off-by: David Zeuthen <davidz@redhat.com>

GDBus: bump timeout for some tests

When under load, a one second timeout is just not enough. This can be
observed by e.g. restarting a CPU- and IO-intensive application like a
web browser with many tabs while running the test cases. Therefore,
bump the timeouts to 30 seconds.

Signed-off-by: David Zeuthen <davidz@redhat.com>

GDBus: Move "slow" connection test cases into separate test program

Signed-off-by: David Zeuthen <davidz@redhat.com>

GDBusConnection: Avoid callbacks on finalized connection

Turns out that GDBusWorker will issue callbacks (in its own thread)
even after g_dbus_worker_stop() has been called. This would rarely
happen (and unreffing a connection is even rarer) so only saw this bug
occasionally when running the gdbus-connection test case in a loop.

Fix up this issue by maintaining a set of GDBusConnection objects that
are currently "alive" and do nothing in the callbacks if the passed
user_data pointer is not in this set.

Also attempted to fix up a race condition with
_g_object_wait_for_single_ref_do() and its use of GObject toggle
references - for now, just resort to busy waiting, thereby
sidestepping the toggle reference mess altogether.

Signed-off-by: David Zeuthen <davidz@redhat.com>

Updated Japanese translation (symbolic link related)

Fix memory leak in SOCKSv5 implementation

glib-2.0.m4: Use unsigned variables for version numbers

When using signed, we get complaints from gcc about comparing signed to
unsigned with -Wsign-compare. And combined with -Werror in users' CFLAGS
it breaks configure runs.

Updated French translation

GSocketControlMessage: clean up confusing code

It looks like the deserialisation function in GSocketControlMessage can
potentially leak a reference to the class structure of a
GSocketControlMessage subclass (although the particular code path is
probably never hit).

Clean up the code a bit.

Also, make sure that the GUnixCredentialsMessage type is registered
before attempting deserialisation.

Closes bug #629687.

fix argument order for g_date_time_difference()

The names of the arguments in the header file was reversed.

Closes bug #630000

Add translator comments for command parameter translation

[l10n] Updated Estonian translation

Updated Basque language

Bug 630185 — Allow NULL strings in g_quark_try_string()

Allow NULL strings to be passed to g_quark_try_string(), returning a 0 quark
in that case, as per the existing documentation. Closes: bgo#630185

Fix typo

gdir: Clarify in documentation that ordering is not defined

l10n: Updated Greek translation for glib

Updated Hebrew translation.

docs: shorten var name in example

We use 'pspec' instead of 'maman_param_spec' elsewhere too.

docs: fix iface type naming

docs: fix docbook validity

'type' must be inside of 'link'.

docs: cleanup constructor example

Remove unused var and chain-up the sane way we do elsewhere.

docs: use passive voice.

Updated Japanese translation

Updated Danish translation

Updated Dutch translation by Wouter Bolsterlee

[l10n] Updated Estonian translation

GDateTime: G_GNUC_WARN_UNUSED_RESULT for modifiers

Emmanuele suggested adding G_GNUC_WARN_UNUSED_RESULT to all of the
g_date_time_add_* functions to help deal with the situation where people
may mistakenly believe that these functions are inplace modifiers.

Fix header cleaup fallout when using system pcre

Using the internal pcre has the side effect of exposing gregex.c to
glib.h.  When we use the system one, we lose that, so we need to
explicitly include the things we use (glist, gatomic, etc..)

Updated Portuguese translation

bump version to 2.27.1

release 2.27.0

GDateTime: fix a test that fails from time to time

The test fails if it's a different date in the time zone of the machine
running the test than it currently is in UTC.

Bump to version 2.27.0 after branching glib-2-26

.gitignore some test cases

.gitignore some sgml

Deal with gtk-doc's insane sensitivty to spaces

...by inserting a few of them.

Clean-up/tweaking of GDateTime and GTimeZone

datetime: Fix hashing

Convert to the epoch, just like we do when checking for equality, so
that timezones are correctly handled.

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

datetime: Rename g_date_time_printf() to g_date_time_format()

The function does not use any printf() modifiers, so using printf() is a
misnomer.

Prior art: strftime, g_ascii_formatd

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

datetime: Update modifiers for DST changes

If a DateTime gets modified to cross the DST state from its previous
state then we want to update the DateTime to compensate for the new
offset.

In other words, if we have a DateTime defined as:

  DateTime({ y: 2009, m: 8, d: 15, hh: 3, mm: 0, tz: 'Europe/London' });

and we add six months to it, the hour must be changed to 60 minutes
behind, as the DST comes into effect.

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

datetime: Allow setting fractionary seconds in new_full()

Otherwise we'll have to do:

  dt = g_date_time_new_full (Y, M, D, h, m, s, tz);
  tmp = g_date_time_add_usec (dt, usec);
  g_date_time_unref (dt);
  dt = tmp;

With its additional allocations.

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

datetime: Rework time zone support in constructors

Timezone handling is complicated. Really complicated.

In order to simplify it a little bit, we need to expose the GTimeZone
structure.

First of all, we allow creating time zone information directly from the
offset and the DST state, and then pass it to the g_date_time_new_full()
constructor. We also need to clean up the mess that is UTC-vs.-localtime
for the other constructors.

We also allow creating a GTimeZone from the Olson zoneinfo database
names; a time zone created like this will be "floating": it will just
reference the zoneinfo file - which are mmap()'ed, kept in a cache and
refcounted. Once the GTimeZone has been associated with a GDateTime, it
will be "anchored" to it: the offset will be resolved, as well as the
DST state.

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

g_output_stream_write: fix misleadingly ungrammatical documentation

pointed out in https://bugzilla.gnome.org/show_bug.cgi?id=626866