Merge remote branch 'origin/master' into edge

Author: automatic-merge

doc/README.md

@@ -24,7 +24,7 @@ Here are some implementations of custom features in the ALS implemented through
 ## Feature description document
 
 Each feature is described in a dedicated Markdown document.
-There is [a list of all features](.#list-of-features) at the end of this document. 
+There is [a list of all features](.#list-of-features) at the end of this document.
 We provide a [template](./TEMPLATE.md) for convenience.
 The feature description document has the following structure:
 
@@ -60,4 +60,5 @@ related resources.
  * [Reference kinds](reference_kinds.md)
  * [Show Dependencies](show_dependencies.md)
  * [Check Syntax](check_syntax.md)
- * [Executables](executables.md)
+ * [Executables](executables.md)
+ * [Call Hierarchy](callhierarchy.md)

doc/callhierarchy.md

@@ -0,0 +1,57 @@
+# CallHierarchyOutgoingCall / CallHierrachyIncomingCall
+
+## Short introduction
+
+The response types to the `callHierarchy/outgoingCalls` and `callHierarchy/incomingCalls` LSP requests
+have been customized in order to distinguish dispatching calls from non-dispatching ones.
+
+
+## Change description
+
+   Here is the modified version of the `CallHierarchyIncomingCall` LSP type:
+
+   ```typescript
+   export interface CallHierarchyIncomingCall {
+
+     /**
+      * The item that makes the call.
+      */
+     from: CallHierarchyItem;
+
+     /**
+      * The ranges at which the calls appear. This is relative to the caller
+      * denoted by [`this.from`](#CallHierarchyIncomingCall.from).
+      */
+     fromRanges: Range[];
+
+     /**
+      * Used to know which call listed in `fromRanges` is dispatching or not.
+        The array length is equal to the `fromRanges` ones.
+      */
+     dispatching_calls?: Boolean[];
+   }
+   ```
+
+   Here is the modified version of the `CallHierarchyOutgoingCall` LSP type:
+
+   ```typescript
+   export interface CallHierarchyOutgoingCall {
+
+     /**
+      * The item that is called.
+      */
+     to: CallHierarchyItem;
+
+     /**
+      * The range at which this item is called. This is the range relative to
+      * the caller, e.g the item passed to `callHierarchy/outgoingCalls` request.
+      */
+     fromRanges: Range[];
+
+     /**
+      * Used to know which call listed in `fromRanges` is dispatching or not.
+        The array length is equal to the `fromRanges` ones.
+      */
+     dispatching_calls?: Boolean[];
+   }
+   ```