Migrating documentation into new libebook-contacts book.

This documentation splitup was missed in the recent libebook / libebook-contacts
library splitup.

EBackend: Utilize g_network_monitor_can_reach_async().

If the backend has a GSocketConnectable, determine the "online" state
using g_network_monitor_can_reach_async().

The "online" state is automatically updated on instance initialization,
when the GSocketConnectable is replaced, and when GNetworkMonitor emits
a "network-changed" signal.

EBackend: Keep a reference on GNetworkMonitor.

Keep a strong reference on the default GNetworkMonitor, and connect to
its "network-changed" signal.  Our signal handler does nothing for the
moment, but shortly it will update the "online" state.

EBackend: Add a "connectable" property (GSocketConnectable).

This is the socket endpoint for the network service to which the
EBackend is a client.  This can be NULL if the EBackend does not
use network sockets.

The initial value of the "connectable" property is derived from the
ESourceAuthentication extension of the EBackend's "source" property,
if the extension is present.

EBackend: Use g_clear_object() in dispose().

Post-release version bump.

Fix distcheck error.

NEWS update for 3.7.90 release.

data_cal_handle_remove_objects_cb: Fix GVariant format string.

e_cal_client_remove_objects_sync: Fix an infinite loop.

ECalObjModType is a flags type, not an enum type.

Transmit flags over D-Bus as a string of colon-separated nicknames.

Updated Polish translation

Add optimized indexing capabilities for phone number values.

Creating indexes with normalized phone numbers permits fast phone number
lookup even if the stored vCards or the queried phone numbers are freely
formatted or incomplete.

The numbers are formatted according to E.164 when building the index.
Incomplete numbers are prefixed with a country-code matching the current
locale settings while processing query results.

Updated Mathias Hasselmann's patch on bug 689622 to apply to current master.

Store E.164 phone number values automatically in the vCard

The E.164 normalized phone number is of interest for handset related
applications. With this change a X-EVOLUTION-E164 attribute is added
to each TEL attribute if the contact summary contains a E.164 formatted
variant of the phone number. This shall avoid overhead and inconsistency
that would occur if clients would use their own mechanism to compute
that already stored information.

Updated Mathias Hasselmann's patch on bug 689622 to apply to current master.

e_extensible_load_extensions: Allow for retries.

If e_extensible_load_extensions() does not find any extensions, remove
the GPtrArray from the extensible object.  It may be the extension types
have not been registered yet.  Subsequent e_extensible_load_extensions()
calls on the same object should rescan until extensions are found.

ECalClient: Add a "default-timezone" pointer property.

This just uses the existing e_cal_client_get_default_timezone() and
e_cal_client_set_default_timezone() functions, but the property can
be a useful target for bindings.

Updated POTFILES.in

ebook: make EContactGeo usable in Vala

"new E.ContactGeo()" in Vala fails because the struct has no
constructor. Introducing e_contact_geo_new() fixes that problem.

This extends the API instead of changing it. It is still valid
to allocated EContactGeo instances via some other means.

ebook: make EContactCert usable in Vala

"new E.ContactCert()" in Vala fails because the struct has no
constructor. Introducing e_contact_cert_new() fixes that problem.

This extends the API instead of changing it. It is still valid
to allocated EContactCert instances via some other means.

ebook: avoid repeatedly creating GSettings in e_book_client_is_self

When receiving the complete address book, a client has to use
e_book_client_is_self() on every EContact to find the one which is the
"self" contact. Calling e_book_client_get_self() instead does not
work, because that would create the self contact if none exists (not
desired for an app which just reads!).

The problem with e_book_client_is_self() is that it creates and
destroys a GSettings instance for the self UID each time the method is
called. In addition to reading the value over and over again, this
also triggers two D-Bus messages (AddMatch and RemoveMatch) - clearly
bad for performance.

To solve this problem, this patch caches the GSettings instance in a
static variable. It is protected by a mutex, to keep the function
thread-safe. The downside is that the instance is never going to be
freed.

It would be better to attach the GSettings instance to the EBookClient
instance, but because e_book_client_is_self() doesn't get a pointer to
that, this is not possible without an API change.

