release 2.27.0
diff --git a/NEWS b/NEWS
index daa2d8a..0c0da23 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,107 @@
+Overview of Changes from GLib 2.25.15 to GLib 2.27.0
+====================================================
+
+Build:
+ - massive restructuring to reduce #include abuse
+ - tweaks to silence some harmless compiler warnings
+ - rename gschema-compile.c to glib-compile-schemas.c
+ - Windows fixes
+ - fix building with zlib < 1.2.4 on win32
+
+GDateTime:
+ - better msgctxt for translating month and weekday names
+ - API is changed quite a lot, implementation is improved
+ - GTimeZone is now exposed
+
+GObject:
+ - make ordering for overridden interface properties consistent
+ - ->priv structures are limited to 64k but this was not documented,
+ and exceeding this limit produced bad results. Add docs and enforce
+ the limit properly.
+ - add g_object_class_install_properties() to install multiple
+ properties in one go
+ - improve debugging output for GValue containing G_TYPE_STRV
+
+GIO:
+ - fix priority sorting of GIO extensions
+ - add GCredentials support on FreeBSD
+ - fix support for IPv6 addresses in URI parsing functions
+ - GSocketClient fixes for when g_socket_connect succeeds immediately
+ - clarify string encoding for GFile constructors in docs
+ - new functions g_data_input_stream_read_upto{,async,finish}
+ - tweak confusing documentation for g_output_stream_write()
+
+GDBus:
+ - GDBusMessage can now be locked and copied (like in libdbus)
+ - GDBusConnection filter function API has changed again
+ - GDBusServer: ::new-connection now declares if the connection was claimed
+ - add a partial workaround for GObject bug 627724.
+ - very many memory leaks fixed
+
+GVariant:
+ - check for size == 0 in g_variant_get_bytestring to avoid a crash
+ when attempting to get_bytestring() from an empty array
+ - improve gobject-introspection annotations
+
+GSettings:
+ - add GSettings Windows registry backend
+ - some internal tweaks to the backend API
+ - remove g_settings_list_items
+ - add g_settings_list_children and _list_keys to replace it
+ - add schema compiler restrictions for dealing with lists
+ - don't automatically emit value changed signals on writability
+ changes
+
+Other:
+ - constify the 'parser' vtable param to g_markup_parse_context_push()
+ - plug many memory leaks in test cases
+
+Bugs closed:
+ 50076 Time API to go with date API
+ 584284 g_data_input_stream_read_until_async different from sync version
+ 624546 Modification of GDBusMessage in filter function
+ 626919 Let g_object_class_install_property() return the installed GParamSpec*
+ 628029 GDateTime missing get_week_of_year method
+ 628253 Interface properties not listed in a consistent order
+ 628331 Plug lots of mem leaks in gio test suite
+ 628345 Plug a mem leak
+ 628436 Plug a mem leak
+ 628505 Fix building with zlib < 1.2.4 on win32
+ 628839 [PATCH] datetime: Rename shadowing variables
+ 628904 [PATCH] Add credential support for FreeBSD and fix a socket issue
+ 628952 incorrect glib_major_version and other variables on cygwin.
+ 629192 g_strdup_value_contents(): dump GStrv more usefully
+ 629251 g_socket_client_async_connect_complete: assertion failed
+ 629259 Failed to connect to "::1"
+ 629328 g_markup_parse_context_push doesn't respect const structs
+ 629429 month "May" short and full form same with "GDateTime" msgctxt
+ 629689 GDBusConnection leaks its GCredentials
+ 629698 Segfault in g_variant_get_bytestring()
+
+Updated translations:
+ Arabic
+ Armenian
+ Basque
+ British English
+ Czech
+ Finnish
+ Galician
+ German
+ Hungarian
+ Indonesian
+ Japanese
+ Lithuanian
+ Norwegian bokmål
+ Polish
+ Portuguese
+ Punjabi
+ Simplified Chinese
+ Slovenian
+ Spanish
+ Swedish
+ Swedish
+ Traditional Chinese
+
Overview of Changes from GLib 2.25.14 to GLib 2.25.15
=====================================================
diff --git a/docs/reference/glib/tmpl/glib-unused.sgml b/docs/reference/glib/tmpl/glib-unused.sgml
index 3d551f7..7b57189 100644
--- a/docs/reference/glib/tmpl/glib-unused.sgml
+++ b/docs/reference/glib/tmpl/glib-unused.sgml
@@ -937,46 +937,6 @@
</para>
-<!-- ##### VARIABLE glib_binary_age ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION glib_check_version ##### -->
-<para>
-
-</para>
-
-@required_major:
-@required_minor:
-@required_micro:
-@Returns:
-
-<!-- ##### VARIABLE glib_interface_age ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### VARIABLE glib_major_version ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### VARIABLE glib_micro_version ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### VARIABLE glib_minor_version ##### -->
-<para>
-
-</para>
-
-
<!-- ##### MACRO lseek ##### -->
<para>
diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml
index 2c4e8d8..245a775 100644
--- a/docs/reference/glib/tmpl/messages.sgml
+++ b/docs/reference/glib/tmpl/messages.sgml
@@ -117,15 +117,18 @@
@args: the parameters to insert into the format string.
-<!-- ##### MACRO g_message ##### -->
+<!-- ##### FUNCTION g_message ##### -->
<para>
A convenience function/macro to log a normal message.
</para>
+@format:
+@Varargs:
+<!-- # Unused Parameters # -->
@...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- ##### MACRO g_warning ##### -->
+<!-- ##### FUNCTION g_warning ##### -->
<para>
A convenience function/macro to log a warning message.
</para>
@@ -135,10 +138,13 @@
variable (see <ulink url="glib-running.html">Running GLib Applications</ulink>).
</para>
+@format:
+@Varargs:
+<!-- # Unused Parameters # -->
@...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- ##### MACRO g_critical ##### -->
+<!-- ##### FUNCTION g_critical ##### -->
<para>
Logs a "critical warning" (#G_LOG_LEVEL_CRITICAL). It's more or less
application-defined what constitutes a critical vs. a regular
@@ -153,10 +159,13 @@
<ulink url="glib-running.html">Running GLib Applications</ulink>).
</para>
+@format:
+@Varargs:
+<!-- # Unused Parameters # -->
@...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- ##### MACRO g_error ##### -->
+<!-- ##### FUNCTION g_error ##### -->
<para>
A convenience function/macro to log an error message.
Error messages are always fatal, resulting in a call to
@@ -166,16 +175,22 @@
assertion failure.
</para>
+@format:
+@Varargs:
+<!-- # Unused Parameters # -->
@...: format string, followed by parameters to insert into the format string (as with printf())
-<!-- ##### MACRO g_debug ##### -->
+<!-- ##### FUNCTION g_debug ##### -->
<para>
A convenience function/macro to log a debug message.
</para>
-@...: format string, followed by parameters to insert into the format string (as with printf())
+@format:
+@Varargs:
@Since: 2.6
+<!-- # Unused Parameters # -->
+@...: format string, followed by parameters to insert into the format string (as with printf())
<!-- ##### FUNCTION g_log_set_handler ##### -->
diff --git a/docs/reference/glib/tmpl/version.sgml b/docs/reference/glib/tmpl/version.sgml
index dca4ac9..027a0f4 100644
--- a/docs/reference/glib/tmpl/version.sgml
+++ b/docs/reference/glib/tmpl/version.sgml
@@ -22,6 +22,47 @@
<!-- ##### SECTION Image ##### -->
+<!-- ##### VARIABLE glib_major_version ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE glib_minor_version ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE glib_micro_version ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE glib_binary_age ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE glib_interface_age ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION glib_check_version ##### -->
+<para>
+
+</para>
+
+@required_major:
+@required_minor:
+@required_micro:
+@Returns:
+
+
<!-- ##### MACRO GLIB_MAJOR_VERSION ##### -->
<para>
The major version number of the GLib library.
