necessary documentation updates.

README.md

@@ -144,8 +144,9 @@ other reference to the currently highlighted element.
 ### Jump to definition
 
 While the cursor is on any identifier call `LSClientGoToDefinition` (`<C-]>` if
-using the default mappings) to jump to the location of the definition. If the
-cursor moves before the server responds the response will be ignored.
+using the default mappings) to jump to the location of the definition. When
+multiple definitions are available, the quickfix list will be opened.
+If the cursor moves before the server responds the response will be ignored.
 
 ### Find references
 

doc/lsc.txt

@@ -50,9 +50,10 @@ COMMANDS                                        *lsc-commands*
                                                 *:LSClientGoToDefinition*
 Jump to the location defining the element under the cursor. Sends a
 "textDocument/definition" request with the location set to the cursor's
-position. If the cursor is not in the same position when the server responds
-the jump will be canceled. With |lsc-default-map| this command is bound to
-`<c-]>`.
+position. When multiple definitions are returned, the quickfix list will
+be opened to prompt the user for choice.  If the cursor is not in the same
+position when the server responds the jump will be canceled.
+With |lsc-default-map| this command is bound to `<c-]>`.
 
 If this version of vim supports |settagstack| the tag stack will also be
 updated to include this jump. Jump back with `<c-t>` or |:pop|, it is not