Added concurrent view test: test-client-view-operations.c

This tests concurrent access to EBookClientView, 20 threads each
race to receive notifications from the same addressbook and the
test asserts that all 5 contacts in the test addressbook are found.

This is particularly interesting with DEBUG_DIRECT set (Direct Read Access),
as it ensures that concurrent direct reads of the addressbook do not
cause any lockups.

e-test-server-utils: Added DEBUG_DIRECT env var

This is a temporary workaround to test Direct Read Access,
a later patch will ensure all tests check both Direct/Normal read access
modes.

EBookBackendFile: Add support for Direct Read Access.

This patch simply implements the added backend vfuncs to advertize
and configure itself in direct read access mode.

Added Direct Read Access support to EBookClient

Currently the only added api is e_book_client_connect_direct_sync().

If the backend associated to the given ESource does not support direct
read access, or the backend fails to open for any reason, then the
client falls back to regular read access.

EBookClientViews created from an EBookClient that is in direct read
access mode differ in functionality, they only receive UID notifications
over D-Bus and fetch the contact data directly.

EDataBook / EDataBookView: Added Direct Read Access APIs / support

EDataBook:
  Now can be created by the client and offers read only APIs for
  reading back contact data directly from a client side instantiated
  backend

EDataBookView:
  Now use a special "x-evolution-uids-only" fields of interest in order
  to reduce D-Bus traffic, this makes it possible for EBookClientView
  to fetch contact data directly upon receival of notifications.

EBookBackend: Added apis for backends to support Direct Read Access

e_book_backend_get_direct_book:
  A backend can return an EDataBookDirect from here to indicate
  that it supports direct read access, the properties of the EDataBookDirect
  are used by the client to access the book directly

e_book_backend_configure_direct:
  A backend opened in direct read access mode can be configured with
  the string that it's server side counterpart provided, this string
  belongs to the backend; for the local file backend it is used as
  a path to ensure the same SQLite DB is opened by the client as the
  one running in the server.

Added EDataBookDirect & generated D-Bus counterpart.

The EDataBookDirect is the server side wrapper allowing backends
to report information about thier direct read access support.

Fixing broken vala makefile.

My last commit pulled back in the ECalendar vala api, which is for
some reason removed in master, fixed this by re-removing it from
the vala Makefile.am.

Splits libebook into two libraries.

This clears the way for Direct Read Access APIs to be integrated,
since EBookClient now needs to access EDataBook apis, a common
library is needed to share all the addressbook related objects
related to EContact so that it can be used by both the server
side addressbook backends and EDataBook, as well as EBookClient.

Essentially this properly splits things up and avoids a nasty
circular dependency issue.

Fix EDataBook error conversions to include E_CLIENT_ERROR_OUT_OF_SYNC

This causes the test-client-write-write test to pass again.

Bug 693841 - EDataCal: Complete implementation of GetObjectsList

Clients were left waiting for a response from the backend that would
never happen.

Updated Lithuanian translation

EBookBackendSqliteDB: Remodeled concurrent access.

Now use a more traditional locking with a single mutex held at
every API entry point, this protects a single SQLite connection
from being accessed from multiple thread contexts (even in read mode).

[CalDAV] Try to search for event when not in local cache

CalDAV backend depends on local cache when a client ask for an event,
which is usually fine, but when it comes to a meeting invitations,
with which the server can add event to the calendar on its own,
the invitation might not be found in the cache, thus try whether
it's available on the remote machine, before reporting Object Not Found.

EBackend: Avoid breaking libebackend ABI.

This is what the reserved slots in the class struct are for.

Introduce e_backend_is_destination_reachable()

This new function, together with implementation of
e_backend_get_destination_address() on the backend side,
can be used to check whether the backend's destination
is currently reachable. Default implementation reports
backend as always reachable, aka local.

Keep e_flag_timed_wait() building.

Fix a gtk-doc build break caused by commit 623eb5fc7dd2b21f

The HTML tags in gtk-doc comments should be properly escaped,
thus gtk-doc doesn't consider them as real HTML tags.
Thanks Fabien (fta) for the notice.

