X-Git-Url: https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=blobdiff_plain;f=doc%2Findex.docbook;h=4119aea7eb1f6a6d8d35ecdb03e2517c82a2f56d;hp=f4da41f597401406984ccced2bfa93a28c42b0c3;hb=44b5d3a1f6a5e7fc2aa8530845f26eba7bc26f9a;hpb=dc74bf6bdf3d56e09465925a88a7328b8b71d746

diff --git a/doc/index.docbook b/doc/index.docbook
index f4da41f..4119aea 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -48,10 +48,10 @@
     <legalnotice>&FDLNotice;</legalnotice>
 
     <!-- Last update. -->
-    <date>2023-02-22</date>
+    <date>2023-04-17</date>
 
     <!-- The version of Privacy Browser this documentation is written for. -->
-    <releaseinfo>&privacybrowser; version 0.1</releaseinfo>
+    <releaseinfo>&privacybrowser; version 0.2</releaseinfo>
 
 
     <!-- Abstract about this handbook -->
@@ -59,6 +59,10 @@
       <para>
         &privacybrowser; is a web browser that respects your privacy.
       </para>
+
+      <para>
+        The only way to prevent data from being abused is to prevent it from being collected in the first place.
+      </para>
     </abstract>
 
     <!-- This is a set of Keywords for indexing by search engines. -->
@@ -141,7 +145,7 @@
     <para>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="privacybrowser.png" format="PNG"/>
+          <imagedata fileref="privacybrowser-window.png" format="PNG"/>
         </imageobject>
         <textobject>
           <phrase>Screenshot</phrase>
@@ -297,6 +301,40 @@
         Domain settings for all domains can be accessed through <xref linkend="settings-domain-settings"/>. When domain settings are active, the URL line edit will have a green background.
       </para>
     </sect1>
+
+    <!-- HTTP Pings. -->
+    <sect1 id="http-pings">
+      <title>HTTP Pings</title>
+
+      <para>
+        HTTP hyperlinks can have an extra <ulink url="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#ping">ping attribute</ulink> that sends a POST request to a different URL.
+        These HTTP pings are commonly used for tracking.
+        <ulink url="https://www.theregister.com/2019/04/06/apple_safari_changes/">Most browsers</ulink> send HTTP pings without informing the user
+        <ulink url="https://lists.w3.org/Archives/Public/public-html/2018May/0027.html">in any way</ulink>
+        (despite what The Register article says, current versions of FireFox also happily send HTTP pings).
+      </para>
+
+      <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.
+      </para>
+    </sect1>
+
+    <!-- Spell Checking. -->
+    <sect1 id="spell-checking">
+      <title>Spell Checking</title>
+
+      <para>
+        Privacy Browser uses the binary <filename>.bdic</filename> Hunspell dictionary format <ulink url="https://doc.qt.io/qt-5/qtwebengine-features.html#spellchecker">utilized by Qt WebEngine</ulink>
+        which was <ulink url="https://sites.google.com/a/chromium.org/dev/developers/how-tos/editing-the-spell-checking-dictionaries">created by Google for Chromium</ulink>.
+        Debian’s Hunspell dictionary language packages are slowly adding support for the <filename>.bdic</filename> format. Those which have are listed by Privacy Browser as suggested packages.
+      </para>
+
+      <para>
+        Once a <filename>.bdic</filename> dictionary is installed, it can be enabled in Privacy Browser’s settings.
+      </para>
+    </sect1>
   </chapter>
 
   <!-- Commands. -->
@@ -1222,24 +1260,94 @@
     <title>Credits and License</title>
 
     <para>
-      Program copyright 2016-2017,2021-2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
+      Privacy Browser PC copyright 2016-2017,2021-2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
     </para>
 
-    <para>
-      Translators:
-      <itemizedlist>
-        <listitem><para>Translations will be added in a future release.</para></listitem>
-      </itemizedlist>
-    </para>
+    <!-- Program. -->
+    <sect1 id="program">
+      <title>Program</title>
 
-    <!-- The program license. -->
-    &underGPL;
+      <para>
+        The source code is available at <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=summary">gitweb.stoutner.com</ulink>
+        or by running <filename>git clone https://git.stoutner.com/PrivacyBrowserPC.git</filename>.
+      </para>
 
-    <para>
-      Documentation copyright 2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
-    </para>
+      <para>
+        Translators:
+        <itemizedlist>
+          <listitem><para>Translations will be added in a future release.</para></listitem>
+        </itemizedlist>
+      </para>
+
+      <!-- The program license. -->
+      &underGPL;
+    </sect1>
+
+    <!-- Documentation. -->
+    <sect1 id="documentation">
+      <title>Documentation</title>
+
+      <para>
+        <filename>doc/index.docbook</filename> and <filename>src/com.stoutner.privacybrowser.appdata.xml</filename> are released under the
+        <ulink url="https://www.gnu.org/licenses/fdl-1.3.html">GFDL-1.3 license</ulink> with no Front-Cover or Back-Cover Texts or Invariant Sections.
+        All other documentation is released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
+      </para>
+
+      <!-- The documentation license. -->
+      &underFDL;
+    </sect1>
 
-    <!-- The documentation license. -->
-    &underFDL;
+    <!-- Icons. -->
+    <sect1 id="icons">
+      <title>Icons</title>
+
+      <para>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="privacybrowser.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Privacy Browser</phrase>
+          </textobject>
+        </inlinemediaobject>
+
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="javascript.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>JavaScript</phrase>
+          </textobject>
+        </inlinemediaobject>
+
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="privacybrowser-monochrome.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <phrase>Privacy Browser Monochrome</phrase>
+          </textobject>
+        </inlinemediaobject>
+
+        are derived from <filename>security</filename> and <filename>language</filename>, which are part of the <ulink url="https://fonts.google.com/icons">Android Material icon set</ulink>
+        and are released under the <ulink url="https://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</ulink>. Modifications copyright 2016-2017,2021-2023 Soren Stoutner.
+        The resulting images are released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
+      </para>
+
+      <para>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="loading.gif" format="GIF"/>
+          </imageobject>
+          <textobject>
+            <phrase>Loading</phrase>
+          </textobject>
+        </inlinemediaobject>
+
+        comes from <ulink url="https://github.com/Codelessly/FlutterLoadingGIFs/blob/master/packages/cupertino_activity_indicator_selective.gif">FlutterLoadingGIFs</ulink>
+        where it is named <filename>cupertino_activity_indicator_selective.gif</filename>.
+        It is released under the <ulink url="https://opensource.org/license/0bsd/">Zero-Clause BSD License</ulink>.
+      </para>
+    </sect1>
   </chapter>
 </book>