doc/index.docbook

   1 <?xml version="1.0" ?>
   2
   3 <!--
   4   Copyright 2023-2024 Soren Stoutner <soren@stoutner.com>.
   5
   6   This file is part of Privacy Browser PC <https://www.stoutner.com/privacy-browser-pc>.
   7
   8   Permission is granted to copy, distribute and/or modify this document
   9   under the terms of the GNU Free Documentation License, Version 1.3
  10   or any later version published by the Free Software Foundation;
  11   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
  12
  13   You should have received a copy of the GNU Free Documentation License
  14   along with Privacy Browser PC.  If not, see <http://www.gnu.org/licenses/>. -->
  15
  16 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  17     <!-- Privacy Browser’s name -->
  18     <!ENTITY privacybrowser "<application>Privacy Browser</application>">
  19
  20     <!-- People. -->
  21     <!ENTITY Soren.Stoutner "<personname><firstname>Soren</firstname><surname>Stoutner</surname></personname>">
  22     <!ENTITY Soren.Stoutner.mail "<email>soren@stoutner.com</email>">
  23
  24     <!-- Set the language of this documentation. -->
  25     <!ENTITY % English "INCLUDE">
  26 ]>
  27
  28 <book id="privacybrowser" lang="&language;">
  29     <bookinfo>
  30         <title>The &privacybrowser; Handbook</title>
  31
  32         <authorgroup>
  33             <author>&Soren.Stoutner; &Soren.Stoutner.mail;</author>
  34
  35             <!-- Add translators here.-->
  36         </authorgroup>
  37
  38         <copyright>
  39             <year>2016-2017, 2021-2024</year>
  40             <holder>&Soren.Stoutner;</holder>
  41         </copyright>
  42
  43         <!-- Documentation license. -->
  44         <legalnotice>&FDLNotice;</legalnotice>
  45
  46         <!-- Last update. -->
  47         <date>2024-01-06</date>
  48
  49         <!-- The version of Privacy Browser this documentation is written for. -->
  50         <releaseinfo>&privacybrowser; version 0.5</releaseinfo>
  51
  52         <!-- Abstract about this handbook -->
  53         <abstract>
  54             <para>
  55                 &privacybrowser; is a web browser that respects your privacy.
  56             </para>
  57
  58             <para>
  59                 The only way to prevent data from being abused is to prevent it from being collected in the first place.
  60             </para>
  61         </abstract>
  62
  63         <!-- This is a set of Keywords for indexing by search engines. -->
  64         <keywordset>
  65             <keyword>KDE</keyword>
  66             <keyword>privacy</keyword>
  67             <keyword>browser</keyword>
  68         </keywordset>
  69     </bookinfo>
  70
  71     <!-- Introduction. -->
  72     <chapter id="introduction">
  73         <title>Introduction</title>
  74
  75         <para>
  76             &privacybrowser; is currently in an early alpha state.
  77             Most of the features are not yet implemented, but I thought it would be useful to publish it so that users can track the progress and submit feedback.
  78         </para>
  79
  80         <para>
  81             To distinguish between the Android and the PC version, the website, issue tracker,
  82             and code base refer to this version as <ulink url="https://www.stoutner.com/privacy-browser-pc/">Privacy Browser PC</ulink>.
  83         </para>
  84
  85         <para>
  86             The best place to discuss the development of Privacy Browser is <ulink url="https://redmine.stoutner.com/projects/privacy-browser-pc/boards">on the forum</ulink>.
  87             I also frequently post on my <ulink url="https://fosstodon.org/@privacybrowser">Mastodon account</ulink> regarding the development status.
  88         </para>
  89
  90         <!-- Qt WebEngine. -->
  91         <sect1 id="qt-webengine">
  92             <title>Qt WebEngine</title>
  93
  94             <para>
  95                 Privacy Browser uses <ulink url="https://doc.qt.io/qt-5/qtwebengine-index.html">Qt WebEngine</ulink> to render websites.
  96                 Qt WebEngine is based on the <ulink url="https://www.chromium.org/blink/">Chromium Blink</ulink> source code.
  97                 Because Privacy Browser is built on the <ulink url="https://api.kde.org/frameworks/index.html">KDE Framework</ulink>,
  98                 it currently uses the <ulink url="https://community.kde.org/Schedules/Plasma_6">Qt 5</ulink> packages.
  99             </para>
 100
 101             <para>
 102                 The current Qt 5 packages are in long-term support mode.
 103                 From a feature perspective, Qt WebEngine 5.15.x is based on <ulink url="https://wiki.qt.io/QtWebEngine/ChromiumVersions">Chromium 87.0.4280.144</ulink>.
 104                 Security fixes are backported every few months with <ulink url="https://wiki.qt.io/Qt_5.15_Release#Release_Plan">each release</ulink>.
 105             </para>
 106         </sect1>
 107
 108         <!-- Bugs and missing features. -->
 109         <sect1 id="bugs-and-missing-features">
 110             <title>Bugs and Missing Features</title>
 111
 112             <para>
 113                 There is a list of feature requests and known bugs at <ulink url="https://redmine.stoutner.com/projects/privacy-browser-pc/issues">redmine.stoutner.com</ulink>.
 114                 Users should anticipate that all the current features of <ulink url="https://www.stoutner.com/privacy-browser-android/">Privacy Browser Android</ulink>
 115                 will also be implemented in Privacy Browser PC.
 116                 There is no need at this point to create features requests for these as they will be added as I start working on each feature and have a better idea of how they will be implemented.
 117                 However, each feature that has already been implemented should be bug free.
 118                 If you discover a bug that is not already documented at <ulink url="https://redmine.stoutner.com/projects/privacy-browser-pc/issues">redmine.stoutner.com</ulink> please add it.
 119             </para>
 120
 121             <para>
 122                 Below is a list of known prominent bugs or missing features in this alpha release.
 123             </para>
 124
 125             <itemizedlist>
 126                 <listitem><para>The page zoom is <ulink url="https://redmine.stoutner.com/issues/799">momentarily reset</ulink> every time a new URL is loaded.</para></listitem>
 127                 <listitem><para>If domain settings change the user agent, loading of the new URL is interrupted and the
 128                         <ulink url="https://redmine.stoutner.com/issues/821">previous site is reloaded</ulink>.</para></listitem>
 129                 <listitem><para>Browser <ulink url="https://redmine.stoutner.com/issues/831">error messages are not displayed</ulink> unless JavaScript is enabled.</para></listitem>
 130                 <listitem><para>Filter lists are <ulink url="https://redmine.stoutner.com/issues/969">not yet implemented</ulink>.</para></listitem>
 131             </itemizedlist>
 132         </sect1>
 133     </chapter>
 134
 135     <!-- Using Privacy Browser. -->
 136     <chapter id="using-privacy-browser">
 137         <title>Using &privacybrowser;</title>
 138
 139         <para>
 140             <mediaobject>
 141                 <imageobject>
 142                     <imagedata fileref="privacybrowser-window.png" format="PNG"/>
 143                 </imageobject>
 144
 145                 <textobject>
 146                     <phrase>Screenshot</phrase>
 147                 </textobject>
 148             </mediaobject>
 149         </para>
 150
 151         <!-- JavaScript. -->
 152         <sect1 id="javascript">
 153             <title>JavaScript</title>
 154
 155             <para>
 156                 JavaScript allows web pages to run scripts (programs) on your device. It allows web pages to function more like apps, but it also allows web pages to spy on you.
 157                 Most of the tracking on the internet does not work when JavaScript is disabled.
 158                 JavaScript can be toggled by clicking on the privacy shield, which is blue if JavaScript is disabled and red when it is enabled.
 159                 <inlinemediaobject>
 160                     <imageobject>
 161                         <imagedata fileref="javascript.png" format="PNG"/>
 162                     </imageobject>
 163
 164                     <textobject>
 165                         <phrase>JavaScript</phrase>
 166                     </textobject>
 167                 </inlinemediaobject>
 168             </para>
 169         </sect1>
 170
 171         <!-- Local Storage. -->
 172         <sect1 id="local-storage">
 173             <title>Local Storage</title>
 174
 175             <para>
 176                 <ulink url="https://doc.qt.io/qt-5/qwebenginecookiestore.html#setCookieFilter">Local storage</ulink>
 177                 in Privacy Browser encompasses cookies, DOM storage, IndexedDB, service workers, and the filesystem API.
 178                 Local storage can be toggled through an action on the toolbar.
 179             </para>
 180
 181             <!-- Cookies. -->
 182             <sect2 id="cookies">
 183                 <title>Cookies</title>
 184
 185                 <para>
 186                     <ulink url="https://en.wikipedia.org/wiki/HTTP_cookie">Cookies</ulink>
 187                     allow websites to store small pieces of information for a specific host that are sent in the HTTP header every time the browser connects to that host.
 188                     Privacy Browser allows a maximum of <ulink url="http://browsercookielimits.iain.guru/">180 cookies with a maximum size of 4096 bytes per cookie</ulink> to be set per domain.
 189                     Cookies are often used to track users across the web, particularly third-party cookies (which are completely blocked in Privacy Browser).
 190                     They are also used as a security mechanism on websites where you log in to identify it is you as you browse from page to page on a site.
 191                 </para>
 192
 193                 <para>
 194                     <mediaobject>
 195                         <imageobject>
 196                             <imagedata fileref="cookies.png" format="PNG"/>
 197                         </imageobject>
 198
 199                         <textobject>
 200                             <phrase>Cookies</phrase>
 201                         </textobject>
 202                     </mediaobject>
 203                 </para>
 204
 205                 <para>
 206                     The cookies dialog is opened from <xref linkend="settings-cookies"/>.
 207                     Durable cookies are shared with all tabs that are opened after they are made durable and are preserved even when Privacy Browser is restarted.
 208                     This allows users to stay logged in to sites of their choosing. No cookies are durable by default. Making a cookie durable requires specific user interaction.
 209                 </para>
 210
 211                 <para>
 212                     All other cookies are specific to the tab where they are created and are destroyed when the tab is closed.
 213                 </para>
 214             </sect2>
 215
 216             <!-- DOM storage. -->
 217             <sect2 id="dom-storage">
 218                 <title>DOM storage</title>
 219
 220                 <para>
 221                     <ulink url="https://en.wikipedia.org/wiki/Web_storage">DOM (Document Object Model) storage</ulink>, also knows as web storage,
 222                     allows web pages to store information on a client device.
 223                     The storage capacity is larger than for cookies and the data is not automatically sent in the headers with every HTTP request.
 224                     In Privacy Browser, each website is allowed to store a <ulink url="https://arty.name/localstorage.html">5 MB of data</ulink> in DOM storage.
 225                     DOM storage requires JavaScript to function, and, in addition, requires an extra toggle to be enabled.
 226                     In Privacy Browser, DOM storage is limited to the tab where it is created and is destroyed when the tab is closed.
 227                 </para>
 228             </sect2>
 229
 230             <!-- IndexedDB. -->
 231             <sect2 id="indexeddb">
 232                 <title>IndexedDB</title>
 233
 234                 <para>
 235                     <ulink url="https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API">IndexedDB</ulink>
 236                     provides web pages with a local database where they can store “significant amounts of structured data”.
 237                     There is disagreement on the internet about the maximum size of an IndexedDB database, probably because the various rendering engines keep changing their mind.
 238                     But it is usually listed at somewhere between 20% and 80% of <emphasis>your entire hard drive</emphasis> with each individual domain limited to some segment of that.
 239                     IndexedDB requires JavaScript to function.
 240                     In Privacy Browser, this database is limited to the tab where it is created and is destroyed when the tab is closed.
 241                 </para>
 242             </sect2>
 243
 244             <!-- Service Workers. -->
 245             <sect2 id="service-workers">
 246                 <title>Service Workers</title>
 247
 248                 <para>
 249                     <ulink url="https://developer.chrome.com/docs/workbox/service-worker-overview/">Service workers</ulink> are offline JavaScript proxies of a website.
 250                     They have their own cache that is usually hidden and hard to clear.
 251                     They were designed by people who want the web browser to become the operating system and run full “apps”.
 252                     In Privacy Browser, service workers are limited to the tab where they are created and are destroyed when the tab is closed.
 253                 </para>
 254             </sect2>
 255
 256             <!-- Filesystem API. -->
 257             <sect2 id="filesystem-api">
 258                 <title>Filesystem API</title>
 259
 260                 <para>
 261                     The <ulink url="https://developer.chrome.com/articles/file-system-access/">filesystem API</ulink> grants the browser direct access to the files on your system.
 262                     Like service workers, the filesystem API is a summarily bad idea thought up by those who want the browser to become an operating system.
 263                     Even when JavaScript and local storage are enabled, the filesystem API does not work in Privacy Browser.
 264                 </para>
 265             </sect2>
 266         </sect1>
 267
 268         <!-- User Agent. -->
 269         <sect1 id="user-agent">
 270             <title>User Agent</title>
 271
 272             <para>
 273                 The user agent is a text string that is sent as part of every HTTP header that identifies the browser to the web server.
 274                 Privacy Browser's default user agent is <code>PrivacyBrowser/1.0</code>.
 275                 Qt WebEngine 5.15.15’s default user agent is <code>Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) QtWebEngine/5.15.15 Chrome/87.0.4280.144 Safari/537.36</code>.
 276             </para>
 277
 278             <para>
 279                 Over the years user agents have become quite lengthy,
 280                 partially because they tend to include a <ulink url="https://webaim.org/blog/user-agent-string-history/">brief history of the internet</ulink>.
 281                 In the modern world they serve almost no good purpose, but some web developers still think they need them so they can send different version of their website to different browsers.
 282                 Some servers <ulink url="https://www.stoutner.com/user-agent-problems/">refuse to function correctly</ulink> if they don't like the user agent that is sent.
 283             </para>
 284
 285             <para>
 286                 At some point in the future Privacy Browser will send no user agent by default.
 287                 Not only is that currently impossible because the Qt WebEngine doesn't allow you to not send a user agent (I will probably have to fork it to enable that functionality),
 288                 but even web servers that don't care what the user agent is often refuse to send an answer if there is no user agent at all.
 289                 Getting rid of this relic of the internet is going to take some time and a retraining of common expectations.
 290             </para>
 291         </sect1>
 292
 293         <!-- Domain Settings. -->
 294         <sect1 id="domain-settings">
 295             <title>Domain Settings</title>
 296
 297             <para>
 298                 Domain setting make it easy to automatically change JavaScript, local storage, user agent, and other settings when the domain changes.
 299                 Domain settings for the current domain can be accessed through the domain settings button at the far right of the URL line edit.
 300                 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.
 301             </para>
 302         </sect1>
 303
 304         <!-- HTTP Pings. -->
 305         <sect1 id="http-pings">
 306             <title>HTTP Pings</title>
 307
 308             <para>
 309                 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.
 310                 These HTTP pings are commonly used for tracking.
 311                 <ulink url="https://www.theregister.com/2019/04/06/apple_safari_changes/">Most browsers</ulink> send HTTP pings without informing the user
 312                 <ulink url="https://lists.w3.org/Archives/Public/public-html/2018May/0027.html">in any way</ulink>
 313                 (despite what The Register article says, current versions of FireFox also happily send HTTP pings).
 314             </para>
 315
 316             <para>
 317                 Privacy Browser blocks all HTTP pings and presents a dialog informing the user every time the current tab attempts to send one.
 318                 Hopefully, as more people become aware of what HTTP pings are, web sites will become more embarrassed about using them.
 319                 This is a classic example of how those who wrote the HTTP specs do not have the best interests of internet users at heart.
 320                 I would like the day to come when this is removed from both the internet and the spec.
 321                 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.
 322             </para>
 323         </sect1>
 324
 325         <!-- Spell Checking. -->
 326         <sect1 id="spell-checking">
 327             <title>Spell Checking</title>
 328
 329             <para>
 330                 Privacy Browser uses the binary <filename>.bdic</filename> Hunspell dictionary format
 331                 <ulink url="https://doc.qt.io/qt-5/qtwebengine-features.html#spellchecker">utilized by Qt WebEngine</ulink>
 332                 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>.
 333                 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.
 334             </para>
 335
 336             <para>
 337                 Once a <filename>.bdic</filename> dictionary is installed, it can be enabled in Privacy Browser’s settings.
 338             </para>
 339         </sect1>
 340     </chapter>
 341
 342     <!-- Commands. -->
 343     <chapter id="commands">
 344         <title>Command Reference</title>
 345
 346         <!-- Main Window. -->
 347         <sect1 id="main-window">
 348             <title>Main Window</title>
 349
 350             <!-- File. -->
 351             <sect2>
 352                 <title>File</title>
 353
 354                 <variablelist>
 355                     <!-- New Tab. -->
 356                     <varlistentry id="file-new-tab">
 357                         <term>
 358                             <menuchoice>
 359                                 <shortcut>
 360                                     <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
 361                                 </shortcut>
 362
 363                                 <guimenu>File</guimenu>
 364
 365                                 <guimenuitem>New Tab</guimenuitem>
 366                             </menuchoice>
 367                         </term>
 368
 369                         <listitem>
 370                             <para>
 371                                 Create a new tab.
 372                             </para>
 373                         </listitem>
 374                     </varlistentry>
 375
 376                     <!-- New Window. -->
 377                     <varlistentry id="file-new-window">
 378                         <term>
 379                             <menuchoice>
 380                                 <shortcut>
 381                                     <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 382                                 </shortcut>
 383
 384                                 <guimenu>File</guimenu>
 385
 386                                 <guimenuitem>New Window</guimenuitem>
 387                             </menuchoice>
 388                         </term>
 389
 390                         <listitem>
 391                             <para>
 392                                 Create a new window.
 393                             </para>
 394                         </listitem>
 395                     </varlistentry>
 396
 397                     <!-- Save Archive. -->
 398                     <varlistentry id="file-save-archive">
 399                         <term>
 400                             <menuchoice>
 401                                 <shortcut>
 402                                     <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
 403                                 </shortcut>
 404
 405                                 <guimenu>File</guimenu>
 406
 407                                 <guimenuitem>Save Archive</guimenuitem>
 408                             </menuchoice>
 409                         </term>
 410
 411                         <listitem>
 412                             <para>
 413                                 Save the webpage as an MHT (MIME encapsulation of aggregate HTML documents) archive.
 414                             </para>
 415                         </listitem>
 416                     </varlistentry>
 417
 418                     <!-- Print. -->
 419                     <varlistentry  id="file-print">
 420                         <term>
 421                             <menuchoice>
 422                                 <shortcut>
 423                                     <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
 424                                 </shortcut>
 425
 426                                 <guimenu>File</guimenu>
 427
 428                                 <guimenuitem>Print</guimenuitem>
 429                             </menuchoice>
 430                         </term>
 431
 432                         <listitem>
 433                             <para>
 434                                 Print the document.
 435                             </para>
 436                         </listitem>
 437                     </varlistentry>
 438
 439                     <!-- Print Preview. -->
 440                     <varlistentry  id="file-print-preview">
 441                         <term>
 442                             <menuchoice>
 443                                 <shortcut>
 444                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>P</keycap></keycombo>
 445                                 </shortcut>
 446
 447                                 <guimenu>File</guimenu>
 448
 449                                 <guimenuitem>Print Preview</guimenuitem>
 450                             </menuchoice>
 451                         </term>
 452
 453                         <listitem>
 454                             <para>
 455                                 Display the print preview dialog.
 456                             </para>
 457                         </listitem>
 458                     </varlistentry>
 459
 460                     <!-- Quit. -->
 461                     <varlistentry  id="file-quit">
 462                         <term>
 463                             <menuchoice>
 464                                 <shortcut>
 465                                     <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 466                                 </shortcut>
 467
 468                                 <guimenu>File</guimenu>
 469
 470                                 <guimenuitem>Quit</guimenuitem>
 471                             </menuchoice>
 472                         </term>
 473
 474                         <listitem>
 475                             <para>
 476                                 Quit &privacybrowser;.
 477                             </para>
 478                         </listitem>
 479                     </varlistentry>
 480                 </variablelist>
 481             </sect2>
 482
 483             <!-- Edit. -->
 484             <sect2>
 485                 <title>Edit</title>
 486
 487                 <variablelist>
 488                     <!-- Find. -->
 489                     <varlistentry id="edit-find">
 490                         <term>
 491                             <menuchoice>
 492                                 <shortcut>
 493                                     <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
 494                                 </shortcut>
 495
 496                                 <guimenu>Edit</guimenu>
 497
 498                                 <guimenuitem>Find</guimenuitem>
 499                             </menuchoice>
 500                         </term>
 501
 502                         <listitem>
 503                             <para>
 504                                 Display the find toolbar and focus the find text line edit. If the toolbar is already displayed, the find text line edit is refocused and the text it contains is selected.
 505                             </para>
 506                         </listitem>
 507                     </varlistentry>
 508
 509
 510                     <!-- Find Next. -->
 511                     <varlistentry id="edit-find-next">
 512                         <term>
 513                             <menuchoice>
 514                                 <shortcut>
 515                                     <keycap>F3</keycap>
 516                                 </shortcut>
 517
 518                                 <guimenu>Edit</guimenu>
 519
 520                                 <guimenuitem>Find Next</guimenuitem>
 521                             </menuchoice>
 522                         </term>
 523
 524                         <listitem>
 525                             <para>
 526                                 Find the next entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible.
 527                             </para>
 528                         </listitem>
 529                     </varlistentry>
 530
 531                     <!-- Find Previous. -->
 532                     <varlistentry id="edit-find-previous">
 533                         <term>
 534                             <menuchoice>
 535                                 <shortcut>
 536                                     <keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo>
 537                                 </shortcut>
 538
 539                                 <guimenu>Edit</guimenu>
 540
 541                                 <guimenuitem>Find Previous</guimenuitem>
 542                             </menuchoice>
 543                         </term>
 544
 545                         <listitem>
 546                             <para>
 547                                 Find the previous entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible.
 548                             </para>
 549                         </listitem>
 550                     </varlistentry>
 551                 </variablelist>
 552             </sect2>
 553
 554             <!-- View. -->
 555             <sect2>
 556                 <title>View</title>
 557
 558                 <variablelist>
 559                     <!-- Zoom Default. -->
 560                     <varlistentry id="zoom-default">
 561                         <term>
 562                             <menuchoice>
 563                                 <shortcut>
 564                                     <keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo>
 565                                 </shortcut>
 566
 567                                 <guimenu>View</guimenu>
 568
 569                                 <guimenuitem>Zoom Default</guimenuitem>
 570                             </menuchoice>
 571                         </term>
 572
 573                         <listitem>
 574                             <para>
 575                                 Return to either the app or the domain default zoom factor.
 576                             </para>
 577                         </listitem>
 578                     </varlistentry>
 579
 580                     <!-- Zoom In. -->
 581                     <varlistentry id="zoom-in">
 582                         <term>
 583                             <menuchoice>
 584                                 <shortcut>
 585                                     <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
 586                                 </shortcut>
 587
 588                                 <guimenu>View</guimenu>
 589
 590                                 <guimenuitem>Zoom In</guimenuitem>
 591                             </menuchoice>
 592                         </term>
 593
 594                         <listitem>
 595                             <para>
 596                                 Increment the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
 597                             </para>
 598                         </listitem>
 599                     </varlistentry>
 600
 601
 602                     <!-- Zoom Out. -->
 603                     <varlistentry id="zoom-out">
 604                         <term>
 605                             <menuchoice>
 606                                 <shortcut>
 607                                     <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
 608                                 </shortcut>
 609
 610                                 <guimenu>View</guimenu>
 611
 612                                 <guimenuitem>Zoom Out</guimenuitem>
 613                             </menuchoice>
 614                         </term>
 615
 616                         <listitem>
 617                             <para>
 618                                 Decrement the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
 619                             </para>
 620                         </listitem>
 621                     </varlistentry>
 622
 623                     <!-- Refresh. -->
 624                     <varlistentry id="view-refresh">
 625                         <term>
 626                             <menuchoice>
 627                                 <shortcut>
 628                                     <keycap>F5</keycap>
 629                                 </shortcut>
 630
 631                                 <guimenu>View</guimenu>
 632
 633                                 <guimenuitem>Refresh</guimenuitem>
 634                             </menuchoice>
 635                         </term>
 636
 637                         <listitem>
 638                             <para>
 639                                 Reload the website in the current tab.  When Refresh is visible, <xref linkend="view-stop"/> is hidden.
 640                             </para>
 641                         </listitem>
 642                     </varlistentry>
 643
 644                     <!-- Reload and Bypass Cache. -->
 645                     <varlistentry id="view-reload-and-bypass-cache">
 646                         <term>
 647                             <menuchoice>
 648                                 <shortcut>
 649                                     <keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
 650                                 </shortcut>
 651
 652                                 <guimenu>View</guimenu>
 653
 654                                 <guimenuitem>Reload and Bypass Cache</guimenuitem>
 655                             </menuchoice>
 656                         </term>
 657
 658                         <listitem>
 659                             <para>
 660                                 Reload the website in the current tab bypassing any information in the cache and loading everything from the webserver.
 661                             </para>
 662                         </listitem>
 663                     </varlistentry>
 664
 665                     <!-- Stop. -->
 666                     <varlistentry id="view-stop">
 667                         <term>
 668                             <menuchoice>
 669                                 <shortcut>
 670                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>X</keycap></keycombo>
 671                                 </shortcut>
 672
 673                                 <guimenu>View</guimenu>
 674
 675                                 <guimenuitem>Stop</guimenuitem>
 676                             </menuchoice>
 677                         </term>
 678
 679                         <listitem>
 680                             <para>
 681                                 Stop the loading of the website in the current tab.  When Stop is visible, <xref linkend="view-refresh"/> is hidden.
 682                             </para>
 683                         </listitem>
 684                     </varlistentry>
 685
 686                     <!-- View Source. -->
 687                     <varlistentry id="view-source">
 688                         <term>
 689                             <menuchoice>
 690                                 <shortcut>
 691                                     <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
 692                                 </shortcut>
 693
 694                                 <guimenu>View</guimenu>
 695
 696                                 <guimenuitem>View Source</guimenuitem>
 697                             </menuchoice>
 698                         </term>
 699
 700                         <listitem>
 701                             <para>
 702                                 Toggle between viewing the source and viewing the rendered website.
 703                             </para>
 704                         </listitem>
 705                     </varlistentry>
 706
 707                     <!-- View Source in New Tab. -->
 708                     <varlistentry id="view-source-in-new-tab">
 709                         <term>
 710                             <menuchoice>
 711                                 <shortcut>
 712                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo>
 713                                 </shortcut>
 714
 715                                 <guimenu>View</guimenu>
 716
 717                                 <guimenuitem>View Source in New Tab></guimenuitem>
 718                             </menuchoice>
 719                         </term>
 720
 721                         <listitem>
 722                             <para>
 723                                 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.
 724                                 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.
 725                             </para>
 726                         </listitem>
 727                     </varlistentry>
 728
 729                     <!-- Developer Tools. -->
 730                     <varlistentry id="view-developer-tools">
 731                         <term>
 732                             <menuchoice>
 733                                 <shortcut>
 734                                     <keycap>F12</keycap>
 735                                 </shortcut>
 736
 737                                 <guimenu>View</guimenu>
 738
 739                                 <guimenuitem>Developer Tools</guimenuitem>
 740                             </menuchoice>
 741                         </term>
 742
 743                         <listitem>
 744                             <para>
 745                                 Display the developer tools, which are used to debug websites.
 746                             </para>
 747                         </listitem>
 748                     </varlistentry>
 749
 750                     <!-- Full Screen Mode. -->
 751                     <varlistentry id="view-full-screen-mode">
 752                         <term>
 753                             <menuchoice>
 754                                 <shortcut>
 755                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
 756                                 </shortcut>
 757
 758                                 <guimenu>View</guimenu>
 759
 760                                 <guimenuitem>Full Screen Mode</guimenuitem>
 761                             </menuchoice>
 762                         </term>
 763
 764                         <listitem>
 765                             <para>
 766                                 Toggle full screen mode. This performs the same action as <xref linkend="f11"/>.
 767                             </para>
 768                         </listitem>
 769                     </varlistentry>
 770                 </variablelist>
 771             </sect2>
 772
 773             <!-- Go. -->
 774             <sect2>
 775                 <title>Go</title>
 776
 777                 <variablelist>
 778                     <!-- Back. -->
 779                     <varlistentry id="go-back">
 780                         <term>
 781                             <menuchoice>
 782                                 <shortcut>
 783                                     <keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo>
 784                                 </shortcut>
 785
 786                                 <guimenu>Go</guimenu>
 787
 788                                 <guimenuitem>Back</guimenuitem>
 789                             </menuchoice>
 790                         </term>
 791
 792                         <listitem>
 793                             <para>
 794                                 Navigate back one step in the current tab’s history. The action is disabled if it is not possible to go back.
 795                             </para>
 796                         </listitem>
 797                     </varlistentry>
 798
 799                     <!-- Forward. -->
 800                     <varlistentry id="go-forward">
 801                         <term>
 802                             <menuchoice>
 803                                 <shortcut>
 804                                     <keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo>
 805                                 </shortcut>
 806
 807                                 <guimenu>Go</guimenu>
 808
 809                                 <guimenuitem>Forward</guimenuitem>
 810                             </menuchoice>
 811                         </term>
 812
 813                         <listitem>
 814                             <para>
 815                                 Navigate forward one step in the current tab’s history. The action is disabled if it is not possible to go forward.
 816                             </para>
 817                         </listitem>
 818                     </varlistentry>
 819
 820                     <!-- Home. -->
 821                     <varlistentry id="go-home">
 822                         <term>
 823                             <menuchoice>
 824                                 <shortcut>
 825                                     <keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
 826                                 </shortcut>
 827
 828                                 <guimenu>Go</guimenu>
 829
 830                                 <guimenuitem>Home</guimenuitem>
 831                             </menuchoice>
 832                         </term>
 833
 834                         <listitem>
 835                             <para>
 836                                 Load the home page in the current tab.
 837                             </para>
 838                         </listitem>
 839                     </varlistentry>
 840                 </variablelist>
 841             </sect2>
 842
 843             <!-- On-The-Fly Settings. -->
 844             <sect2>
 845                 <title>On-The-Fly Settings</title>
 846
 847                 <variablelist>
 848                     <!-- JavaScript. -->
 849                     <varlistentry id="on-the-fly-settings-javascript">
 850                         <term>
 851                             <menuchoice>
 852                                 <shortcut>
 853                                     <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
 854                                 </shortcut>
 855
 856                                 <guimenu>On-The-Fly Settings</guimenu>
 857
 858                                 <guimenuitem>JavaScript</guimenuitem>
 859                             </menuchoice>
 860                         </term>
 861
 862                         <listitem>
 863                             <para>
 864                                 Toggle JavaScript in the current tab.
 865                             </para>
 866                         </listitem>
 867                     </varlistentry>
 868
 869                     <!-- Local Storage. -->
 870                     <varlistentry id="on-the-fly-settings-local-storage">
 871                         <term>
 872                             <menuchoice>
 873                                 <shortcut>
 874                                     <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
 875                                 </shortcut>
 876
 877                                 <guimenu>On-The-Fly Settings</guimenu>
 878
 879                                 <guimenuitem>Local Storage</guimenuitem>
 880                             </menuchoice>
 881                         </term>
 882
 883                         <listitem>
 884                             <para>
 885                                 Toggle local storage in the current tab.
 886                             </para>
 887                         </listitem>
 888                     </varlistentry>
 889
 890                     <!-- DOM Storage. -->
 891                     <varlistentry id="on-the-fly-settings-dom-storage">
 892                         <term>
 893                             <menuchoice>
 894                                 <shortcut>
 895                                     <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
 896                                 </shortcut>
 897
 898                                 <guimenu>On-The-Fly Settings</guimenu>
 899
 900                                 <guimenuitem>DOM Storage</guimenuitem>
 901                             </menuchoice>
 902                         </term>
 903
 904                         <listitem>
 905                             <para>
 906                                 Toggle DOM storage in the current tab.
 907                             </para>
 908                         </listitem>
 909                     </varlistentry>
 910                 </variablelist>
 911
 912                 <!-- User Agent. -->
 913                 <sect3>
 914                     <title>User Agent</title>
 915
 916                     <variablelist>
 917                         <!-- Privacy Browser. -->
 918                         <varlistentry id="user-agent-privacy-browser">
 919                             <term>
 920                                 <menuchoice>
 921                                     <shortcut>
 922                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>P</keycap></keycombo>
 923                                     </shortcut>
 924
 925                                     <guimenu>On-The-Fly Settings</guimenu>
 926
 927                                     <guisubmenu>User Agent</guisubmenu>
 928
 929                                     <guimenuitem>Privacy Browser</guimenuitem>
 930                                 </menuchoice>
 931                             </term>
 932
 933                             <listitem>
 934                                 <para>
 935                                     Use the Privacy Browser user agent for the current tab.
 936                                 </para>
 937                             </listitem>
 938                         </varlistentry>
 939
 940                         <!-- WebEngine Default. -->
 941                         <varlistentry id="user-agent-webengine-default">
 942                             <term>
 943                                 <menuchoice>
 944                                     <shortcut>
 945                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>W</keycap></keycombo>
 946                                     </shortcut>
 947
 948                                     <guimenu>On-The-Fly Settings</guimenu>
 949
 950                                     <guisubmenu>User Agent</guisubmenu>
 951
 952                                     <guimenuitem>WebEngine Default</guimenuitem>
 953                                 </menuchoice>
 954                             </term>
 955
 956                             <listitem>
 957                                 <para>
 958                                     Use the WebEngine Default user agent for the current tab.
 959                                 </para>
 960                             </listitem>
 961                         </varlistentry>
 962
 963                         <!-- Firefox on Linux. -->
 964                         <varlistentry id="user-agent-firefox-linux">
 965                             <term>
 966                                 <menuchoice>
 967                                     <shortcut>
 968                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>F</keycap></keycombo>
 969                                     </shortcut>
 970
 971                                     <guimenu>On-The-Fly Settings</guimenu>
 972
 973                                     <guisubmenu>User Agent</guisubmenu>
 974
 975                                     <guimenuitem>Firefox on Linux</guimenuitem>
 976                                 </menuchoice>
 977                             </term>
 978
 979                             <listitem>
 980                                 <para>
 981                                     Use the Firefox on Linux user agent for the current tab.
 982                                 </para>
 983                             </listitem>
 984                         </varlistentry>
 985
 986                         <!-- Chromium on Linux. -->
 987                         <varlistentry id="user-agent-chromium-linux">
 988                             <term>
 989                                 <menuchoice>
 990                                     <shortcut>
 991                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo>
 992                                     </shortcut>
 993
 994                                     <guimenu>On-The-Fly Settings</guimenu>
 995
 996                                     <guisubmenu>User Agent</guisubmenu>
 997
 998                                     <guimenuitem>Chromium on Linux</guimenuitem>
 999                                 </menuchoice>
