GDBus: Make message serialization routines take capabilities param

This is needed to e.g. allow encoding maybe types (once we add
G_DBUS_CAPABILITY_FLAGS_MAYBE_TYPES) if, and only if, that capability
has been negotiated with the peer (via authentication).

remove the redundant interface_name parameter

GDBus: Catch up with new PropertiesChanged signal

After a long discussion, this has finally been standardized in the
D-Bus spec. See

 http://lists.freedesktop.org/archives/dbus/2010-May/012667.html
 http://lists.freedesktop.org/archives/dbus/2010-May/012712.html

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

Fill out the export section of the migration guide

Add an example of exporting a GObject

This is more manual work than dbus-glib.

GDBus: add 'monitor' verb to gdbus(1)

This uncovered a bug in name watching if the name wasn't activatable.

Also provoked the need for on_connection variants of g_bus_watch_name
(added g_bus_watch_proxy's variant as well).

GDBus: Make gdbus(1) print annotations when introspecting data

Also make the gdbus-example-server include some example
annotations. The output looks like this:

$ gdbus introspect --session --dest org.gtk.GDBus.TestServer --object-path /org/gtk/GDBus/TestObject
node /org/gtk/GDBus/TestObject {
  interface org.freedesktop.DBus.Properties {
    methods:
      Get(in  s interface_name,
          in  s property_name,
          out v value);
      GetAll(in  s interface_name,
             out a{sv} properties);
      Set(in  s interface_name,
          in  s property_name,
          in  v value);
    signals:
      PropertiesChanged(s interface_name,
                        a{sv} changed_properties);
  };
  interface org.freedesktop.DBus.Introspectable {
    methods:
      Introspect(out s xml_data);
  };
  interface org.freedesktop.DBus.Peer {
    methods:
      Ping();
      GetMachineId(out s machine_uuid);
  };
  @org.gtk.GDBus.Annotation("OnInterface")
  @org.gtk.GDBus.Annotation("AlsoOnInterface")
  interface org.gtk.GDBus.TestInterface {
    methods:
      @org.gtk.GDBus.Annotation("OnMethod")
      HelloWorld(in  s greeting,
                 out s response);
      EmitSignal(@org.gtk.GDBus.Annotation.("OnArg")
                 in  d speed_in_mph);
      GimmeStdout();
    signals:
      @org.gtk.GDBus.Annotation("Onsignal")
      VelocityChanged(d speed_in_mph,
                      @org.gtk.GDBus.Annotation.("OnArg_NonFirst")
                      s speed_as_string);
    properties:
      @org.gtk.GDBus.Annotation("OnProperty")
        @org.gtk.GDBus.Annotation("OnAnnotation_YesThisIsCrazy")
      readonly s FluxCapicitorName = 'DeLorean';
      readwrite s Title = 'Back To C!';
      readonly s ReadingAlwaysThrowsError;
      readwrite s WritingAlwaysThrowsError = "There's no home like home";
      writeonly s OnlyWritable;
      readonly s Foo = 'Tick';
      readonly s Bar = 'Tock';
  };
};

Add a note about implemented standard interfaces

GDBusProxy: Remove error in get_cached_property() and add set_cached_property()

This makes it possible to use the cached properties mechanism even if
constructing the proxy with the DO_NOT_LOAD_PROPERTIES flag.

This is useful for cases where you obtain the and track object
properties out-of-band. For example, in udisks, the plan is to have
something like this

 Manager.GetObjects    (out ao paths, out aa{sa{sv}} all_properties);
 Manager.ObjectAdded   (o path, a{sa{sv}} all_properties);
 Manager.ObjectChanged (o path, a{sa{sv}} all_properties);
 Manager.ObjectRemoved (o path, a{sa{sv}} all_properties);

E.g. the first GetObjects() call will return *all* data about *all*
exported objects. Further, this way a client will only need to listen
these three signals (three AddMatch) on the Manager object and it will
never need to do GetAll() etc (e.g. can use DO_NOT_LOAD_PROPERTIES).

(Of course this only works if the client is interested in all
objects... while this is true for udisks it is generally not true for
other D-Bus services).

Also use expected_interface to check for programming errors.

Add some more verbiage

GDBus: Add an example of a GDBusProxy subclass

Update an example to the latest auth observer api

Correct env var names

and add a note about priority

placeholder for more migration docs

Update TODO list

mention inline use of floating variants

Remove properties from GDBusMethodInvocation class

Document remove_filter

Document DBUS address env vars

Trivial: tweak section heading

Trivial formatting fix

Fill out the proxy section of the migration guide

Don't refer to nonexisting API.

Fix a typo

Complete the name owning section of the migration guide

Match up parameter names

and similar cleanups to make gtk-doc happy.

Line up prototypes

More gdbus migration stuff

Strip copyright headers from examples

These are included wholesale in the docs, and the copyright
headers make them even more overwhelming. Plus, we don't have
copyright headers on examples anywhere else.

Trivial: rename a file

GDBus: Update TODO list

GDBus: In gdbus(1), try Get() if GetAll() fails

This fixes a problem with services that doesn't implement GetAll() for
one reason or another.

$ gdbus introspect --session --dest org.freedesktop.ReserveDevice1.Audio0 --object-path /org/freedesktop/ReserveDevice1/Audio0
node /org/freedesktop/ReserveDevice1/Audio0 {
  interface org.freedesktop.ReserveDevice1 {
    methods:
      RequestRelease(in  i priority,
                     out b result);
    properties:
      readonly i Priority = 0;
      readonly s ApplicationName = 'PulseAudio Sound Server';
      readonly s ApplicationDeviceName = 'Internal Audio Analog Stereo';
  };
  interface org.freedesktop.DBus.Properties {
    methods:
      Get(in  s interface,
          in  s property,
          out v value);
  };
  interface org.freedesktop.DBus.Introspectable {
    methods:
      Introspect(out s data);
  };
};

GDBus: Add TODO item about a need to validate data / messages

GDBus Add TODO items about finding and launching bus instances

GDBus: Use GVariant instead of GHashTable for GDBusProxy::g-properties-changed

GDBus: Use call() instead of invoke_method()

Lots of people been suggesting this. We still use MethodInvocation /
method_invocation for handling incoming method calls so use call()
instead of invoke_method() helps to separate the client and server
facilities. Which is a good thing(tm).

More copyright year updates

Trivia

Cosmetic fixes

Use P_() for properties, fix up indentation, etc.

Update copyright years to include 2010

Microoptimize string reallocations

Move some platform sources around

gunixcredentialsmessage.h ought to live with other UNIX headers,
and the credentials are moved from dbus-specific to just GIO sources.
Also move gfiledescriptorbased.c to the UNIX sources.

Mention multithreading as a reason for not using libdbus

GDBus: Rework GCredentials type

These changes are is related to

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

and IRC discussions with danw.

Add some conceptual changes

Some documentation tweaks

Add links to the D-Bus docs in some places, and various
other additions.

Document length parameter of g_settings_get/set_strv

This parameter was not mentioned in the doc comment, as pointed
out in bug 617767.

GDBus: add TODO item about maybe having to rework ::g-properties-changed

GDBus: add TODO item about the need to rewrite private GDBusAuth* classes

Add TODO item about wanting G_DBUS_NONCE_TCP_TMPDIR

GDBus: Document environment variables in "Running GIO applications"

A quick cheat sheet

GDBus: add a man page for gdbus(1)

Mention D-Bus functionality in the overview

Add a migration chapter for dbus bits

Also split migration.xml into separate files per chapter, it was
getting unwieldy.

GDBus: Add more symbols to pltcheck.sh's SKIP variable

In particular, add these symbols

 g_memdup
 g_print
 g_random_int
 g_propagate_prefixed_e
 g_thread_create_full
 g_int_hash
 g_file_open_tmp
 g_thread_self
 g_usleep

GDBus: Add new symbols to gio.symbols

GDBus: Fix up i18n

Add "Since: 2.26" to all new GDBus API

Set up gtk-doc for GDBus

Also move send_credentials() and receive_credentials() to
GUnixConnection. This code might change, discussion is still ongoing
in

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

Initial GDBus code-drop from GDBus-standalone repo

Things compile and the test-suite passes. Still need to hook up
gio.symbols and docs. There are still a bunch of TODOs left in the
sources that needs to be addressed.

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

Clean Glib header #include issues: gthread

Clean Glib header #include issues: gmem

Clean Glib header #include issues: gtestutils

Clean Glib header #include issues: gasyncqueue

Do not include "glib.h" in gio files

Minor updates to README.win32.

Fix typo in limits documentation

gio: Add a boxed type for GFileAttributeMatcher

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

Fix list of sources in the gio Visual Studio project

List the additional sources needed in gio/Makefile.am, not in
gio.vcprojin. Fix broken usage of sort. Filter out Unix-only source
files.

Fix misspelled identifier in the Win32 code

g_cancellable_release_fd: allow NULL cancellable

Almost all GCancellable methods silently do nothing if passed NULL for
the cancellable. Make g_cancellable_release_fd() do that as well.

GSettings: fix mixed use of a pointer

  - used in some places as a move-along-as-we-go pointer
  - used in other places as a pointer to the fixed base of an array

Switch all users to the first style to avoid a crasher.

Updated Norwegian bokmål translation

Add API to get the compile and match flags from a GRegex

Bug #616967.

[gvariant-varargs.xml] Fix some outdated documentation

GSettingsBackend API/ABI change

  - add list() virtual method
  - add 'default_value' flag to read() call

.gitignore updates for gsettings stuff

Updated Spanish translation

Updated Spanish translation

GSocket: fix garbled error messages on windows

socket_strerror() was assuming all "strerror" messages are shorter
than 128 bytes, which is certainly true on Linux, but apparently not
on Windows.

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

Allocate quarks in chunks to avoid overhead and fragmentation

See bug 616720 for some measurements.

Bug 616877 – Several issues with g_socket_receive_message

The messages array was not reallocated correctly because it was using
malloc instead of realloc. Also, if the user requested messages but
none were received we would segfault. Rewrite the code to fix this
and, for better readability, use GPtrArray instead of rolling our own.

Also make the docs mention that the user need to free the returned
GSocketControlMessage objects using g_object_unref().

Clarify that *messages may be set to %NULL if there are no messages
(this will save pointless allocs of arrays).

Finally, the Win32 version didn't set messages to the expected value.

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

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

docs and glib.symbols update

Add testcases for <range> and <choices>

Bug #616102.

Add range restriction to gschema-compiler

Patch from Christian Persch, with minor modifications.

Bug #616102

GVariant: add bind map for strings to byte arrays

Add g_variant_{new,get}_byte_array()

Now that strings are strictly utf8 this provides a convenient API for
storing non-utf8 string data.

Make glib_compile_schemas point to a binary that exists

GVariant: strings are now utf8

 - modify serialiser validation function to enforce utf8 encoding
 - add documentation to g_variant_new_string(), g_variant_get_string(),
   g_variant_dup_string()
 - add 2 new test cases to check that it works

Can't use stderr as a field name

Updated Galician translation

bump version

2.25.3

Rename in more places

Updates

Rename gschema-compile to glib-compile-schemas

And clean up the autofoo a bit: use an uppercase variable,
check for pkg-config, check for presence of glib-compile-schemas.

Fix up man page handling

Turns out the formatted man pages did not end up in the tarballs. Doh.

add missing #endif from last patch

GSocket: define CMSG_LEN and CMSG_SPACE if the system doesn't

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