Typo in test_closure type

Add modules/ubuntu-online-accounts/google-*.service.in to POTFILES.skip

The files contain translations, but are already translated in their
original .in.in files, thus adding them into POTFILES.skip should be OK.

Fix few memory leaks in evolution-source-registry

Bug #686528 - Pickup ownCloud accounts from GOA

Use camel_service_ref_session().

Add camel_service_ref_session().

Replaces camel_service_get_session().

CamelService now uses a GWeakRef instead of a weak pointer.

Updated Spanish translation

Updated Belarusian translation.

Updated Galician translations

Deprecate e_client_cancel_all().

This function no longer does anything.

EClient: Remove internal 'ops' hash table.

This is no longer populated with anything.

Remove e_client_emit_backend_property_changed().

Private API, no longer used.

Remove e_client_get_dbus_proxy().

Private API, no longer used.

Remove e_client_emit_backend_error().

Private API, no longer used.

Remove e_client_emit_backend_died().

Private API, no longer used.

ECalClient: Remove set_proxy_gone_error().

ECalClient now keeps its GDBusProxy alive until dispose(), regardless
of what happens on the server side.  So we don't need to check whether
the GDBusProxy is still present in every method call anymore.  If the
bus name vanishes, let subsequent GDBusProxy calls fail on their own.

ECalClient: Use G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START.

Set the DO_NOT_AUTO_START flag on new client-side proxies, so that if
the factory process crashes we don't restart it by way of some random
method call.  Until the backend's "open" procedure is fully automated
on the server-side, only new client instances should attempt to start
the factory process.

ECalClient: Use g_bus_watch_name_on_connection().

g_bus_watch_name_on_connection() handles "NameOwnerChanged" signals
as well as "closed" signals from the GDBusConnection.  In the event
the bus name vanishes, we schedule an idle callback on the client's
GMainContext to emit a "backend-died" signal.

Also while we're at it, call the close() method asynchronously from
dispose() so we don't block.

EBookClient: Remove set_proxy_gone_error().

EBookClient now keeps its GDBusProxy alive until dispose(), regardless
of what happens on the server side.  So we don't need to check whether
the GDBusProxy is still present in every method call anymore.  If the
bus name vanishes, let subsequent GDBusProxy calls fail on their own.

EBookClient: Use G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START.

Set the DO_NOT_AUTO_START flag on new client-side proxies, so that if
the factory process crashes we don't restart it by way of some random
method call.  Until the backend's "open" procedure is fully automated
on the server-side, only new client instances should attempt to start
the factory process.

EBookClient: Use g_bus_watch_name_on_connection().

g_bus_watch_name_on_connection() handles "NameOwnerChanged" signals
as well as "closed" signals from the GDBusConnection.  In the event
the bus name vanishes, we schedule an idle callback on the client's
GMainContext to emit a "backend-died" signal.

Also while we're at it, call the close() method asynchronously from
dispose() so we don't block.

ECalClient: Fix build break.

Deprecate e_book_client_error_create().

Just use the GError API directly.

Deprecate e_cal_client_error_create().

Just use the GError API directly.

ECalClient: Set GErrors normally.

Set GErrors with g_set_error_literal(), using
e_cal_client_error_to_string() to obtain a generic error message.

G_PRIORITY_HIGH_IDLE is sufficient to beat GTK+ redraws.

GTK+ uses (G_PRIORITY_HIGH_IDLE + 20) for redrawing operations, which is
actually a slightly lower priority than G_PRIORITY_HIGH_IDLE.  Therefore
for our purpose, G_PRIORITY_HIGH_IDLE is sufficient.

Add comments around g_idle_add() changes

Bug #683867 - Schedule actions with higher idle priority

ECalClient: Follow up on a timezone-related FIXME comment.

Emit the "timezone-added" signal from an idle callback on ECalClient's
GMainContext, instead of from whichever thread the timezone was added.
This makes life easier for any handlers of that signal.

Still need to address a similar FIXME comment in ECalBackend, but that
will have to wait until after the backend API rewrite.

