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