]> gitweb.stoutner.com Git - PrivacyBrowserPC.git/blobdiff - doc/index.docbook
Add final entries to the bookmarks folder menus. https://redmine.stoutner.com/issues...
[PrivacyBrowserPC.git] / doc / index.docbook
index da0bf4bc8a7aca4c1b3cef05b224fcd339952365..a89f6528ae7055678db6d301e0b7b1693858c967 100644 (file)
   along with Privacy Browser PC.  If not, see <http://www.gnu.org/licenses/>. -->
 
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
-  <!-- Privacy Browser’s name -->
-  <!ENTITY privacybrowser "<application>Privacy Browser</application>">
+    <!-- Privacy Browser’s name -->
+    <!ENTITY privacybrowser "<application>Privacy Browser</application>">
 
-  <!-- People. -->
-  <!ENTITY Soren.Stoutner "<personname><firstname>Soren</firstname><surname>Stoutner</surname></personname>">
-  <!ENTITY Soren.Stoutner.mail "<email>soren@stoutner.com</email>">
+    <!-- People. -->
+    <!ENTITY Soren.Stoutner "<personname><firstname>Soren</firstname><surname>Stoutner</surname></personname>">
+    <!ENTITY Soren.Stoutner.mail "<email>soren@stoutner.com</email>">
 
-  <!-- Set the language of this documentation. -->
-  <!ENTITY % English "INCLUDE">
+    <!-- Set the language of this documentation. -->
+    <!ENTITY % English "INCLUDE">
 
-  <!-- Default entries.  May not be needed. -->
-  <!ENTITY i18n-translatable-entity "<application>Translatable Entity</application>">
-  <!ENTITY % addindex "IGNORE">
+    <!-- Default entries.  May not be needed. -->
+    <!ENTITY i18n-translatable-entity "<application>Translatable Entity</application>">
+    <!ENTITY % addindex "IGNORE">
 ]>
 
 <book id="privacybrowser" lang="&language;">
     <legalnotice>&FDLNotice;</legalnotice>
 
     <!-- Last update. -->
-    <date>2023-04-17</date>
+    <date>2023-06-13</date>
 
     <!-- The version of Privacy Browser this documentation is written for. -->
-    <releaseinfo>&privacybrowser; version 0.2</releaseinfo>
+    <releaseinfo>&privacybrowser; version 0.4</releaseinfo>
 
 
     <!-- Abstract about this handbook -->
       <para>
         Privacy Browser blocks all HTTP pings and presents a dialog informing the user every time the current tab attempts to send one.
         Hopefully, as more people become aware of what HTTP pings are, web sites will become more embarrassed about using them.
-        This is a classic example of how those who wrote the HTTP specs do not have the best interests of internet users at heart. I would like the day to come where they are removed from the specs.
+        This is a classic example of how those who wrote the HTTP specs do not have the best interests of internet users at heart. I would like the day to come when this is removed from both the internet and the spec.
+        Here is an example of me <ulink url="https://forum.f-droid.org/t/the-f-droid-forum-should-stop-tracking-links-with-http-pings/">raising the issue</ulink> with F-Droid.
       </para>
     </sect1>
 
         <title>View</title>
 
         <variablelist>
+          <!-- Zoom In. -->
+          <varlistentry id="zoom-in">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
+                </shortcut>
+                <guimenu>View</guimenu>
+                <guimenuitem>Zoom In</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Increment the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
+              </para>
+            </listitem>
+          </varlistentry>
+
+
+          <!-- Zoom Out. -->
+          <varlistentry id="zoom-out">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
+                </shortcut>
+                <guimenu>View</guimenu>
+                <guimenuitem>Zoom Out</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Decrement the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
+              </para>
+            </listitem>
+          </varlistentry>
+
           <!-- Refresh. -->
           <varlistentry id="view-refresh">
             <term>
             </listitem>
           </varlistentry>
 
+          <!-- Reload and Bypass Cache. -->
+          <varlistentry id="view-reload-and-bypass-cache">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
+                </shortcut>
+                <guimenu>View</guimenu>
+                <guimenuitem>Reload and Bypass Cache</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Reload the website in the current tab bypassing any information in the cache and loading everything from the webserver.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- View Source. -->
+          <varlistentry id="view-source">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
+                </shortcut>
+                <guimenu>View</guimenu>
+                <guimenuitem>View Source</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Toggle between viewing the source and viewing the rendered website.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- View Source in New Tab. -->
+          <varlistentry id="view-source-in-new-tab">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo>
+                </shortcut>
+                <guimenu>View</guimenu>
+                <guimenuitem>View Source in New Tab></guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Open a new tab displaying the source of the current tab, or a new tab displaying the rendered version if the source is already displayed. Note that right-clicking on the background of a rendered website will display a context menu with a "View page source" entry, which performs the first of these actions.
+              </para>
+            </listitem>
+          </varlistentry>
+
           <!-- Full Screen Mode. -->
           <varlistentry id="view-full-screen-mode">
             <term>
       <sect2>
         <title>On-The-Fly Settings</title>
 
