mirror of
https://github.com/gryf/pentadactyl-pm.git
synced 2026-02-17 08:55:46 +01:00
Complete :sanitize and private mode overhaul.
--HG-- rename : common/content/sanitizer.js => common/modules/sanitizer.jsm
This commit is contained in:
Kris Maglione
@@ -1023,29 +1023,12 @@
|
||||
<tags>'si' 'sanitizeitems'</tags>
|
||||
<spec>'sanitizeitems' 'si'</spec>
|
||||
<type>stringlist</type>
|
||||
<default>cache,commandline,cookies,formdata,history,marks,sessions</default>
|
||||
<default>all</default>
|
||||
<description>
|
||||
<p>The default list of private items to sanitize.</p>
|
||||
|
||||
<dl>
|
||||
<dt>cache </dt> <dd>Cache</dd>
|
||||
<dt>commandline </dt> <dd>Command-line history</dd>
|
||||
<dt>cookies </dt> <dd>Cookies</dd>
|
||||
<dt>downloads </dt> <dd>Download history</dd>
|
||||
<dt>formdata </dt> <dd>Saved form and search history</dd>
|
||||
<dt>history </dt> <dd>Browsing history</dd>
|
||||
<dt>marks </dt> <dd>Local and URL marks</dd>
|
||||
<dt>macros </dt> <dd>Saved macros</dd>
|
||||
<dt>offlineapps </dt> <dd>Offline website data</dd>
|
||||
<dt>passwords </dt> <dd>Saved passwords</dd>
|
||||
<dt>sessions </dt> <dd>Authenticated sessions</dd>
|
||||
<dt>sitesettings</dt> <dd>Site preferences</dd>
|
||||
</dl>
|
||||
|
||||
<p>
|
||||
When history items are sanitized <ex>:open</ex>,
|
||||
<ex>:tabopen</ex> and <ex>:winopen</ex> command-line
|
||||
history entries are also removed.
|
||||
The default list of private items to sanitize. See
|
||||
<ex>:sanitize</ex> for a list and explanation of
|
||||
possible values.
|
||||
</p>
|
||||
</description>
|
||||
</item>
|
||||
@@ -1055,21 +1038,20 @@
|
||||
<tags>'sts' 'sanitizetimespan'</tags>
|
||||
<spec>'sanitizetimespan' 'sts'</spec>
|
||||
<type>number</type>
|
||||
<default>1</default>
|
||||
<default>all</default>
|
||||
<description>
|
||||
<p>
|
||||
The default sanitizer time span. Only items created within this timespan are
|
||||
deleted.
|
||||
deleted. The value must be of the one of the forms,
|
||||
</p>
|
||||
|
||||
<note>This only applies to <em>cookies</em>, <em>history</em>, <em>formdata</em>, and <em>downloads</em>.</note>
|
||||
|
||||
<dl>
|
||||
<dt>0</dt> <dd>Everything</dd>
|
||||
<dt>1</dt> <dd>Last hour</dd>
|
||||
<dt>2</dt> <dd>Last two hours</dd>
|
||||
<dt>3</dt> <dd>Last four hours</dd>
|
||||
<dt>4</dt> <dd>Today</dd>
|
||||
<dt>all</dt> <dd>Everything</dd>
|
||||
<dt>session</dt> <dd>The current session</dd>
|
||||
<dt><a>n</a>m</dt> <dd>Past <a>n</a> Minutes</dd>
|
||||
<dt><a>n</a>h</dt> <dd>Past <a>n</a> Hours</dd>
|
||||
<dt><a>n</a>d</dt> <dd>Past <a>n</a> Days</dd>
|
||||
<dt><a>n</a>w</dt> <dd>Past <a>n</a> Weeks</dd>
|
||||
</dl>
|
||||
</description>
|
||||
</item>
|
||||
|
||||
@@ -94,29 +94,6 @@
|
||||
</item>
|
||||
|
||||
|
||||
<item>
|
||||
<tags>:sa :sanitize</tags>
|
||||
<spec>:sa<oa>nitize</oa> [-timespan=<a>timespan</a>] <a>item</a> …</spec>
|
||||
<spec>:sa<oa>nitize</oa>! [-timespan=<a>timespan</a>]</spec>
|
||||
<description>
|
||||
<p>
|
||||
Clear private data items. Where <a>item</a> … is a list of private items to
|
||||
delete. These may be any of the items valid for <o>sanitizeitems</o>.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
If <oa>!</oa> is specified then <o>sanitizeitems</o> is used for the list of items to
|
||||
delete.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
If <a>timespan</a> is specified then only items within that timespan are deleted,
|
||||
otherwise the value of <o>sanitizetimespan</o> is used.
|
||||
</p>
|
||||
</description>
|
||||
</item>
|
||||
|
||||
|
||||
<item>
|
||||
<tags>:sil :silent</tags>
|
||||
<spec>:sil<oa>ent</oa> <a>command</a></spec>
|
||||
@@ -153,6 +130,109 @@
|
||||
</description>
|
||||
</item>
|
||||
|
||||
<h2 tag="privacy">Privacy and sensitive information</h2>
|
||||
|
||||
<p>
|
||||
Part of &dactyl.appname;'s user efficiency comes at the cost of storing a
|
||||
lot of potentially private data, including command-line history, page
|
||||
marks, and the like. Because we know that keeping a detailed trail of all
|
||||
of your activities isn't always welcome, &dactyl.appname; provides
|
||||
comprehensive facilities for erasing potentially sensitive data.
|
||||
</p>
|
||||
|
||||
<p tag="private-mode porn-mode">
|
||||
<strut/>
|
||||
&dactyl.appname; fully supports &dactyl.host;'s private browsing mode.
|
||||
When in private browsing mode, no other than Bookmarks and QuickMarks are
|
||||
written to disk. Further, upon exiting private mode, all new data,
|
||||
including command-line history, local and URL marks, and macros, are
|
||||
purged. For more information, see <o>private</o>.
|
||||
</p>
|
||||
|
||||
<p tag="sanitizing clearing-data">
|
||||
<strut/>
|
||||
In addition to private mode, &dactyl.appname; provides a comprehensive
|
||||
facility for clearing any potentially sensitive data generated by either
|
||||
&dactyl.appname; or &dactyl.host;. It directly integrates with
|
||||
&dactyl.host;'s own sanitization facility, and so automatically clears any
|
||||
domain data and session history when requested. Further, &dactyl.appname;
|
||||
provides its own more granular sanitization facility, which allows, e.g.,
|
||||
clearing the command-line and macro history for the past ten minutes.
|
||||
</p>
|
||||
|
||||
<item>
|
||||
<tags>:sa :sanitize</tags>
|
||||
<spec>:sa<oa>nitize</oa> <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa> <a>item</a> …</spec>
|
||||
<spec>:sa<oa>nitize</oa>! <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa></spec>
|
||||
<description>
|
||||
<p>
|
||||
Clear private data items for <a>timespan</a>, where <a>item</a> …
|
||||
is a list of private items to delete. If <oa>!</oa> is specified
|
||||
then <o>sanitizeitems</o> is used for the list of items to delete.
|
||||
Items may be any of:
|
||||
</p>
|
||||
|
||||
<dl>
|
||||
<dt>all </dt> <dd>All items</dd>
|
||||
<dt>cache </dt> <dd>Cache</dd>
|
||||
<dt>commandline </dt> <dd>Command-line history</dd>
|
||||
<dt>cookies </dt> <dd>Cookies</dd>
|
||||
<dt>downloads </dt> <dd>Download history</dd>
|
||||
<dt>formdata </dt> <dd>Saved form and search history</dd>
|
||||
<dt>history </dt> <dd>Browsing history</dd>
|
||||
<dt>marks </dt> <dd>Local and URL marks</dd>
|
||||
<dt>macros </dt> <dd>Saved macros</dd>
|
||||
<dt>messages </dt> <dd>Saved <ex>:messages</ex></dd>
|
||||
<dt>offlineapps </dt> <dd>Offline website data</dd>
|
||||
<dt>options </dt> <dd>Options containing hostname data</dd>
|
||||
<dt>passwords </dt> <dd>Saved passwords</dd>
|
||||
<dt>sessions </dt> <dd>Authenticated sessions</dd>
|
||||
<dt>sitesettings</dt> <dd>Site preferences</dd>
|
||||
</dl>
|
||||
|
||||
<p>
|
||||
When <em>history</em> items are sanitized, all command-line
|
||||
history items containing URLs or page titles (other than bookmark
|
||||
commands) are additionally cleared. Invocations of the
|
||||
<em>:sanitize</em> command are included in this set.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
If <a>timespan</a> (short name <em>-t</em>) is specified then only
|
||||
items within that timespan are deleted, otherwise the value of
|
||||
<o>sanitizetimespan</o> is used. If <oa>-older</oa> (short name
|
||||
<em>-o</em>) is specified, than only items older than
|
||||
<a>timespan</a> are deleted.
|
||||
</p>
|
||||
|
||||
<note>
|
||||
The following items are cleared regardless of <a>timeframe</a>:
|
||||
<em>cache</em>, <em>offlineapps</em>, <em>passwords</em>,
|
||||
<em>sessions</em>, <em>sitesettings</em>. Additionally,
|
||||
<em>options</em> are never cleared.
|
||||
</note>
|
||||
|
||||
<p>
|
||||
If <a>host</a> (short name <em>-h</em>) is specified, only items
|
||||
containing a reference to that domain or a subdomain thereof are
|
||||
cleared. Moreover, if <em>commandline</em> or <em>history</em> is
|
||||
specified, the invocation of the <em>:sanitize</em> command is
|
||||
naturally cleared as well.
|
||||
</p>
|
||||
|
||||
<note>
|
||||
This only applies to <em>commandline</em>, <em>cookies</em>,
|
||||
<em>history</em>, <em>marks</em>, <em>messages</em>,
|
||||
<em>options</em>, and <em>sitesettings</em>. All other
|
||||
domain-specific data is cleared only along with <em>history</em>,
|
||||
when a request is made to &dactyl.host; to purge all data for
|
||||
<em>host</em>. Included in this purge are all matchint history
|
||||
entries, cookies, closed tabs, form data, and location bar
|
||||
entries.
|
||||
</note>
|
||||
</description>
|
||||
</item>
|
||||
|
||||
|
||||
<h2 tag="online-help">Online help</h2>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user