Index: chrome/common/extensions/docs/experimental.processes.html |
diff --git a/chrome/common/extensions/docs/experimental.processes.html b/chrome/common/extensions/docs/experimental.processes.html |
index d334cc6c71eb12fda44c1c9dbd22d10e4bdc26ee..394d3ecd4f31310af6ea585c33477647c1cd54e2 100644 |
--- a/chrome/common/extensions/docs/experimental.processes.html |
+++ b/chrome/common/extensions/docs/experimental.processes.html |
@@ -288,9 +288,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The ID of the tab for which the renderer process ID is to be returned.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -397,9 +395,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The list of process IDs or single process ID for which to return the process information. An empty list indicates all processes are requested.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -422,9 +418,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>True if detailed memory usage is required. Note, collecting memory usage information incurs extra CPU usage and should only be queried for when needed.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -447,9 +441,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>Called when the processes information is collected.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -488,9 +480,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>A dictionary of Process objects for each requested process that is a live child process of the current browser process, indexed by process ID. Metrics requiring aggregation over time will not be populated in each Process object.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -532,9 +522,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The ID of the process to be terminated.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -599,7 +587,7 @@ |
</div> |
</em> |
</dt> |
- <dd>True if the process was successfully killed.</dd> |
+ <dd>True if terminating the process was successful, otherwise false.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -623,7 +611,7 @@ |
<h4>onCreated</h4> |
<div class="summary"> |
<!-- Note: intentionally longer 80 columns --> |
- <span class="subdued">chrome.experimental.processes.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>integer processId, Process process</span>) <span class="subdued">{...}</span><span></span>); |
+ <span class="subdued">chrome.experimental.processes.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>Process process</span>) <span class="subdued">{...}</span><span></span>); |
</div> |
<div class="description"> |
<p>Fired each time a process is created, providing the corrseponding Process object.</p> |
@@ -634,31 +622,6 @@ |
<div> |
<div> |
<dt> |
- <var>processId</var> |
- <em> |
- <!-- TYPE --> |
- <div style="display:inline"> |
- ( |
- <span id="typeTemplate"> |
- <span> |
- <span>integer</span> |
- </span> |
- </span> |
- ) |
- </div> |
- </em> |
- </dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
- <!-- OBJECT PROPERTIES --> |
- <!-- OBJECT METHODS --> |
- <!-- OBJECT EVENT FIELDS --> |
- <!-- FUNCTION PARAMETERS --> |
- </div> |
- </div><div> |
- <div> |
- <dt> |
<var>process</var> |
<em> |
<!-- TYPE --> |
@@ -673,9 +636,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>Details of the process that was created. Metrics requiring aggregation over time will not be populated in the object.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -689,6 +650,7 @@ |
<dl> |
</dl> |
</div> <!-- /description --> |
+ <!-- /description --> |
</div><div class="apiItem"> |
<a name="event-onExited"></a> |
<h4>onExited</h4> |
@@ -719,9 +681,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The ID of the process that exited.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -744,9 +704,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The type of exit that occurred for the process - normal, abnormal, killed, crashed. Only available for renderer processes.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -769,9 +727,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>The exit code if the process exited abnormally. Only available for renderer processes.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -785,6 +741,7 @@ |
<dl> |
</dl> |
</div> <!-- /description --> |
+ <!-- /description --> |
</div><div class="apiItem"> |
<a name="event-onUnresponsive"></a> |
<h4>onUnresponsive</h4> |
@@ -815,9 +772,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>Details of the unresponsive process. Metrics requiring aggregation over time will not be populated in the object. Only available for renderer processes.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -831,6 +786,7 @@ |
<dl> |
</dl> |
</div> <!-- /description --> |
+ <!-- /description --> |
</div><div class="apiItem"> |
<a name="event-onUpdated"></a> |
<h4>onUpdated</h4> |
@@ -861,9 +817,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>A dictionary of updated Process objects for each live process in the browser, indexed by process ID. Metrics requiring aggregation over time will be populated in each Process object.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -877,6 +831,7 @@ |
<dl> |
</dl> |
</div> <!-- /description --> |
+ <!-- /description --> |
</div><div class="apiItem"> |
<a name="event-onUpdatedWithMemory"></a> |
<h4>onUpdatedWithMemory</h4> |
@@ -907,9 +862,7 @@ |
</div> |
</em> |
</dt> |
- <dd class="todo"> |
- Undocumented. |
- </dd> |
+ <dd>A dictionary of updated Process objects for each live process in the browser, indexed by process ID. Memory usage details will be included in each Process object.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -923,6 +876,7 @@ |
<dl> |
</dl> |
</div> <!-- /description --> |
+ <!-- /description --> |
</div> <!-- /apiItem --> |
</div> <!-- /apiGroup --> |
<!-- TYPES --> |
@@ -969,7 +923,7 @@ |
</div> |
</em> |
</dt> |
- <dd>Unique ID of the process provided by Chrome.</dd> |
+ <dd>Unique ID of the process provided by the browser.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1069,7 +1023,7 @@ |
</div> |
</em> |
</dt> |
- <dd>Array of Tab IDs that have a page rendered by this process (for renderer processes only).</dd> |
+ <dd>Array of Tab IDs that have a page rendered by this process. The list will be non-empty for renderer processes only.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1093,7 +1047,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process CPU usage, between 0 and 100%.</dd> |
+ <dd>The most recent measurement of the process CPU usage, between 0 and 100%. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1117,7 +1071,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process network usage, in bytes per second.</dd> |
+ <dd>The most recent measurement of the process network usage, in bytes per second. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1141,31 +1095,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process private memory usage, in bytes.</dd> |
- <!-- OBJECT PROPERTIES --> |
- <!-- OBJECT METHODS --> |
- <!-- OBJECT EVENT FIELDS --> |
- <!-- FUNCTION PARAMETERS --> |
- </div> |
- </div><div> |
- <div> |
- <dt> |
- <var>memoryUsage</var> |
- <em> |
- <!-- TYPE --> |
- <div style="display:inline"> |
- ( |
- <span class="optional">optional</span> |
- <span id="typeTemplate"> |
- <span> |
- <a>MemoryUsage</a> |
- </span> |
- </span> |
- ) |
- </div> |
- </em> |
- </dt> |
- <dd>Object containing the most recent details about process memory usage, in bytes.</dd> |
+ <dd>The most recent measurement of the process private memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdatedWithMemory or getProcessInfo with the includeMemory flag.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1189,7 +1119,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process JavaScript allocated memory, in bytes.</dd> |
+ <dd>The most recent measurement of the process JavaScript allocated memory, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1213,7 +1143,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process JavaScript memory used, in bytes.</dd> |
+ <dd>The most recent measurement of the process JavaScript memory used, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1237,7 +1167,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process’s SQLite memory usage, in bytes.</dd> |
+ <dd>The most recent measurement of the process’s SQLite memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1261,7 +1191,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent measurement of the process frames per second.</dd> |
+ <dd>The most recent measurement of the process frames per second. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1285,7 +1215,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent information about the image cache for the process.</dd> |
+ <dd>The most recent information about the image cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1309,7 +1239,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent information about the script cache for the process.</dd> |
+ <dd>The most recent information about the script cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1333,7 +1263,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The most recent information about the CSS cache for the process.</dd> |
+ <dd>The most recent information about the CSS cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd> |
<!-- OBJECT PROPERTIES --> |
<!-- OBJECT METHODS --> |
<!-- OBJECT EVENT FIELDS --> |
@@ -1364,7 +1294,7 @@ |
</div> |
</em> |
</dt> |
- <dd>The Cache object contains information about the size and utilization of a cache used by Chromium.</dd> |
+ <dd>The Cache object contains information about the size and utilization of a cache used by the browser.</dd> |
<!-- OBJECT PROPERTIES --> |
<dd> |
<dl> |