and more jsdoc, #70231

src/vs/vscode.proposed.d.ts

@@ -135,7 +135,7 @@ declare module 'vscode' {
 
 		/**
 		 * Provide all incoming calls for an item, e.g all callers for a method. In graph terms this descibes directed
-		 * and annotated edges inside the call graph, e.g the given item is the starting node and the result are the nodes
+		 * and annotated edges inside the call graph, e.g the given item is the starting node and the result is the nodes
 		 * that can be reached.
 		 *
 		 * @param item The hierarchy item for which incoming calls should be computed.
@@ -148,7 +148,7 @@ declare module 'vscode' {
 		/**
 		 * Provide all outgoing calls for an item, e.g call calls to functions, methods, or constructors from the given item. In
 		 * graph terms this descibes directed and annotated edges inside the call graph, e.g the given item is the starting
-		 * node and the result are the nodes that can be reached.
+		 * node and the result is the nodes that can be reached.
 		 *
 		 * @param item The hierarchy item for which outgoing calls should be computed.
 		 * @param token A cancellation token.
@@ -159,6 +159,14 @@ declare module 'vscode' {
 	}
 
 	export namespace languages {
+
+		/**
+		 * Register a call hierarchy provider.
+		 *
+		 * @param selector A selector that defines the documents this provider is applicable to.
+		 * @param provider A call hierarchy provider.
+		 * @return A [disposable](#Disposable) that unregisters this provider when being disposed.
+		 */
 		export function registerCallHierarchyProvider(selector: DocumentSelector, provider: CallHierarchyProvider): Disposable;
 	}