From 9c37665f00d658321de147b5449e3a81dfd8507c Mon Sep 17 00:00:00 2001
From: CloudKeeper1 <cloud_keeper51@hotmail.com>
Date: Sun, 23 Apr 2017 21:40:37 +1000
Subject: [PATCH] Updated documentation.

Updated documentation explaining use. Also mentioned the result of chaining get_inputs.
---
 evennia/utils/evmenu.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/evennia/utils/evmenu.py b/evennia/utils/evmenu.py
index bd00b75788..117492e05d 100644
--- a/evennia/utils/evmenu.py
+++ b/evennia/utils/evmenu.py
@@ -957,6 +957,13 @@ def get_input(caller, prompt, callback, session=None, *args, **kwargs):
             greater than 2. The session is then updated by the
             command and is available (for example in callbacks)
             through `caller.ndb.getinput._session`.
+        *args, **kwargs (optional): Extra arguments will be 
+            passed to the fall back function as a list 'args' 
+            and all keyword arguments as a dictionary 'kwargs'.
+            To utilise *args and **kwargs, a value for the
+            session argument must be provided (None by default)
+            and the callback function must take *args and 
+            **kwargs as arguments.
 
     Raises:
         RuntimeError: If the given callback is not callable.
@@ -975,6 +982,12 @@ def get_input(caller, prompt, callback, session=None, *args, **kwargs):
         may not be easy to get if caller is a player in higher
         multisession modes), then it is available in the
         callback through `caller.ndb._getinput._session`.
+        
+        Chaining get_input functions will result in the caller
+        stacking ever more instances of InputCmdSets. Whilst 
+        they will all be cleared on concluding the get_input 
+        chain, EvMenu should be considered for anything beyond 
+        a single question.
 
     """
     if not callable(callback):