1000                             </term>
1001
1002                             <listitem>
1003                                 <para>
1004                                     Use the Chromium on Linux user agent for the current tab.
1005                                 </para>
1006                             </listitem>
1007                         </varlistentry>
1008
1009                         <!-- Firefox on Windows. -->
1010                         <varlistentry id="user-agent-firefox-windows">
1011                             <term>
1012                                 <menuchoice>
1013                                     <shortcut>
1014                                         <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>F</keycap></keycombo>
1015                                     </shortcut>
1016
1017                                     <guimenu>On-The-Fly Settings</guimenu>
1018
1019                                     <guisubmenu>User Agent</guisubmenu>
1020
1021                                     <guimenuitem>Firefox on Windows</guimenuitem>
1022                                 </menuchoice>
1023                             </term>
1024
1025                             <listitem>
1026                                 <para>
1027                                     Use the Firefox on Windows user agent for the current tab.
1028                                 </para>
1029                             </listitem>
1030                         </varlistentry>
1031
1032                         <!-- Chrome on Windows. -->
1033                         <varlistentry id="user-agent-chrome-windows">
1034                             <term>
1035                                 <menuchoice>
1036                                     <shortcut>
1037                                         <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>C</keycap></keycombo>
1038                                     </shortcut>
1039
1040                                     <guimenu>On-The-Fly Settings</guimenu>
1041
1042                                     <guisubmenu>User Agent</guisubmenu>
1043
1044                                     <guimenuitem>Chrome on Windows</guimenuitem>
1045                                 </menuchoice>
1046                             </term>
1047
1048                             <listitem>
1049                                 <para>
1050                                     Use the Chrome on Windows user agent for the current tab.
1051                                 </para>
1052                             </listitem>
1053                         </varlistentry>
1054
1055                         <!-- Edge on Windows. -->
1056                         <varlistentry id="user-agent-edge-windows">
1057                             <term>
1058                                 <menuchoice>
1059                                     <shortcut>
1060                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>E</keycap></keycombo>
1061                                     </shortcut>
1062
1063                                     <guimenu>On-The-Fly Settings</guimenu>
1064
1065                                     <guisubmenu>User Agent</guisubmenu>
1066
1067                                     <guimenuitem>Edge on Windows</guimenuitem>
1068                                 </menuchoice>
1069                             </term>
1070
1071                             <listitem>
1072                                 <para>
1073                                     Use the Edge on Windows user agent for the current tab.
1074                                 </para>
1075                             </listitem>
1076                         </varlistentry>
1077
1078                         <!-- Safari on macOS. -->
1079                         <varlistentry id="user-agent-safari-macOS">
1080                             <term>
1081                                 <menuchoice>
1082                                     <shortcut>
1083                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo>
1084                                     </shortcut>
1085
1086                                     <guimenu>On-The-Fly Settings</guimenu>
1087
1088                                     <guisubmenu>User Agent</guisubmenu>
1089
1090                                     <guimenuitem>Safari on macOS</guimenuitem>
1091                                 </menuchoice>
1092                             </term>
1093
1094                             <listitem>
1095                                 <para>
1096                                     Use the Safari on macOS user agent for the current tab.
1097                                 </para>
1098                             </listitem>
1099                         </varlistentry>
1100
1101                         <!-- Custom User Agent. -->
1102                         <varlistentry id="user-agent-custom">
1103                             <term>
1104                                 <menuchoice>
1105                                     <shortcut>
1106                                         <keycombo action="simul">&Alt;&Shift;<keycap>C</keycap></keycombo>
1107                                     </shortcut>
1108
1109                                     <guimenu>On-The-Fly Settings</guimenu>
1110
1111                                     <guisubmenu>User Agent</guisubmenu>
1112
1113                                     <guimenuitem>Custom</guimenuitem>
1114                                 </menuchoice>
1115                             </term>
1116
1117                             <listitem>
1118                                 <para>
1119                                     Use the custom user agent for the current tab. This action is only active if a custom user agent is set in the settings.
1120                                 </para>
1121                             </listitem>
1122                         </varlistentry>
1123                     </variablelist>
1124                 </sect3>
1125
1126                 <!-- Zoom. -->
1127                 <sect3>
1128                     <title>Zoom</title>
1129
1130                     <variablelist>
1131                         <!-- Zoom Factor. -->
1132                         <varlistentry id="on-the-fly-settings-zoom-factor">
1133                             <term>
1134                                 <menuchoice>
1135                                     <shortcut>
1136                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>Z</keycap></keycombo>
1137                                     </shortcut>
1138
1139                                     <guimenu>On-The-Fly Settings</guimenu>
1140
1141                                     <guimenuitem>Zoom Factor</guimenuitem>
1142                                 </menuchoice>
1143                             </term>
1144
1145                             <listitem>
1146                                 <para>
1147                                     Display the zoom factor dialog.
1148                                 </para>
1149                             </listitem>
1150                         </varlistentry>
1151                     </variablelist>
1152                 </sect3>
1153
1154                 <!-- Search Engine. -->
1155                 <sect3>
1156                     <title>Search Engine</title>
1157
1158                     <variablelist>
1159                         <!-- Mojeek. -->
1160                         <varlistentry id="search-engine-mojeek">
1161                             <term>
1162                                 <menuchoice>
1163                                     <shortcut>
1164                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>M</keycap></keycombo>
1165                                     </shortcut>
1166
1167                                     <guimenu>On-The-Fly Settings</guimenu>
1168
1169                                     <guisubmenu>Search Engine</guisubmenu>
1170
1171                                     <guimenuitem>Mojeek</guimenuitem>
1172                                 </menuchoice>
1173                             </term>
1174
1175                             <listitem>
1176                                 <para>
1177                                     Use Mojeek as the search engine.
1178                                 </para>
1179                             </listitem>
1180                         </varlistentry>
1181
1182                         <!-- Monocles. -->
1183                         <varlistentry id="search-engine-monocles">
1184                             <term>
1185                                 <menuchoice>
1186                                     <shortcut>
1187                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo>
1188                                     </shortcut>
1189
1190                                     <guimenu>On-The-Fly Settings</guimenu>
1191
1192                                     <guisubmenu>Search Engine</guisubmenu>
1193
1194                                     <guimenuitem>Monocles</guimenuitem>
1195                                 </menuchoice>
1196                             </term>
1197
1198                             <listitem>
1199                                 <para>
1200                                     Use Mojeek as the search engine.
1201                                 </para>
1202                             </listitem>
1203                         </varlistentry>
1204
1205                         <!-- MetaGer. -->
1206                         <varlistentry id="search-engine-metager">
1207                             <term>
1208                                 <menuchoice>
1209                                     <shortcut>
1210                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>E</keycap></keycombo>
1211                                     </shortcut>
1212
1213                                     <guimenu>On-The-Fly Settings</guimenu>
1214
1215                                     <guisubmenu>Search Engine</guisubmenu>
1216
1217                                     <guimenuitem>MetaGer</guimenuitem>
1218                                 </menuchoice>
1219                             </term>
1220
1221                             <listitem>
1222                                 <para>
1223                                     Use MetaGer as the search engine.
1224                                 </para>
1225                             </listitem>
1226                         </varlistentry>
1227
1228                         <!-- Google. -->
1229                         <varlistentry id="search-engine-google">
1230                             <term>
1231                                 <menuchoice>
1232                                     <shortcut>
1233                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>G</keycap></keycombo>
1234                                     </shortcut>
1235
1236                                     <guimenu>On-The-Fly Settings</guimenu>
1237
1238                                     <guisubmenu>Search Engine</guisubmenu>
1239
1240                                     <guimenuitem>Google</guimenuitem>
1241                                 </menuchoice>
1242                             </term>
1243
1244                             <listitem>
1245                                 <para>
1246                                     Use Google as the search engine.
1247                                 </para>
1248                             </listitem>
1249                         </varlistentry>
1250
1251                         <!-- Bing. -->
1252                         <varlistentry id="search-engine-bing">
1253                             <term>
1254                                 <menuchoice>
1255                                     <shortcut>
1256                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo>
1257                                     </shortcut>
1258
1259                                     <guimenu>On-The-Fly Settings</guimenu>
1260
1261                                     <guisubmenu>Search Engine</guisubmenu>
1262
1263                                     <guimenuitem>Bing</guimenuitem>
1264                                 </menuchoice>
1265                             </term>
1266
1267                             <listitem>
1268                                 <para>
1269                                     Use Bing as the search engine.
1270                                 </para>
1271                             </listitem>
1272                         </varlistentry>
1273
1274                         <!-- Yahoo. -->
1275                         <varlistentry id="search-engine-yahoo">
1276                             <term>
1277                                 <menuchoice>
1278                                     <shortcut>
1279                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>Y</keycap></keycombo>
1280                                     </shortcut>
1281
1282                                     <guimenu>On-The-Fly Settings</guimenu>
1283
1284                                     <guisubmenu>Search Engine</guisubmenu>
1285
1286                                     <guimenuitem>Yahoo</guimenuitem>
1287                                 </menuchoice>
1288                             </term>
1289
1290                             <listitem>
1291                                 <para>
1292                                     Use Yahoo as the search engine.
1293                                 </para>
1294                             </listitem>
1295                         </varlistentry>
1296
1297                         <!-- Custom Search Engine. -->
1298                         <varlistentry id="search-engine-custom">
1299                             <term>
1300                                 <menuchoice>
1301                                     <shortcut>
1302                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo>
1303                                     </shortcut>
1304
1305                                     <guimenu>On-The-Fly Settings</guimenu>
1306
1307                                     <guisubmenu>Search Engine</guisubmenu>
1308
1309                                     <guimenuitem>Custom</guimenuitem>
1310                                 </menuchoice>
1311                             </term>
1312
1313                             <listitem>
1314                                 <para>
1315                                     Use the custom search engine. This action is only active if a custom search engine is set in the settings.
1316                                 </para>
1317                             </listitem>
1318                         </varlistentry>
1319                     </variablelist>
1320                 </sect3>
1321             </sect2>
1322
1323             <!-- Bookmarks. -->
1324             <sect2>
1325                 <title>Bookmarks</title>
1326
1327                 <variablelist>
1328                     <!-- Edit Bookmarks. -->
1329                     <varlistentry id="bookmarks-edit-bookmarks">
1330                         <term>
1331                             <menuchoice>
1332                                 <shortcut>
1333                                     <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>B</keycap></keycombo>
1334                                 </shortcut>
1335
1336                                 <guimenu>Bookmarks</guimenu>
1337
1338                                 <guimenuitem>Edit Bookamrks</guimenuitem>
1339                             </menuchoice>
1340                         </term>
1341
1342                         <listitem>
1343                             <para>
1344                                 Open the bookmark editing dialog.
1345                             </para>
1346                         </listitem>
1347                     </varlistentry>
1348
1349                     <!-- View Bookmarks Toolbar. -->
1350                     <varlistentry id="bookmarks-view-bookmarks-toolbar">
1351                         <term>
1352                             <menuchoice>
1353                                 <shortcut>
1354                                     <keycombo action="simul">&Ctrl;&Alt;<keycap>B</keycap></keycombo>
1355                                 </shortcut>
1356
1357                                 <guimenu>Bookmarks</guimenu>
1358
1359                                 <guimenuitem>View Bookmarks Toolbar</guimenuitem>
1360                             </menuchoice>
1361                         </term>
1362
1363                         <listitem>
1364                             <para>
1365                                 Toggle the visibility of the bookmarks toolbar.
1366                             </para>
1367                         </listitem>
1368                     </varlistentry>
1369
1370                     <!-- Add Bookmark. -->
1371                     <varlistentry id="bookmarks-add-bookmark">
1372                         <term>
1373                             <menuchoice>
1374                                 <shortcut>
1375                                     <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
1376                                 </shortcut>
1377
1378                                 <guimenu>Bookmarks</guimenu>
1379
1380                                 <guimenuitem>Add Bookmark</guimenuitem>
1381                             </menuchoice>
1382                         </term>
1383
1384                         <listitem>
1385                             <para>
1386                                 Add a new bookmark.
1387                             </para>
1388                         </listitem>
1389                     </varlistentry>
1390
1391                     <!-- Add Folder. -->
1392                     <varlistentry id="bookmarks-add-folder">
1393                         <term>
1394                             <menuchoice>
1395                                 <shortcut>
1396                                     <keycombo action="simul">&Meta;<keycap>F</keycap></keycombo>
1397                                 </shortcut>
1398
1399                                 <guimenu>Bookmarks</guimenu>
1400
1401                                 <guimenuitem>Add Folder</guimenuitem>
1402                             </menuchoice>
1403                         </term>
1404
1405                         <listitem>
1406                             <para>
1407                                 Add a bookmark folder.  The meta key on most keyboards is the Windows key.
1408                             </para>
1409                         </listitem>
1410                     </varlistentry>
1411                 </variablelist>
1412             </sect2>
1413
1414             <!-- Settings. -->
1415             <sect2>
1416                 <title>Settings</title>
1417
1418                 <variablelist>
1419                     <!-- Domain Settings. -->
1420                     <varlistentry id="settings-domain-settings">
1421                         <term>
1422                             <menuchoice>
1423                                 <shortcut>
1424                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo>
1425                                 </shortcut>
1426
1427                                 <guimenu>Settings</guimenu>
1428
1429                                 <guimenuitem>Domain Settings</guimenuitem>
1430
1431                             </menuchoice>
1432                         </term>
1433
1434                         <listitem>
1435                             <para>
1436                                 Display the domain settings dialog.
1437                             </para>
1438                         </listitem>
1439                     </varlistentry>
1440
1441                     <!-- Cookies. -->
1442                     <varlistentry id="settings-cookies">
1443                         <term>
1444                             <menuchoice>
1445                                 <shortcut>
1446                                     <keycombo action="simul">&Ctrl;<keycap>;</keycap></keycombo>
1447                                 </shortcut>
1448
1449                                 <guimenu>Settings</guimenu>
1450
1451                                 <guimenuitem>Cookies</guimenuitem>
1452                             </menuchoice>
1453                         </term>
1454
1455                         <listitem>
1456                             <para>
1457                                 Display the cookies dialog.
1458                             </para>
1459                         </listitem>
1460                     </varlistentry>
1461                 </variablelist>
1462             </sect2>
1463
1464             <!-- Common Settings and Help Entries. -->
1465             <sect2 id="common-settings-help-menus">
1466                 <title>Common Settings and Help Entries</title>
1467
1468                 <para>
1469                     &privacybrowser; has many common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu> menu items.
1470                     For more information read the sections about the <ulink url="help:/fundamentals/ui.html#menus-settings">Settings Menu</ulink>
1471                     and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>.
1472                 </para>
1473             </sect2>
1474
1475             <!-- Other Commands. -->
1476             <sect2>
1477                 <title>Other Commands</title>
1478
1479                 <variablelist>
1480                     <!-- Find Case Sensitive. -->
1481                     <varlistentry id="find-case-sensitive">
1482                         <term>
1483                             <command>
1484                                 &Ctrl;+<keycap>S</keycap>
1485                             </command>
1486                         </term>
1487
1488                         <listitem>
1489                             <para>
1490                                 Toggle find case sensitive if the find toolbar is visible.
1491                             </para>
1492                         </listitem>
1493                     </varlistentry>
1494
1495                     <!-- Open link in new tab. -->
1496                     <varlistentry id="new-tab">
1497                         <term>
1498                             <command>
1499                                 &Ctrl;+&Shift;+Click
1500                             </command>
1501                         </term>
1502
1503                         <listitem>
1504                             <para>
1505                                 Open link in new tab. This performs the same action as right-clicking on the link and selecting “Open link in new tab”.
1506                             </para>
1507                         </listitem>
1508                     </varlistentry>
1509
1510                     <!-- Open link in background tab. -->
1511                     <varlistentry id="new-background-tab">
1512                         <term>
1513                             <command>
1514                                 &Ctrl;+Click
1515                             </command>
1516                         </term>
1517
1518                         <listitem>
1519                             <para>
1520                                 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”.
1521                             </para>
1522                         </listitem>
1523                     </varlistentry>
1524
1525                     <!-- Open link in new window. -->
1526                     <varlistentry id="new-window">
1527                         <term>
1528                             <command>
1529                                 &Shift;+Click
1530                             </command>
1531                         </term>
1532
1533                         <listitem>
1534                             <para>
1535                                 Open link in new window. This performs the same action as right-clicking on the link and selecting “Open link in new window”.
1536                             </para>
1537                         </listitem>
1538                     </varlistentry>
1539
1540                     <!-- Save link. -->
1541                     <varlistentry id="save-link">
1542                         <term>
1543                             <command>
1544                                 &Alt;+Click
1545                             </command>
1546                         </term>
1547
1548                         <listitem>
1549                             <para>
1550                                 Save link. This performs the same action as right-clicking on the link and selecting “Save link”.
1551                             </para>
1552                         </listitem>
1553                     </varlistentry>
1554
1555                     <!-- F11. -->
1556                     <varlistentry id="f11">
1557                         <term>
1558                             <command>
1559                                 <keycap>F11</keycap>
1560                             </command>
1561                         </term>
1562
1563                         <listitem>
1564                             <para>
1565                                 Toggle full screen mode. This performs the same action as <xref linkend="view-full-screen-mode"/>.
1566                             </para>
1567                         </listitem>
1568                     </varlistentry>
1569
1570                     <!-- Escape. -->
1571                     <varlistentry id="escape">
1572                         <term>
1573                             <command>
1574                                 <keycap>&Esc;</keycap>
1575                             </command>
1576                         </term>
1577
1578                         <listitem>
1579                             <para>
1580                                 Escape runs the first command that applies from the following list.
1581                             </para>
1582
1583                             <itemizedlist>
1584                                 <listitem>
1585                                     <para>
1586                                         Exit full screen browsing.
1587                                     </para>
1588                                 </listitem>
1589
1590                                 <listitem>
1591                                     <para>
1592                                         Clear the find text line edit and the find text highlights.
1593                                     </para>
1594                                 </listitem>
1595
1596                                 <listitem>
1597                                     <para>
1598                                         Hide the find text toolbar.
1599                                     </para>
1600                                 </listitem>
1601                             </itemizedlist>
1602                         </listitem>
1603                     </varlistentry>
1604                 </variablelist>
1605             </sect2>
1606         </sect1>
1607
1608         <!-- Cookies Dialog. -->
1609         <sect1 id="cookies-dialog">
1610             <title>Cookies Dialog</title>
1611
1612             <para>
1613                 The cookies dialog is accessed through <xref linkend="settings-cookies"/> (see <xref linkend="cookies"/>).
1614             </para>
1615
1616             <sect2 id="cookies-dialog-commands">
1617                 <title>Commands</title>
1618
1619                 <variablelist>
1620                     <!-- Add Cookie. -->
1621                     <varlistentry id="add-cookie">
1622                         <term>
1623                             <command>
1624                                 <keycap>A</keycap>
1625                             </command>
1626                         </term>
1627
1628                         <listitem>
1629                             <para>
1630                                 Open the add cookie dialog.
1631                             </para>
1632                         </listitem>
1633                     </varlistentry>
1634
1635                     <!-- Edit Cookie. -->
1636                     <varlistentry id="edit-cookie">
1637                         <term>
1638                             <command>
1639                                 <keycap>E</keycap>
1640                             </command>
1641                         </term>
1642
1643                         <listitem>
1644                             <para>
1645                                 Open the edit cookie dialog. This command is only valid if a cookie is currently selected.
1646                             </para>
1647                         </listitem>
1648                     </varlistentry>
1649
1650                     <!-- Delete Cookies. -->
1651                     <varlistentry id="delete-cookies">
1652                         <term>
1653                             <command>
1654                                 <keycap>D</keycap> or <keycap>&Del;</keycap>
1655                             </command>
1656                         </term>
1657
1658                         <listitem>
1659                             <para>
1660                                 Delete the currently selected cookies. A dialog will confirm the deletion before it is processed.
1661                             </para>
1662                         </listitem>
1663                     </varlistentry>
1664
1665                     <!-- Delete All Cookies. -->
1666                     <varlistentry id="delete-all-cookie">
1667                         <term>
1668                             <command>
1669                                 <keycap>L</keycap>
1670                             </command>
1671                         </term>
1672
1673                         <listitem>
1674                             <para>
1675                                 Delete all the cookies. A dialog will confirm the deletion before it is processed.
1676                             </para>
1677                         </listitem>
1678                     </varlistentry>
1679
1680                     <!-- Close. -->
1681                     <varlistentry id="close-cookies-dialog">
1682                         <term>
1683                             <command>
1684                                 <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
1685                             </command>
1686                         </term>
1687
1688                         <listitem>
1689                             <para>
1690                                 Close the cookies dialog.
1691                             </para>
1692                         </listitem>
1693                     </varlistentry>
1694                 </variablelist>
1695             </sect2>
1696         </sect1>
1697
1698         <!-- Save Dialog. -->
1699         <sect1 id="save-dialog">
1700             <title>Save Dialog</title>
1701
1702             <para>
1703                 The save dialog pops up when a download is initiated.
1704             </para>
1705
1706             <sect2 id="save-dialog-commands">
1707                 <title>Commands</title>
1708
1709                 <variablelist>
1710                     <!-- Save. -->
1711                     <varlistentry id="save-dialog-save">
1712                         <term>
1713                             <command>
1714                                 <keycap>S</keycap>
1715                             </command>
1716                         </term>
1717
1718                         <listitem>
1719                             <para>
1720                                 Save the file.
1721                             </para>
1722                         </listitem>
1723                     </varlistentry>
1724
1725                     <!-- Close. -->
1726                     <varlistentry id="save-dialog-close">
1727                         <term>
1728                             <command>
1729                                 <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
1730                             </command>
1731                         </term>
1732
1733                         <listitem>
1734                             <para>
1735                                 Close the save dialog without saving the file.
1736                             </para>
1737                         </listitem>
1738                     </varlistentry>
1739                 </variablelist>
1740             </sect2>
1741         </sect1>
1742     </chapter>
1743
1744     <!-- Changelog. -->
1745     <chapter id="changelog">
1746         <title>Changelog</title>
1747
1748         <!-- Version 0.5. -->
1749         <sect1 id="version_0.5">
1750             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-5/">0.5</ulink> -
1751                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=a385ca128cb7bcc34ab5467edf21eb5e5664471a;ds=sidebyside">12 October 2023</ulink></title>
1752
1753             <itemizedlist>
1754                 <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/968">bookmarks</ulink>.</para></listitem>
1755                 <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/1031">zoom controls</ulink> to the status bar and a
1756                         <ulink url="https://redmine.stoutner.com/issues/1044">default zoom shortcut</ulink>.</para></listitem>
1757                 <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/1037">keyboard shortcuts</ulink> for the URL toolbar actions.</para></listitem>
1758                 <listitem><para>Add an action to <ulink url="https://redmine.stoutner.com/issues/1022">view page source</ulink>.</para></listitem>
1759                 <listitem><para>Change the <ulink url="https://redmine.stoutner.com/issues/1019">domain settings combo boxes</ulink> to list
1760                         <code>enabled</code> above <code>disabled</code>.</para></listitem>
1761                 <listitem><para>File downloads can now <ulink url="https://redmine.stoutner.com/issues/869">show the size</ulink> before the download begins.</para></listitem>
1762                 <listitem><para>Add PIE (<ulink url="https://redmine.stoutner.com/issues/1021">Position Independent Executable</ulink>) compiler flags.</para></listitem>
1763                 <listitem><para>Fix a bug that sometimes allowed <ulink url="https://redmine.stoutner.com/issues/1018">multiple domain settings to be created</ulink>.</para></listitem>
1764                 <listitem><para>Fix the download notification <ulink url="https://redmine.stoutner.com/issues/1017">not being cleared on Xfce</ulink>.</para></listitem>
1765             </itemizedlist>
1766         </sect1>
1767
1768         <!-- Version 0.4. -->
1769         <sect1 id="version_0.4">
1770             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-4/">0.4</ulink> -
1771                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=b4c8c8d02113d14c2a07751eb3b0c1bdeec7abb4">13 June 2023</ulink></title>
1772
1773             <itemizedlist>
1774                 <listitem><para>Add a setting to <ulink url="https://redmine.stoutner.com/issues/1002">control spatial navigation</ulink>.</para></listitem>
1775                 <listitem><para>Add an action to <ulink url="https://redmine.stoutner.com/issues/982">reload and bypass cache</ulink>.</para></listitem>
1776                 <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>
1777                 <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/1009">keyboard+click commands</ulink> to the Handbook.</para></listitem>
1778             </itemizedlist>
1779         </sect1>
1780
1781         <!-- Version 0.3. -->
1782         <sect1 id="version_0.3">
1783             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-3/">0.3</ulink> -
1784                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=ace098e8677ac0d6468b825c73e65b82c0d6993e">8 May 2023</ulink></title>
1785
1786             <itemizedlist>
1787                 <listitem><para>Add the changelog <ulink url="https://redmine.stoutner.com/issues/1000">to the Handbook</ulink>.</para></listitem>
1788                 <listitem><para>Add the missing <ulink url="https://redmine.stoutner.com/issues/999">current domain settings icon</ulink> on Gnome and Xfce.</para></listitem>
1789                 <listitem><para>Make changes to <ulink url="https://redmine.stoutner.com/issues/1005">build on Guix</ulink>.</para></listitem>
1790             </itemizedlist>
1791         </sect1>
1792
1793         <!-- Version 0.2. -->
1794         <sect1 id="version_0.2">
1795             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-2/">0.2</ulink> -
1796                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=44b5d3a1f6a5e7fc2aa8530845f26eba7bc26f9a">17 April 2023</ulink></title>
1797
1798             <itemizedlist>
1799                 <listitem><para>Fix a crash on GNOME when <ulink url="https://redmine.stoutner.com/issues/994">downloading a file</ulink> with local storage disabled.</para></listitem>
1800                 <listitem><para>Fix problems with <ulink url="https://redmine.stoutner.com/issues/992">missing</ulink>
1801                     <ulink url="https://redmine.stoutner.com/issues/993">icons</ulink> on GNOME.</para></listitem>
1802                 <listitem><para>Display an <ulink url="https://redmine.stoutner.com/issues/980">animated favorite icon</ulink> while a webpage is loading.</para></listitem>
1803                 <listitem><para><ulink url="https://redmine.stoutner.com/issues/975">Fix the Handbook</ulink> on non-KDE systems.</para></listitem>
1804                 <listitem><para>Change the <ulink url="https://redmine.stoutner.com/issues/978">order of entries</ulink> in the WebEngine context menu.</para></listitem>
1805                 <listitem><para>Make spellcheck languages <ulink url="https://redmine.stoutner.com/issues/958">easier to click on</ulink>.</para></listitem>
1806                 <listitem><para>Only generate a HTTP ping dialog if the <ulink url="https://redmine.stoutner.com/issues/979">request is made by the current tab</ulink>.</para></listitem>
1807                 <listitem><para>Add a section to the Handbook about <ulink url="https://redmine.stoutner.com/issues/976">HTTP pings</ulink>.</para></listitem>
1808             </itemizedlist>
1809         </sect1>
1810
1811         <!-- Version 0.1. -->
1812         <sect1 id="version_0.1">
1813             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-1/">0.1</ulink> -
1814                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=73459c6685ec5e58d776f2594c9b587802363b1c">11 March 2023</ulink></title>
1815
1816             <itemizedlist>
1817                 <listitem><para>Initial release.</para></listitem>
1818             </itemizedlist>
1819         </sect1>
1820     </chapter>
1821
1822     <!-- FAQ. -->
1823     <chapter id="faq">
1824         <title>Questions and Answers</title>
1825
1826         <qandaset id="faqlist">
1827             <qandaentry>
1828                 <!-- Why are there no questions. -->
1829                 <question>
1830                     <para>
1831                         Why are there no questions?
1832                     </para>
1833                 </question>
1834
1835                 <answer>
1836                     <para>
1837                         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. ;)
1838                     </para>
1839                 </answer>
1840             </qandaentry>
1841         </qandaset>
1842     </chapter>
1843
1844     <!-- Credits. -->
1845     <chapter id="credits">
1846         <title>Credits and License</title>
1847
1848         <para>
1849             Privacy Browser PC copyright 2016-2017,2021-2024 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
1850         </para>
1851
1852         <!-- Program. -->
1853         <sect1 id="program">
1854             <title>Program</title>
1855
1856             <para>
1857                 The source code is available at <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=summary">gitweb.stoutner.com</ulink>
1858                 or by running <filename>git clone https://git.stoutner.com/PrivacyBrowserPC.git</filename>.
1859             </para>
1860
1861             <para>
1862                 Translators:
1863                 <itemizedlist>
1864                     <listitem>
1865                         <para>
1866                             Translations will be added in a future release.
1867                         </para>
1868                     </listitem>
1869                 </itemizedlist>
1870             </para>
1871
1872             <!-- The program license. -->
1873             &underGPL;
1874         </sect1>
1875
1876         <!-- Documentation. -->
1877         <sect1 id="documentation">
1878             <title>Documentation</title>
1879
1880             <para>
1881                 <filename>doc/index.docbook</filename> and <filename>src/com.stoutner.privacybrowser.appdata.xml</filename> are released under the
1882                 <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.
1883                 All other documentation is released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
1884             </para>
1885
1886             <!-- The documentation license. -->
1887             &underFDL;
1888         </sect1>
1889
1890         <!-- Icons. -->
1891         <sect1 id="icons">
1892             <title>Icons</title>
1893
1894             <para>
1895                 <inlinemediaobject>
1896                     <imageobject>
1897                         <imagedata fileref="privacybrowser.png" format="PNG"/>
1898                     </imageobject>
1899
1900                     <textobject>
1901                         <phrase>
1902                             Privacy Browser
1903                         </phrase>
1904                     </textobject>
1905                 </inlinemediaobject>
1906
1907                 <inlinemediaobject>
1908                     <imageobject>
1909                         <imagedata fileref="javascript.png" format="PNG"/>
1910                     </imageobject>
1911
1912                     <textobject>
1913                         <phrase>
1914                             JavaScript
1915                         </phrase>
1916                     </textobject>
1917                 </inlinemediaobject>
1918
1919                 <inlinemediaobject>
1920                     <imageobject>
1921                         <imagedata fileref="privacybrowser-monochrome.png" format="PNG"/>
1922                     </imageobject>
1923
1924                     <textobject>
1925                         <phrase>
1926                             Privacy Browser Monochrome
1927                         </phrase>
1928                     </textobject>
1929                 </inlinemediaobject>
1930
1931                 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>
1932                 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.
1933                 The resulting images are released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
1934             </para>
1935
1936             <para>
1937                 <inlinemediaobject>
1938                     <imageobject>
1939                         <imagedata fileref="loading.gif" format="GIF"/>
1940                     </imageobject>
1941
1942                     <textobject>
1943                         <phrase>
1944                             Loading
1945                         </phrase>
1946                     </textobject>
1947                 </inlinemediaobject>
1948
1949                 comes from <ulink url="https://github.com/Codelessly/FlutterLoadingGIFs/blob/master/packages/cupertino_activity_indicator_selective.gif">FlutterLoadingGIFs</ulink>
1950                 where it is named <filename>cupertino_activity_indicator_selective.gif</filename>.
1951                 It is released under the <ulink url="https://opensource.org/license/0bsd/">Zero-Clause BSD License</ulink>.
1952             </para>
1953         </sect1>
1954     </chapter>
1955 </book>