From 96f50990c8a1b0a81673ec4625ddb49bfda63696 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20H=C3=B8is=C3=A6ther=20Rasch?=
 <fredrik.h.rasch@uit.no>
Date: Mon, 21 Sep 2015 12:13:22 +0200
Subject: [PATCH] Added/Updated proxy /w docs

---
 chrome/chrome.d.ts | 40 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/chrome/chrome.d.ts b/chrome/chrome.d.ts
index 209322f2d9..63e891d6a7 100755
--- a/chrome/chrome.d.ts
+++ b/chrome/chrome.d.ts
@@ -5213,45 +5213,83 @@ declare module chrome.privacy {
 ////////////////////
 // Proxy
 ////////////////////
+/**
+ * Use the chrome.proxy API to manage Chrome's proxy settings. This API relies on the ChromeSetting prototype of the type API for getting and setting the proxy configuration.
+ * Permissions:  "proxy"   
+ * @since Chrome 13.
+ */
 declare module chrome.proxy {
+    /** An object holding proxy auto-config information. Exactly one of the fields should be non-empty. */
 	interface PacScript {
+        /** Optional. URL of the PAC file to be used. */
 		url?: string;
+        /** Optional. If true, an invalid PAC script will prevent the network stack from falling back to direct connections. Defaults to false. */
 		mandatory?: boolean;
+        /** Optional. A PAC script. */
 		data?: string;
 	}
 
+    /** An object encapsulating a complete proxy configuration. */
 	interface ProxyConfig {
+        /** Optional. The proxy rules describing this configuration. Use this for 'fixed_servers' mode. */
 		rules?: ProxyRules;
+        /** Optional. The proxy auto-config (PAC) script for this configuration. Use this for 'pac_script' mode. */
 		pacScript?: PacScript;
+        /** 
+         * 'direct' = Never use a proxy
+         * 'auto_detect' = Auto detect proxy settings
+         * 'pac_script' = Use specified PAC script
+         * 'fixed_servers' = Manually specify proxy servers
+         * 'system' = Use system proxy settings 
+         */
 		mode: string;
 	}
 
+    /** An object encapsulating a single proxy server's specification. */
 	interface ProxyServer {
+        /** The URI of the proxy server. This must be an ASCII hostname (in Punycode format). IDNA is not supported, yet. */
 		host: string;
+        /** Optional. The scheme (protocol) of the proxy server itself. Defaults to 'http'. */
 		scheme?: string;
+        /** Optional. The port of the proxy server. Defaults to a port that depends on the scheme. */
 		port?: number;
 	}
 
+    /** An object encapsulating the set of proxy rules for all protocols. Use either 'singleProxy' or (a subset of) 'proxyForHttp', 'proxyForHttps', 'proxyForFtp' and 'fallbackProxy'. */
 	interface ProxyRules {
+        /** Optional. The proxy server to be used for FTP requests. */
 		proxyForFtp?: ProxyServer;
+        /** Optional. The proxy server to be used for HTTP requests. */
 		proxyForHttp?: ProxyServer;
-		facllbackProxy?: ProxyServer;
+        /** Optional. The proxy server to be used for everthing else or if any of the specific proxyFor... is not specified. */
+		fallbackProxy?: ProxyServer;
+        /** Optional. The proxy server to be used for all per-URL requests (that is http, https, and ftp). */
 		singleProxy?: ProxyServer;
+        /** Optional. The proxy server to be used for HTTPS requests. */
 		proxyForHttps?: ProxyServer;
+        /** Optional. List of servers to connect to without a proxy server. */
 		bypassList?: string[];
 	}
 
 	interface ErrorDetails {
+        /** Additional details about the error such as a JavaScript runtime error. */
 		details: string;
+        /** The error description. */
 		error: string;
+        /** If true, the error was fatal and the network transaction was aborted. Otherwise, a direct connection is used instead. */
 		fatal: boolean;
 	}
 
 	interface ProxyErrorEvent extends chrome.events.Event {
+        /**
+         * @param callback The callback parameter should be a function that looks like this: 
+         * function(object details) {...}; 
+         */
 		addListener(callback: (details: ErrorDetails) => void): void;
 	}
 
 	var settings: chrome.types.ChromeSetting;
+    /** Notifies about proxy errors. */
 	var onProxyError: ProxyErrorEvent;
 }