[Telepathy-commits] [telepathy-spec/master] Mention the rationale for Get_Locations working the way it does

[Simon McVittie]

---
 spec/Connection_Interface_Location.xml |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/spec/Connection_Interface_Location.xml b/spec/Connection_Interface_Location.xml
index 8c415b4..e835d86 100644
--- a/spec/Connection_Interface_Location.xml
+++ b/spec/Connection_Interface_Location.xml
@@ -255,6 +255,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
         for a reply; if a reply with a non-empty location is later received
         for those contacts, the <tp:member-ref>LocationUpdated</tp:member-ref>
         signal will be emitted for them.
+
+        <tp:rationale>
+          This method is appropriate for "lazy" location finding, for instance
+          displaying the location (if available) of everyone in your contact
+          list.
+        </tp:rationale>
       </tp:docstring>
 
       <arg direction="in" name="Contacts" type="au" tp:type="Contact_Handle[]">
-- 
1.5.6.5