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 tag="sanitize-items"/>
  60
  61         <p>
  62             Items may be excluded by prefixing them with a <tt>!</tt>. The first
  63             matching item takes precedence. Therefore, the value
  64             <tt>!commandline all</tt> will sanitize all items but the command
  65             line. A value of <tt>all !commandline</tt> will sanitize all items.
  66         </p>
  67
  68         <p>
  69             When <em>history</em> items are sanitized, all command-line
  70             history items containing URLs or page titles (other than bookmark
  71             commands) are additionally cleared. Invocations of the
  72             <em>:sanitize</em> command are included in this set.
  73         </p>
  74
  75         <p>
  76             If <a>timespan</a> (short name <em>-t</em>) is specified, only
  77             items within that timespan are deleted, otherwise the value of
  78             <o>sanitizetimespan</o> is used.  If <oa>-older</oa> (short name
  79             <em>-o</em>) is specified, then only items older than
  80             <a>timespan</a> are deleted.
  81         </p>
  82
  83         <note>
  84             The following items are always cleared entirely, regardless of
  85             <a>timespan</a>: <em>cache</em>, <em>host</em>, <em>offlineapps</em>,
  86             <em>passwords</em>, <em>sessions</em>, <em>sitesettings</em>.
  87             Conversely, <em>host</em> and <em>options</em> are never cleared
  88             unless a host is specified.
  89         </note>
  90
  91         <p>
  92             If <a>host</a> (short name <em>-h</em>) is specified, only items
  93             containing a reference to that domain or a subdomain thereof are
  94             cleared. Moreover, if either of <em>commandline</em> or
  95             <em>history</em> is specified, the invocation of the
  96             <em>:sanitize</em> command is naturally cleared as well.
  97         </p>
  98
  99         <note>
 100             This only applies to <em>commandline</em>, <em>cookies</em>,
 101             <em>history</em>, <em>marks</em>, <em>messages</em>,
 102             <em>options</em>, and <em>sitesettings</em>. All other
 103             domain-specific data is cleared only along with <em>host</em>,
 104             when a request is made to &dactyl.host; to purge all data for
 105             <a>host</a>. Included in this purge are all matching history
 106             entries, cookies, closed tabs, form data, and location bar
 107             entries.
 108         </note>
 109     </description>
 110 </item>
 111
 112 <item>
 113     <tags>:private :pr</tags>
 114     <tags>:pr0n :porn</tags>
 115     <strut/>
 116     <spec>:pr<oa>ivate</oa> <a>cmd</a></spec>
 117     <description>
 118         <p>
 119             Execute <a>cmd</a> with privacy features enabled, and
 120             do not save the invocation in command history.
 121         </p>
 122     </description>
 123 </item>
 124
 125 <h2 tag="cookie-settings">Cookie settings</h2>
 126 <item>
 127     <tags>:cookies :ck</tags>
 128     <spec>:cookies <a>host</a> <oa>action</oa> …</spec>
 129     <description>
 130         <p>
 131             Manage cookies for <a>host</a>. Additionally, the completion
 132             list will show you information about the cookies and
 133             permissions for the current page.
 134         </p>
 135
 136         <p>Available actions:</p>
 137
 138         <dl dt="width: 12em">
 139             <dt>unset</dt>            <dd>Unset special permissions for <a>host</a></dd>
 140             <dt>allow</dt>            <dd>Allow cookies from <a>host</a></dd>
 141             <dt>deny</dt>             <dd>Deny cookies from <a>host</a></dd>
 142             <dt>session</dt>          <dd>Allow cookies from <a>host</a> for the current session</dd>
 143             <dt>list</dt>             <dd>List all cookies for <a>host</a></dd>
 144             <dt>clear</dt>            <dd>Clear all cookies for <a>host</a></dd>
 145             <dt>clear-persistent</dt> <dd>Clear all persistent cookies for <a>host</a></dd>
 146             <dt>clear-session</dt>    <dd>Clear all session cookies for <a>host</a></dd>
 147         </dl>
 148
 149         <p>
 150             If no <oa>action</oa> is given, the value of <o>cookies</o> is used.
 151         </p>
 152
 153         <example><ex>:map -b</ex> <k link="false">c</k> <ex>:cookies</ex> <k name="A-Tab" link="c_&lt;Tab>"/></example>
 154     </description>
 155 </item>
 156
 157 </document>
 158
 159 <!-- vim:se sts=4 sw=4 et: -->