diff --git a/common/locale/en-US/all.xml b/common/locale/en-US/all.xml index f998934a..5a9b1395 100644 --- a/common/locale/en-US/all.xml +++ b/common/locale/en-US/all.xml @@ -31,6 +31,7 @@ + diff --git a/common/locale/en-US/privacy.xml b/common/locale/en-US/privacy.xml new file mode 100644 index 00000000..66092de2 --- /dev/null +++ b/common/locale/en-US/privacy.xml @@ -0,0 +1,156 @@ + + + + + + + +

Privacy and sensitive information

+ + +

+ 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, visited page history, 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. +

+ +

Private mode browsing

+ +

+ &dactyl.appName; fully supports &dactyl.host;'s private browsing mode. + When in private browsing mode, no data other than Bookmarks and QuickMarks + are written to disk. Further, upon exiting private mode, all newly + accumulated data, including command-line history, local and URL + marks, and macros, are purged from memory. For more information, see + private. +

+ +

Clearing private data

+ +

+ 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 only the command-line and macro history for the past ten minutes. +

+ + + :sa :sanitize + :sanitize -host=host -older -timespan=timespan item + :sanitize! -host=host -older -timespan=timespan + +

+ Clear private data items for timespan, where item … + is a list of private items to delete. If ! is specified, + then sanitizeitems is used for the list of items to delete. + Items may be any of: +

+ +
+
all
All items
+
cache
Cache
+
commandline
Command-line history
+
cookies
Cookies
+
downloads
Download history
+
formdata
Saved form and search history
+
history
Browsing history
+
host
All data from the given host
+
marks
Local and URL marks
+
macros
Saved macros
+
messages
Saved :messages
+
offlineapps
Offline website data
+
options
Options containing hostname data
+
passwords
Saved passwords
+
sessions
Authenticated sessions
+
sitesettings
Site preferences
+
+ +

+ When history items are sanitized, all command-line + history items containing URLs or page titles (other than bookmark + commands) are additionally cleared. Invocations of the + :sanitize command are included in this set. +

+ +

+ If timespan (short name -t) is specified, only + items within that timespan are deleted, otherwise the value of + sanitizetimespan is used. If -older (short name + -o) is specified, then only items older than + timespan are deleted. +

+ + + The following items are always cleared entirely, regardless of + timeframe: cache, host, offlineapps, + passwords, sessions, sitesettings. + Conversely, host and options are never cleared + unless a host is specified. + + +

+ If host (short name -h) is specified, only items + containing a reference to that domain or a subdomain thereof are + cleared. Moreover, if either of commandline or + history is specified, the invocation of the + :sanitize command is naturally cleared as well. +

+ + + This only applies to commandline, cookies, + history, marks, messages, + options, and sitesettings. All other + domain-specific data is cleared only along with host, + when a request is made to &dactyl.host; to purge all data for + host. Included in this purge are all matching history + entries, cookies, closed tabs, form data, and location bar + entries. + +
+
+ +

Cookie settings

+ + :cookies :ck + :cookies host action + +

+ Manage cookies for host. Additionally, the completion + list will show you information about the cookies and + permissions for the current page. +

+ +

Available actions:

+ +
+
unset
Unset special permissions for host
+
allow
Allow cookies from host
+
deny
Deny cookies from host
+
session
Allow cookies from host for the current session
+
list
List all cookies for host
+
clear
Clear all cookies for host
+
clear-persistent
Clear all persistent cookies for host
+
clear-session
Clear all session cookies for host
+
+ +

+ If no action is given, the value of cookies is used. +

+ + :map -b c :cookies +
+
+ +
+ + diff --git a/common/locale/en-US/various.xml b/common/locale/en-US/various.xml index d79df173..46814699 100644 --- a/common/locale/en-US/various.xml +++ b/common/locale/en-US/various.xml @@ -152,143 +152,6 @@ -

Privacy and sensitive information

- -

- 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, visited page history, 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. -

- -

