From 3d28155dfd1f8ac00ea5f36962130cb0e46df8cc Mon Sep 17 00:00:00 2001
From: Rob Lourens <roblourens@gmail.com>
Date: Sat, 25 Aug 2018 13:10:32 -0700
Subject: [PATCH] #57186 - add API comments

---
 src/vs/vscode.proposed.d.ts | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/src/vs/vscode.proposed.d.ts b/src/vs/vscode.proposed.d.ts
index 638695fb00c..eb07f1e7658 100644
--- a/src/vs/vscode.proposed.d.ts
+++ b/src/vs/vscode.proposed.d.ts
@@ -77,9 +77,23 @@ declare module 'vscode' {
 		followSymlinks: boolean;
 	}
 
+	/**
+	 * Options to specify the size of the result text preview.
+	 */
 	export interface TextSearchPreviewOptions {
+		/**
+		 * The maximum number of lines in the preview.
+		 */
 		maxLines: number;
+
+		/**
+		 * The maximum number of characters included before the start of the match.
+		 */
 		leadingChars: number;
+
+		/**
+		 * The maximum number of characters included per line.
+		 */
 		totalChars: number;
 	}
 
@@ -92,6 +106,9 @@ declare module 'vscode' {
 		 */
 		maxResults: number;
 
+		/**
+		 * Options to specify the size of the result text preview.
+		 */
 		previewOptions?: TextSearchPreviewOptions;
 
 		/**
@@ -131,6 +148,9 @@ declare module 'vscode' {
 	 */
 	export interface FileIndexOptions extends SearchOptions { }
 
+	/**
+	 * A preview of the text result.
+	 */
 	export interface TextSearchResultPreview {
 		/**
 		 * The matching line of text, or a portion of the matching line that contains the match.
@@ -159,7 +179,7 @@ declare module 'vscode' {
 		range: Range;
 
 		/**
-		 * A preview of the matching line
+		 * A preview of the text result.
 		 */
 		preview: TextSearchResultPreview;
 	}
@@ -261,6 +281,9 @@ declare module 'vscode' {
 		 */
 		encoding?: string;
 
+		/**
+		 * Options to specify the size of the result text preview.
+		 */
 		previewOptions?: TextSearchPreviewOptions;
 	}