[folks] interface: throw some light on LocalIdDetail's cryptic comments

[Raul Gutierrez Segales <raulgs src gnome org>]

commit 58bc8efd338248eb2a954c5409381ca8ea6860a4
Author: Raul Gutierrez Segales <rgs collabora co uk>
Date:   Wed Aug 31 22:48:56 2011 +0100

    interface: throw some light on LocalIdDetail's cryptic comments

 folks/local-id-details.vala |   12 ++++++++----
 1 files changed, 8 insertions(+), 4 deletions(-)
---
diff --git a/folks/local-id-details.vala b/folks/local-id-details.vala
index 93fd080..fe70df1 100644
--- a/folks/local-id-details.vala
+++ b/folks/local-id-details.vala
@@ -22,16 +22,20 @@ using Gee;
 using GLib;
 
 /**
- * This interface represents the list of IDs corresponding
- * to { link Persona}s from backends with write support so
- * that they can be linked.
+ * This interface represents the list of { link Persona.iid}s
+ * corresponding to { link Persona}s from backends with write
+ * support so that they can be linked.
+ *
+ * This is necessary so that personas from the same backend
+ * can be linked together even if they have no other linkeable
+ * properties set.
  *
  * @since 0.5.0
  */
 public interface Folks.LocalIdDetails : Object
 {
   /**
-   * The IDs corresponding to contacts in a
+   * The IIDs corresponding to { link Persona}s in a
    * backend that we fully trust.
    *
    * @since 0.5.1