- &dactyl.appName; fully supports &dactyl.host;'s private browsing mode. - When in private browsing mode, no data other than Bookmarks and QuickMarks - are written to disk. Further, upon exiting private mode, all newly - accumulated data, including command-line history, local and URL - marks, and macros, are purged from memory. For more information, see - private. -

- -

- 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 only the command-line and macro history for the past ten minutes. -

- - - :sa :sanitize - :sanitize -host=host -older -timespan=timespan item - :sanitize! -host=host -older -timespan=timespan - -

- Clear private data items for timespan, where item … - is a list of private items to delete. If ! is specified, - then sanitizeitems is used for the list of items to delete. - Items may be any of: -

- -
-
all
All items
-
cache
Cache
-
commandline
Command-line history
-
cookies
Cookies
-
downloads
Download history
-
formdata
Saved form and search history
-
history
Browsing history
-
host
All data from the given host
-
marks
Local and URL marks
-
macros
Saved macros
-
messages
Saved :messages
-
offlineapps
Offline website data
-
options
Options containing hostname data
-
passwords
Saved passwords
-
sessions
Authenticated sessions
-
sitesettings
Site preferences
-
- -

- When history items are sanitized, all command-line - history items containing URLs or page titles (other than bookmark - commands) are additionally cleared. Invocations of the - :sanitize command are included in this set. -

- -

- If timespan (short name -t) is specified, only - items within that timespan are deleted, otherwise the value of - sanitizetimespan is used. If -older (short name - -o) is specified, then only items older than - timespan are deleted. -

- - - The following items are always cleared entirely, regardless of - timeframe: cache, host, offlineapps, - passwords, sessions, sitesettings. - Conversely, host and options are never cleared - unless a host is specified. - - -

- If host (short name -h) is specified, only items - containing a reference to that domain or a subdomain thereof are - cleared. Moreover, if either of commandline or - history is specified, the invocation of the - :sanitize command is naturally cleared as well. -

- - - This only applies to commandline, cookies, - history, marks, messages, - options, and sitesettings. All other - domain-specific data is cleared only along with host, - when a request is made to &dactyl.host; to purge all data for - host. Included in this purge are all matching history - entries, cookies, closed tabs, form data, and location bar - entries. - -
-
- -

Cookie Settings

- - :cookies :ck - :cookies host action - -

- Manage cookies for host. Additionally, the completion - list will show you information about the cookies and - permissions for the current page. -

- -

Available actions:

- -
-
unset
Unset special permissions for host
-
allow
Allow cookies from host
-
deny
Deny cookies from host
-
session
Allow cookies from host for the current session
-
list
List all cookies for host
-
clear
Clear all cookies for host
-
clear-persistent
Clear all persistent cookies for host
-
clear-session
Clear all session cookies for host
-
- -

- If no action is given, the value of cookies is used. -

- - :map -b c :cookies -
-
-

Online help

diff --git a/common/tests/functional/testHelpCommands.js b/common/tests/functional/testHelpCommands.js index c8032cc6..898867ba 100644 --- a/common/tests/functional/testHelpCommands.js +++ b/common/tests/functional/testHelpCommands.js @@ -17,8 +17,8 @@ var setupTest = function (test) { const HELP_FILES = ["all", "tutorial", "intro", "starting", "browsing", "buffer", "cmdline", "insert", "options", "pattern", "tabs", "hints", "map", "eval", "marks", "repeat", "autocommands", "print", "gui", - "styling", "message", "developer", "various", "plugins", "faq", "versions", - "index"]; + "styling", "message", "privacy", "developer", "various", "plugins", "faq", + "versions", "index"]; var testViHelpCommand_OpensIntroHelpPage = function () { assertHelpOpensPageWithTag({ diff --git a/pentadactyl/locale/en-US/intro.xml b/pentadactyl/locale/en-US/intro.xml index e71f9d1c..57474c5f 100644 --- a/pentadactyl/locale/en-US/intro.xml +++ b/pentadactyl/locale/en-US/intro.xml @@ -94,6 +94,10 @@ Error and informational messages: A description of informational and error messages. +
  • + Privacy and sensitive information: + How to manage your private data while browsing. +
  • Developer information: How to write plugins and documentation.