From 9e649ffdf288d09e80ca727c8f444be548b1a571 Mon Sep 17 00:00:00 2001
From: Grzegorz Adam Hankiewicz <gradha@imap.cc>
Date: Sat, 6 Jul 2013 17:59:26 +0200
Subject: [PATCH] Mentions expected order of idetools suggest results.

---
 doc/idetools.txt | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/idetools.txt b/doc/idetools.txt
index 4ba4a4511e..ce6062e635 100644
--- a/doc/idetools.txt
+++ b/doc/idetools.txt
@@ -119,7 +119,9 @@ separators!).
 
 The typical usage scenario for this option is to call it after the
 user has typed the dot character for `the object oriented call
-syntax <tut2.html#method-call-syntax>`_.
+syntax <tut2.html#method-call-syntax>`_. Idetools will try to return
+the suggestions sorted first by scope (from innermost to outermost)
+and then by item name.
 
 
 Invokation context