common/locale/en-US/privacy.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
   3
   4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
   5
   6 <document
   7     name="privacy"
   8     title="&dactyl.appName; Privacy"
   9     xmlns="&xmlns.dactyl;"
  10     xmlns:html="&xmlns.html;">
  11
  12 <h1 tag="privacy">Privacy and sensitive information</h1>
  13 <toc start="2"/>
  14
  15 <p>
  16     Part of &dactyl.appName;'s user efficiency comes at the cost of storing a
  17     lot of potentially private data, including <t>command-line</t> history, page
  18     marks, visited page history, and the like. Because we know that keeping a
  19     detailed trail of all of your activities isn't always welcome,
  20     &dactyl.appName; provides comprehensive facilities for erasing potentially
  21     sensitive data.
  22 </p>
  23
  24 <h2 tag="private-mode porn-mode">Private browsing</h2>
  25
  26 <p>
  27     &dactyl.appName; fully supports &dactyl.host;'s private browsing mode.
  28     When in private browsing mode, no data other than Bookmarks and QuickMarks
  29     are written to disk. Further, upon exiting private mode, all newly
  30     accumulated data, including <t>command-line</t> history, local and URL
  31     marks, and macros, are purged from memory. For more information, see
  32     <o>private</o>.
  33 </p>
  34
  35 <h2 tag="sanitizing clearing-data">Clearing private data</h2>
  36
  37 <p>
  38     In addition to private mode, &dactyl.appName; provides a comprehensive
  39     facility for clearing any potentially sensitive data generated by either
  40     &dactyl.appName; or &dactyl.host;. It directly integrates with
  41     &dactyl.host;'s own sanitization facility, and so automatically clears any
  42     domain data and session history when requested. Further, &dactyl.appName;
  43     provides its own more granular sanitization facility, which allows, e.g.,
  44     clearing only the command-line and macro history for the past ten minutes.
  45 </p>
  46
  47 <item>
  48     <tags>:sa :sanitize</tags>
  49     <spec>:sa<oa>nitize</oa> <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa> <a>item</a> …</spec>
  50     <spec>:sa<oa>nitize</oa>! <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa></spec>
  51     <description>
  52         <p>
  53             Clear private data items for <a>timespan</a>, where <a>item</a> …
  54             is a list of private items to delete. If <oa>!</oa> is specified,
  55             then <o>sanitizeitems</o> is used for the list of items to delete.
  56             Items may be any of:
  57         </p>
  58
  59         <dl>
  60             <dt>all         </dt>       <dd>All items</dd>
  61             <dt>cache       </dt>       <dd>Cache</dd>
  62             <dt>commandline </dt>       <dd>Command-line history</dd>
  63             <dt>cookies     </dt>       <dd>Cookies</dd>
  64             <dt>downloads   </dt>       <dd>Download history</dd>
  65             <dt>formdata    </dt>       <dd>Saved form and search history</dd>
  66             <dt>history     </dt>       <dd>Browsing history</dd>
  67             <dt>host        </dt>       <dd>All data from the given host</dd>
  68             <dt>marks       </dt>       <dd>Local and URL marks</dd>
  69             <dt>macros      </dt>       <dd>Saved macros</dd>
  70             <dt>messages    </dt>       <dd>Saved <ex>:messages</ex></dd>
  71             <dt>offlineapps </dt>       <dd>Offline website data</dd>
  72             <dt>options     </dt>       <dd>Options containing hostname data</dd>
  73             <dt>passwords   </dt>       <dd>Saved passwords</dd>
  74             <dt>sessions    </dt>       <dd>Authenticated sessions</dd>
  75             <dt>sitesettings</dt>       <dd>Site preferences</dd>
  76         </dl>
  77
  78         <p>
  79             When <em>history</em> items are sanitized, all command-line
  80             history items containing URLs or page titles (other than bookmark
  81             commands) are additionally cleared. Invocations of the
  82             <em>:sanitize</em> command are included in this set.
  83         </p>
  84
  85         <p>
  86             If <a>timespan</a> (short name <em>-t</em>) is specified, only
  87             items within that timespan are deleted, otherwise the value of
  88             <o>sanitizetimespan</o> is used.  If <oa>-older</oa> (short name
  89             <em>-o</em>) is specified, then only items older than
  90             <a>timespan</a> are deleted.
  91         </p>
  92
  93         <note>
  94             The following items are always cleared entirely, regardless of
  95             <a>timespan</a>: <em>cache</em>, <em>host</em>, <em>offlineapps</em>,
  96             <em>passwords</em>, <em>sessions</em>, <em>sitesettings</em>.
  97             Conversely, <em>host</em> and <em>options</em> are never cleared
  98             unless a host is specified.
  99         </note>
 100
 101         <p>
 102             If <a>host</a> (short name <em>-h</em>) is specified, only items
 103             containing a reference to that domain or a subdomain thereof are
 104             cleared. Moreover, if either of <em>commandline</em> or
 105             <em>history</em> is specified, the invocation of the
 106             <em>:sanitize</em> command is naturally cleared as well.
 107         </p>
 108
 109         <note>
 110             This only applies to <em>commandline</em>, <em>cookies</em>,
 111             <em>history</em>, <em>marks</em>, <em>messages</em>,
 112             <em>options</em>, and <em>sitesettings</em>. All other
 113             domain-specific data is cleared only along with <em>host</em>,
 114             when a request is made to &dactyl.host; to purge all data for
 115             <a>host</a>. Included in this purge are all matching history
 116             entries, cookies, closed tabs, form data, and location bar
 117             entries.
 118         </note>
 119     </description>
 120 </item>
 121
 122 <h2 tag="cookie-settings">Cookie settings</h2>
 123 <item>
 124     <tags>:cookies :ck</tags>
 125     <spec>:cookies <a>host</a> <oa>action</oa> …</spec>
 126     <description>
 127         <p>
 128             Manage cookies for <a>host</a>. Additionally, the completion
 129             list will show you information about the cookies and
 130             permissions for the current page.
 131         </p>
 132
 133         <p>Available actions:</p>
 134
 135         <dl dt="width: 12em">
 136             <dt>unset</dt>            <dd>Unset special permissions for <a>host</a></dd>
 137             <dt>allow</dt>            <dd>Allow cookies from <a>host</a></dd>
 138             <dt>deny</dt>             <dd>Deny cookies from <a>host</a></dd>
 139             <dt>session</dt>          <dd>Allow cookies from <a>host</a> for the current session</dd>
 140             <dt>list</dt>             <dd>List all cookies for <a>host</a></dd>
 141             <dt>clear</dt>            <dd>Clear all cookies for <a>host</a></dd>
 142             <dt>clear-persistent</dt> <dd>Clear all persistent cookies for <a>host</a></dd>
 143             <dt>clear-session</dt>    <dd>Clear all session cookies for <a>host</a></dd>
 144         </dl>
 145
 146         <p>
 147             If no <oa>action</oa> is given, the value of <o>cookies</o> is used.
 148         </p>
 149
 150         <example><ex>:map -b</ex> <k link="false">c</k> <ex>:cookies</ex> <k name="A-Tab" link="false"/></example>
 151     </description>
 152 </item>
 153
 154 </document>
 155
 156 <!-- vim:se sts=4 sw=4 et: -->