Revert "Bug #683867 - Schedule actions with higher idle priority"

This reverts commit 224e8bed43ea13e34adbeef786a0d60f848bb170.

The commit contains not a single comment as to why these custom priority
values are being used.  The rationale needs to be documented in the code,
either at each call point or preferably at a centralized priority value
definition.

test-server-utils.c: Added TEST_INSTALLED_SERVICES env var

This allows us to run tests individually using the installed services,
this makes it easier to trace the server process response to test
cases using instrumentation tools such as gdb and valgrind.

Bug #683867 - Schedule actions with higher idle priority

e-test-server-utils: Destroy dynamic closures

Adds a callback to the closure structure that describes
its concept of self-destruction.

EBookBackendFile: Restore g_type_ensure() calls

Few things got lost in 01857aacc17e0da2766d6c03b3f84efb0cf1392d

Add CAMEL_MIME_FILTER_TOHTML_QUOTE_CITATION flag.

Groups lines beginning with one or more '>' characters in
<blockquote type="cite"> ... </blockquote> tags.  The tags
are nested according to the number of '>' characters.

Document CamelMimeFilterToHTMLFlags.

sqlitedb: Make BOOKSQL_DEBUG reusable

libebook: Really extract the 2-letter country code

Previous code took the locale-ids's language code
instead of the country code.

libebook: Preserve predicate-order of sexps

When parsing conjunction and disjunction expressions the predicate order
got reversed, which breaks any optimizations that utilize lazy evaluation
or summary access patterns.

I am pretty sure I've fixed this once already.
No idea how to fix got lost.

sqlitedb: Remove unused <langinfo.h> include

tests: test e_phone_number_get_default_region()

libebook: Improve phone-number docs and messages

Be more strict about the terms "country calling code" which
relates to phone numbers, and "two-letter country code" which
identifies region.

Fix a memory leak from e_source_webdav_prepare_ssl_trust_prompt()

Updated Galician translations

Add CamelMimeFilterToHTMLFlags type.

Convert the CAMEL_MIME_FILTER_TOHTML_* flag macros to an enum type and
move it to camel-enums.h so a GFlagsClass is generated for it.

Use CamelMimeFilterToHTMLFlags as the 'flags' parameter type in
camel_mime_filter_tohtml_new() and camel_text_to_html().

Remove --with-dbus-call-timeout configure option.

No longer needed.

Deprecate e_data_server_util_get/set_dbus_call_timeout().

No longer used.

Silence some runtime warnings from calendar backends.

Updated Spanish translation

Updated POTFILES.in

EBookBackendFile: Implement GInitable.

Migrate the old BDB database and open the SQLite database in the
GInitable.init() method.  If an error occurs here, the backend instance
is destroyed immediately and the OpenAddressBook() factory method fails.

This obviates the need to check for an open SQLite handle in every
backend method.

ESourceRevisionGuards cleanups.

libebook: Add missing version tags

Some functions and types of the new e-phone-number module
didn't have version tags in their documentation.

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

libebook: Export the API for phone region guessing

This adds e_phone_number_get_country_code_for_region() and
e_phone_number_get_default_region() which give access to the
region guessing mechanisms. They are needed to efficently
build the sqlite backend's phone number indexes.

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

libebook: Give access to country code and national phone number

This information is needed to build a more efficient phone number index.

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

build: Use dedicated compiler warning for C and C++ code

Not all compiler warning flags that are valid for C are valid
for C++, and vise versa.

Updated Spanish translation

Add e_data_factory_ref_initable_backend().

Similar to e_data_factory_ref_backend(), but allows for backends that
implement the GInitable interface so they can fail gracefully if they
are unable to initialize critical resources, such as a cache database.

ECalClient: Avoid race between dispose() and signal handlers.

Use g_signal_connect_object() to ensure the GDBusProxy stays alive while
its signal handlers are running.

EBookClient: Avoid race between dispose() and signal handlers.

Use g_signal_connect_object() to ensure the GDBusProxy stays alive while
its signal handlers are running.

Deprecate e-gdbus-templates.[ch].

Bug #675287 - Spool file account doesn't show messages