+        <variablelist>
+          <!-- JavaScript. -->
+          <varlistentry id="on-the-fly-settings-javascript">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
+                </shortcut>
+                <guimenu>On-The-Fly Settings</guimenu>
+                <guimenuitem>JavaScript</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Toggle JavaScript in the current tab.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- Local Storage. -->
+          <varlistentry id="on-the-fly-settings-local-storage">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
+                </shortcut>
+                <guimenu>On-The-Fly Settings</guimenu>
+                <guimenuitem>Local Storage</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Toggle local storage in the current tab.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- DOM Storage. -->
+          <varlistentry id="on-the-fly-settings-dom-storage">
+            <term>
+              <menuchoice>
+                <shortcut>
+                  <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+                </shortcut>
+                <guimenu>On-The-Fly Settings</guimenu>
+                <guimenuitem>DOM Storage</guimenuitem>
+              </menuchoice>
+            </term>
+
+            <listitem>
+              <para>
+                Toggle DOM storage in the current tab.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+
         <!-- User Agent. -->
         <sect3>
           <title>User Agent</title>
         </sect3>
       </sect2>
 
+      <!-- Bookmarks. -->
+      <sect2>
+          <title>Bookmarks</title>
+
+          <variablelist>
+              <!-- Add Bookmark. -->
+              <varlistentry id="add-bookmark">
+                  <term>
+                      <menuchoice>
+                          <shortcut>
+                              <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
+                          </shortcut>
+                          <guimenu>Bookmarks</guimenu>
+                          <guimenuitem>Add Bookmark</guimenuitem>
+                      </menuchoice>
+                  </term>
+
+                  <listitem>
+                      <para>
+                          Add a new bookmark.
+                      </para>
+                  </listitem>
+              </varlistentry>
+          </variablelist>
+      </sect2>
+
       <!-- Settings. -->
       <sect2>
         <title>Settings</title>
             <term>
               <menuchoice>
                 <shortcut>
-                  <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+                  <keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo>
                 </shortcut>
                 <guimenu>Settings</guimenu>
                 <guimenuitem>Domain Settings</guimenuitem>
         <title>Other Commands</title>
 
         <variablelist>
+          <!-- Find Case Sensitive. -->
+          <varlistentry id="find-case-sensitive">
+            <term>
+              <command>
+                &Ctrl;+<keycap>S</keycap>
+              </command>
+            </term>
+
+            <listitem>
+              <para>
+                Toggle find case sensitive if the find toolbar is visible.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- Open link in new tab. -->
+          <varlistentry id="new-tab">
+            <term>
+              <command>
+                &Ctrl;+&Shift;+Click
+              </command>
+            </term>
+
+            <listitem>
+              <para>
+                Open link in new tab. This performs the same action as right-clicking on the link and selecting “Open link in new tab”.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- Open link in background tab. -->
+          <varlistentry id="new-background-tab">
+            <term>
+              <command>
+                &Ctrl;+Click
+              </command>
+            </term>
+
+            <listitem>
+              <para>
+                Open link in new background tab. This performs the same action as right-clicking on the link and selecting “Open link in new background tab”.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- Open link in new window. -->
+          <varlistentry id="new-window">
+            <term>
+              <command>
+                &Shift;+Click
+              </command>
+            </term>
+
+            <listitem>
+              <para>
+                Open link in new window. This performs the same action as right-clicking on the link and selecting “Open link in new window”.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <!-- Save link. -->
+          <varlistentry id="save-link">
+            <term>
+              <command>
+                &Alt;+Click
+              </command>
+            </term>
+
+            <listitem>
+              <para>
+                Save link. This performs the same action as right-clicking on the link and selecting “Save link”.
+              </para>
+            </listitem>
+          </varlistentry>
+
           <!-- F11. -->
           <varlistentry id="f11">
             <term>
   <chapter id="changelog">
     <title>Changelog</title>
 
+    <!-- Version 0.4. -->
+    <sect1 id="version_0.4">
+      <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-4/">0.4</ulink> -
+        <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=b4c8c8d02113d14c2a07751eb3b0c1bdeec7abb4">13 June 2023</ulink></title>
+
+      <itemizedlist>
+        <listitem><para>Add a setting to <ulink url="https://redmine.stoutner.com/issues/1002">control spatial navigation</ulink>.</para></listitem>
+        <listitem><para>Add an action to <ulink url="https://redmine.stoutner.com/issues/982">reload and bypass cache</ulink>.</para></listitem>
+        <listitem><para>Fix a crash if one Privacy Browser window is closed while a <ulink url="https://redmine.stoutner.com/issues/1010">tab within it is loading</ulink>.</para></listitem>
+        <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/1009">keyboard+click commands</ulink> to the Handbook.</para></listitem>
+      </itemizedlist>
+    </sect1>
+
+    <!-- Version 0.3. -->
+    <sect1 id="version_0.3">
+      <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-3/">0.3</ulink> -
+        <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=ace098e8677ac0d6468b825c73e65b82c0d6993e">8 May 2023</ulink></title>
+
+      <itemizedlist>
+        <listitem><para>Add the changelog <ulink url="https://redmine.stoutner.com/issues/1000">to the Handbook</ulink>.</para></listitem>
+        <listitem><para>Add the missing <ulink url="https://redmine.stoutner.com/issues/999">current domain settings icon</ulink> on Gnome and Xfce.</para></listitem>
+        <listitem><para>Make changes to <ulink url="https://redmine.stoutner.com/issues/1005">build on Guix</ulink>.</para></listitem>
+      </itemizedlist>
+    </sect1>
+
     <!-- Version 0.2. -->
     <sect1 id="version_0.2">
       <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-2/">0.2</ulink> -
         </question>
 
         <answer>
-          <para>Because Privacy Browser is so perfectly designed that none have ever been asked. Also, because this is the first release and nobody has had a chance to ask them yet. ;)</para>
+          <para>Because Privacy Browser is so perfectly designed that none have ever been asked. Also, because this is an alpha release and nobody has had a chance to ask them yet. ;)</para>
         </answer>
       </qandaentry>
     </qandaset>