]> gitweb.stoutner.com Git - PrivacyBrowserPC.git/blobdiff - doc/index.docbook
Release 0.2.
[PrivacyBrowserPC.git] / doc / index.docbook
index c519d0e5f81c13ae7f7ea6a4bf937c970f1b711c..4119aea7eb1f6a6d8d35ecdb03e2517c82a2f56d 100644 (file)
     <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 -->
     <para>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="privacybrowser.png" format="PNG"/>
+          <imagedata fileref="privacybrowser-window.png" format="PNG"/>
         </imageobject>
         <textobject>
           <phrase>Screenshot</phrase>
       </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>
     <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;
+      <!-- The documentation license. -->
+      &underFDL;
+    </sect1>
+
+    <!-- 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>