Add e_source_registry_dup_unique_display_name().
authorMatthew Barnes <mbarnes@redhat.com>
Sat, 23 Feb 2013 13:45:40 +0000 (08:45 -0500)
committerMatthew Barnes <mbarnes@redhat.com>
Sat, 23 Feb 2013 14:04:15 +0000 (09:04 -0500)
commitdfc2f308fd7e934114780423a3c30f5b8c7f3df6
tree390ea6f4a06570f11fcfccfcb29f1ecf893f8939
parentc53501e96cb3c13f657c80579a8ad94eda886e4e
Add e_source_registry_dup_unique_display_name().

Compares a source's display name against other sources having an
extension with the given extension name, or else against all other
sources in the registry if no extension name was given.

If the source's display name is unique among these other sources, the
function will return the source's display name verbatim.  Otherwise the
function will construct a string that includes the source's own display
name as well as those of its ancestors.

The functions's return value is intended to be used in messages shown to
the user to help clarify which source is being referred to.  It assumes
the source's display name is at least unique among its siblings.
docs/reference/libedataserver/libedataserver-sections.txt
libedataserver/e-source-registry.c
libedataserver/e-source-registry.h