doc/index.docbook

   1 <?xml version="1.0" ?>
   2
   3 <!--
   4   Copyright 2023 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-2023</year>
  40             <holder>&Soren.Stoutner;</holder>
  41         </copyright>
  42
  43         <!-- Documentation license. -->
  44         <legalnotice>&FDLNotice;</legalnotice>
  45
  46         <!-- Last update. -->
  47         <date>2023-10-10</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                     <!-- Print. -->
 398                     <varlistentry  id="file-print">
 399                         <term>
 400                             <menuchoice>
 401                                 <shortcut>
 402                                     <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
 403                                 </shortcut>
 404
 405                                 <guimenu>File</guimenu>
 406
 407                                 <guimenuitem>Print</guimenuitem>
 408                             </menuchoice>
 409                         </term>
 410
 411                         <listitem>
 412                             <para>
 413                                 Print the document.
 414                             </para>
 415                         </listitem>
 416                     </varlistentry>
 417
 418                     <!-- Print Preview. -->
 419                     <varlistentry  id="file-print-preview">
 420                         <term>
 421                             <menuchoice>
 422                                 <shortcut>
 423                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>P</keycap></keycombo>
 424                                 </shortcut>
 425
 426                                 <guimenu>File</guimenu>
 427
 428                                 <guimenuitem>Print Preview</guimenuitem>
 429                             </menuchoice>
 430                         </term>
 431
 432                         <listitem>
 433                             <para>
 434                                 Display the print preview dialog.
 435                             </para>
 436                         </listitem>
 437                     </varlistentry>
 438
 439                     <!-- Quit. -->
 440                     <varlistentry  id="file-quit">
 441                         <term>
 442                             <menuchoice>
 443                                 <shortcut>
 444                                     <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 445                                 </shortcut>
 446
 447                                 <guimenu>File</guimenu>
 448
 449                                 <guimenuitem>Quit</guimenuitem>
 450                             </menuchoice>
 451                         </term>
 452
 453                         <listitem>
 454                             <para>
 455                                 Quit &privacybrowser;.
 456                             </para>
 457                         </listitem>
 458                     </varlistentry>
 459                 </variablelist>
 460             </sect2>
 461
 462             <!-- Edit. -->
 463             <sect2>
 464                 <title>Edit</title>
 465
 466                 <variablelist>
 467                     <!-- Find. -->
 468                     <varlistentry id="edit-find">
 469                         <term>
 470                             <menuchoice>
 471                                 <shortcut>
 472                                     <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
 473                                 </shortcut>
 474
 475                                 <guimenu>Edit</guimenu>
 476
 477                                 <guimenuitem>Find</guimenuitem>
 478                             </menuchoice>
 479                         </term>
 480
 481                         <listitem>
 482                             <para>
 483                                 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.
 484                             </para>
 485                         </listitem>
 486                     </varlistentry>
 487
 488
 489                     <!-- Find Next. -->
 490                     <varlistentry id="edit-find-next">
 491                         <term>
 492                             <menuchoice>
 493                                 <shortcut>
 494                                     <keycap>F3</keycap>
 495                                 </shortcut>
 496
 497                                 <guimenu>Edit</guimenu>
 498
 499                                 <guimenuitem>Find Next</guimenuitem>
 500                             </menuchoice>
 501                         </term>
 502
 503                         <listitem>
 504                             <para>
 505                                 Find the next entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible.
 506                             </para>
 507                         </listitem>
 508                     </varlistentry>
 509
 510                     <!-- Find Previous. -->
 511                     <varlistentry id="edit-find-previous">
 512                         <term>
 513                             <menuchoice>
 514                                 <shortcut>
 515                                     <keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo>
 516                                 </shortcut>
 517
 518                                 <guimenu>Edit</guimenu>
 519
 520                                 <guimenuitem>Find Previous</guimenuitem>
 521                             </menuchoice>
 522                         </term>
 523
 524                         <listitem>
 525                             <para>
 526                                 Find the previous 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                 </variablelist>
 531             </sect2>
 532
 533             <!-- View. -->
 534             <sect2>
 535                 <title>View</title>
 536
 537                 <variablelist>
 538                     <!-- Zoom In. -->
 539                     <varlistentry id="zoom-in">
 540                         <term>
 541                             <menuchoice>
 542                                 <shortcut>
 543                                     <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
 544                                 </shortcut>
 545
 546                                 <guimenu>View</guimenu>
 547
 548                                 <guimenuitem>Zoom In</guimenuitem>
 549                             </menuchoice>
 550                         </term>
 551
 552                         <listitem>
 553                             <para>
 554                                 Increment the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
 555                             </para>
 556                         </listitem>
 557                     </varlistentry>
 558
 559
 560                     <!-- Zoom Out. -->
 561                     <varlistentry id="zoom-out">
 562                         <term>
 563                             <menuchoice>
 564                                 <shortcut>
 565                                     <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
 566                                 </shortcut>
 567
 568                                 <guimenu>View</guimenu>
 569
 570                                 <guimenuitem>Zoom Out</guimenuitem>
 571                             </menuchoice>
 572                         </term>
 573
 574                         <listitem>
 575                             <para>
 576                                 Decrement the zoom factor by 0.25. Valid factors range from 0.25 to 5.00.
 577                             </para>
 578                         </listitem>
 579                     </varlistentry>
 580
 581                     <!-- Refresh. -->
 582                     <varlistentry id="view-refresh">
 583                         <term>
 584                             <menuchoice>
 585                                 <shortcut>
 586                                     <keycap>F5</keycap>
 587                                 </shortcut>
 588
 589                                 <guimenu>View</guimenu>
 590
 591                                 <guimenuitem>Refresh</guimenuitem>
 592                             </menuchoice>
 593                         </term>
 594
 595                         <listitem>
 596                             <para>
 597                                 Reload the website in the current tab.
 598                             </para>
 599                         </listitem>
 600                     </varlistentry>
 601
 602                     <!-- Reload and Bypass Cache. -->
 603                     <varlistentry id="view-reload-and-bypass-cache">
 604                         <term>
 605                             <menuchoice>
 606                                 <shortcut>
 607                                     <keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
 608                                 </shortcut>
 609
 610                                 <guimenu>View</guimenu>
 611
 612                                 <guimenuitem>Reload and Bypass Cache</guimenuitem>
 613                             </menuchoice>
 614                         </term>
 615
 616                         <listitem>
 617                             <para>
 618                                 Reload the website in the current tab bypassing any information in the cache and loading everything from the webserver.
 619                             </para>
 620                         </listitem>
 621                     </varlistentry>
 622
 623                     <!-- View Source. -->
 624                     <varlistentry id="view-source">
 625                         <term>
 626                             <menuchoice>
 627                                 <shortcut>
 628                                     <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
 629                                 </shortcut>
 630
 631                                 <guimenu>View</guimenu>
 632
 633                                 <guimenuitem>View Source</guimenuitem>
 634                             </menuchoice>
 635                         </term>
 636
 637                         <listitem>
 638                             <para>
 639                                 Toggle between viewing the source and viewing the rendered website.
 640                             </para>
 641                         </listitem>
 642                     </varlistentry>
 643
 644                     <!-- View Source in New Tab. -->
 645                     <varlistentry id="view-source-in-new-tab">
 646                         <term>
 647                             <menuchoice>
 648                                 <shortcut>
 649                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo>
 650                                 </shortcut>
 651
 652                                 <guimenu>View</guimenu>
 653
 654                                 <guimenuitem>View Source in New Tab></guimenuitem>
 655                             </menuchoice>
 656                         </term>
 657
 658                         <listitem>
 659                             <para>
 660                                 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.
 661                                 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.
 662                             </para>
 663                         </listitem>
 664                     </varlistentry>
 665
 666                     <!-- Full Screen Mode. -->
 667                     <varlistentry id="view-full-screen-mode">
 668                         <term>
 669                             <menuchoice>
 670                                 <shortcut>
 671                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
 672                                 </shortcut>
 673
 674                                 <guimenu>View</guimenu>
 675
 676                                 <guimenuitem>Full Screen Mode</guimenuitem>
 677                             </menuchoice>
 678                         </term>
 679
 680                         <listitem>
 681                             <para>
 682                                 Toggle full screen mode. This performs the same action as <xref linkend="f11"/>.
 683                             </para>
 684                         </listitem>
 685                     </varlistentry>
 686                 </variablelist>
 687             </sect2>
 688
 689             <!-- Go. -->
 690             <sect2>
 691                 <title>Go</title>
 692
 693                 <variablelist>
 694                     <!-- Back. -->
 695                     <varlistentry id="go-back">
 696                         <term>
 697                             <menuchoice>
 698                                 <shortcut>
 699                                     <keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo>
 700                                 </shortcut>
 701
 702                                 <guimenu>Go</guimenu>
 703
 704                                 <guimenuitem>Back</guimenuitem>
 705                             </menuchoice>
 706                         </term>
 707
 708                         <listitem>
 709                             <para>
 710                                 Navigate back one step in the current tab’s history. The action is disabled if it is not possible to go back.
 711                             </para>
 712                         </listitem>
 713                     </varlistentry>
 714
 715                     <!-- Forward. -->
 716                     <varlistentry id="go-forward">
 717                         <term>
 718                             <menuchoice>
 719                                 <shortcut>
 720                                     <keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo>
 721                                 </shortcut>
 722
 723                                 <guimenu>Go</guimenu>
 724
 725                                 <guimenuitem>Forward</guimenuitem>
 726                             </menuchoice>
 727                         </term>
 728
 729                         <listitem>
 730                             <para>
 731                                 Navigate forward one step in the current tab’s history. The action is disabled if it is not possible to go forward.
 732                             </para>
 733                         </listitem>
 734                     </varlistentry>
 735
 736                     <!-- Home. -->
 737                     <varlistentry id="go-home">
 738                         <term>
 739                             <menuchoice>
 740                                 <shortcut>
 741                                     <keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
 742                                 </shortcut>
 743
 744                                 <guimenu>Go</guimenu>
 745
 746                                 <guimenuitem>Home</guimenuitem>
 747                             </menuchoice>
 748                         </term>
 749
 750                         <listitem>
 751                             <para>
 752                                 Load the home page in the current tab.
 753                             </para>
 754                         </listitem>
 755                     </varlistentry>
 756                 </variablelist>
 757             </sect2>
 758
 759             <!-- On-The-Fly Settings. -->
 760             <sect2>
 761                 <title>On-The-Fly Settings</title>
 762
 763                 <variablelist>
 764                     <!-- JavaScript. -->
 765                     <varlistentry id="on-the-fly-settings-javascript">
 766                         <term>
 767                             <menuchoice>
 768                                 <shortcut>
 769                                     <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
 770                                 </shortcut>
 771
 772                                 <guimenu>On-The-Fly Settings</guimenu>
 773
 774                                 <guimenuitem>JavaScript</guimenuitem>
 775                             </menuchoice>
 776                         </term>
 777
 778                         <listitem>
 779                             <para>
 780                                 Toggle JavaScript in the current tab.
 781                             </para>
 782                         </listitem>
 783                     </varlistentry>
 784
 785                     <!-- Local Storage. -->
 786                     <varlistentry id="on-the-fly-settings-local-storage">
 787                         <term>
 788                             <menuchoice>
 789                                 <shortcut>
 790                                     <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
 791                                 </shortcut>
 792
 793                                 <guimenu>On-The-Fly Settings</guimenu>
 794
 795                                 <guimenuitem>Local Storage</guimenuitem>
 796                             </menuchoice>
 797                         </term>
 798
 799                         <listitem>
 800                             <para>
 801                                 Toggle local storage in the current tab.
 802                             </para>
 803                         </listitem>
 804                     </varlistentry>
 805
 806                     <!-- DOM Storage. -->
 807                     <varlistentry id="on-the-fly-settings-dom-storage">
 808                         <term>
 809                             <menuchoice>
 810                                 <shortcut>
 811                                     <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
 812                                 </shortcut>
 813
 814                                 <guimenu>On-The-Fly Settings</guimenu>
 815
 816                                 <guimenuitem>DOM Storage</guimenuitem>
 817                             </menuchoice>
 818                         </term>
 819
 820                         <listitem>
 821                             <para>
 822                                 Toggle DOM storage in the current tab.
 823                             </para>
 824                         </listitem>
 825                     </varlistentry>
 826                 </variablelist>
 827
 828                 <!-- User Agent. -->
 829                 <sect3>
 830                     <title>User Agent</title>
 831
 832                     <variablelist>
 833                         <!-- Privacy Browser. -->
 834                         <varlistentry id="user-agent-privacy-browser">
 835                             <term>
 836                                 <menuchoice>
 837                                     <shortcut>
 838                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>P</keycap></keycombo>
 839                                     </shortcut>
 840
 841                                     <guimenu>On-The-Fly Settings</guimenu>
 842
 843                                     <guisubmenu>User Agent</guisubmenu>
 844
 845                                     <guimenuitem>Privacy Browser</guimenuitem>
 846                                 </menuchoice>
 847                             </term>
 848
 849                             <listitem>
 850                                 <para>
 851                                     Use the Privacy Browser user agent for the current tab.
 852                                 </para>
 853                             </listitem>
 854                         </varlistentry>
 855
 856                         <!-- WebEngine Default. -->
 857                         <varlistentry id="user-agent-webengine-default">
 858                             <term>
 859                                 <menuchoice>
 860                                     <shortcut>
 861                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>W</keycap></keycombo>
 862                                     </shortcut>
 863
 864                                     <guimenu>On-The-Fly Settings</guimenu>
 865
 866                                     <guisubmenu>User Agent</guisubmenu>
 867
 868                                     <guimenuitem>WebEngine Default</guimenuitem>
 869                                 </menuchoice>
 870                             </term>
 871
 872                             <listitem>
 873                                 <para>
 874                                     Use the WebEngine Default user agent for the current tab.
 875                                 </para>
 876                             </listitem>
 877                         </varlistentry>
 878
 879                         <!-- Firefox on Linux. -->
 880                         <varlistentry id="user-agent-firefox-linux">
 881                             <term>
 882                                 <menuchoice>
 883                                     <shortcut>
 884                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>F</keycap></keycombo>
 885                                     </shortcut>
 886
 887                                     <guimenu>On-The-Fly Settings</guimenu>
 888
 889                                     <guisubmenu>User Agent</guisubmenu>
 890
 891                                     <guimenuitem>Firefox on Linux</guimenuitem>
 892                                 </menuchoice>
 893                             </term>
 894
 895                             <listitem>
 896                                 <para>
 897                                     Use the Firefox on Linux user agent for the current tab.
 898                                 </para>
 899                             </listitem>
 900                         </varlistentry>
 901
 902                         <!-- Chromium on Linux. -->
 903                         <varlistentry id="user-agent-chromium-linux">
 904                             <term>
 905                                 <menuchoice>
 906                                     <shortcut>
 907                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo>
 908                                     </shortcut>
 909
 910                                     <guimenu>On-The-Fly Settings</guimenu>
 911
 912                                     <guisubmenu>User Agent</guisubmenu>
 913
 914                                     <guimenuitem>Chromium on Linux</guimenuitem>
 915                                 </menuchoice>
 916                             </term>
 917
 918                             <listitem>
 919                                 <para>
 920                                     Use the Chromium on Linux user agent for the current tab.
 921                                 </para>
 922                             </listitem>
 923                         </varlistentry>
 924
 925                         <!-- Firefox on Windows. -->
 926                         <varlistentry id="user-agent-firefox-windows">
 927                             <term>
 928                                 <menuchoice>
 929                                     <shortcut>
 930                                         <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>F</keycap></keycombo>
 931                                     </shortcut>
 932
 933                                     <guimenu>On-The-Fly Settings</guimenu>
 934
 935                                     <guisubmenu>User Agent</guisubmenu>
 936
 937                                     <guimenuitem>Firefox on Windows</guimenuitem>
 938                                 </menuchoice>
 939                             </term>
 940
 941                             <listitem>
 942                                 <para>
 943                                     Use the Firefox on Windows user agent for the current tab.
 944                                 </para>
 945                             </listitem>
 946                         </varlistentry>
 947
 948                         <!-- Chrome on Windows. -->
 949                         <varlistentry id="user-agent-chrome-windows">
 950                             <term>
 951                                 <menuchoice>
 952                                     <shortcut>
 953                                         <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>C</keycap></keycombo>
 954                                     </shortcut>
 955
 956                                     <guimenu>On-The-Fly Settings</guimenu>
 957
 958                                     <guisubmenu>User Agent</guisubmenu>
 959
 960                                     <guimenuitem>Chrome on Windows</guimenuitem>
 961                                 </menuchoice>
 962                             </term>
 963
 964                             <listitem>
 965                                 <para>
 966                                     Use the Chrome on Windows user agent for the current tab.
 967                                 </para>
 968                             </listitem>
 969                         </varlistentry>
 970
 971                         <!-- Edge on Windows. -->
 972                         <varlistentry id="user-agent-edge-windows">
 973                             <term>
 974                                 <menuchoice>
 975                                     <shortcut>
 976                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>E</keycap></keycombo>
 977                                     </shortcut>
 978
 979                                     <guimenu>On-The-Fly Settings</guimenu>
 980
 981                                     <guisubmenu>User Agent</guisubmenu>
 982
 983                                     <guimenuitem>Edge on Windows</guimenuitem>
 984                                 </menuchoice>
 985                             </term>
 986
 987                             <listitem>
 988                                 <para>
 989                                     Use the Edge on Windows user agent for the current tab.
 990                                 </para>
 991                             </listitem>
 992                         </varlistentry>
 993
 994                         <!-- Safari on macOS. -->
 995                         <varlistentry id="user-agent-safari-macOS">
 996                             <term>
 997                                 <menuchoice>
 998                                     <shortcut>
 999                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo>
1000                                     </shortcut>
1001
1002                                     <guimenu>On-The-Fly Settings</guimenu>
1003
1004                                     <guisubmenu>User Agent</guisubmenu>
1005
1006                                     <guimenuitem>Safari on macOS</guimenuitem>
1007                                 </menuchoice>
1008                             </term>
1009
1010                             <listitem>
1011                                 <para>
1012                                     Use the Safari on macOS user agent for the current tab.
1013                                 </para>
1014                             </listitem>
1015                         </varlistentry>
1016
1017                         <!-- Custom User Agent. -->
1018                         <varlistentry id="user-agent-custom">
1019                             <term>
1020                                 <menuchoice>
1021                                     <shortcut>
1022                                         <keycombo action="simul">&Alt;&Shift;<keycap>C</keycap></keycombo>
1023                                     </shortcut>
1024
1025                                     <guimenu>On-The-Fly Settings</guimenu>
1026
1027                                     <guisubmenu>User Agent</guisubmenu>
1028
1029                                     <guimenuitem>Custom</guimenuitem>
1030                                 </menuchoice>
1031                             </term>
1032
1033                             <listitem>
1034                                 <para>
1035                                     Use the custom user agent for the current tab. This action is only active if a custom user agent is set in the settings.
1036                                 </para>
1037                             </listitem>
1038                         </varlistentry>
1039                     </variablelist>
1040                 </sect3>
1041
1042                 <!-- Zoom. -->
1043                 <sect3>
1044                     <title>Zoom</title>
1045
1046                     <variablelist>
1047                         <!-- Zoom Factor. -->
1048                         <varlistentry id="on-the-fly-settings-zoom-factor">
1049                             <term>
1050                                 <menuchoice>
1051                                     <shortcut>
1052                                         <keycombo action="simul">&Ctrl;&Alt;<keycap>Z</keycap></keycombo>
1053                                     </shortcut>
1054
1055                                     <guimenu>On-The-Fly Settings</guimenu>
1056
1057                                     <guimenuitem>Zoom Factor</guimenuitem>
1058                                 </menuchoice>
1059                             </term>
1060
1061                             <listitem>
1062                                 <para>
1063                                     Display the zoom factor dialog.
1064                                 </para>
1065                             </listitem>
1066                         </varlistentry>
1067                     </variablelist>
1068                 </sect3>
1069
1070                 <!-- Search Engine. -->
1071                 <sect3>
1072                     <title>Search Engine</title>
1073
1074                     <variablelist>
1075                         <!-- Mojeek. -->
1076                         <varlistentry id="search-engine-mojeek">
1077                             <term>
1078                                 <menuchoice>
1079                                     <shortcut>
1080                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>M</keycap></keycombo>
1081                                     </shortcut>
1082
1083                                     <guimenu>On-The-Fly Settings</guimenu>
1084
1085                                     <guisubmenu>Search Engine</guisubmenu>
1086
1087                                     <guimenuitem>Mojeek</guimenuitem>
1088                                 </menuchoice>
1089                             </term>
1090
1091                             <listitem>
1092                                 <para>
1093                                     Use Mojeek as the search engine.
1094                                 </para>
1095                             </listitem>
1096                         </varlistentry>
1097
1098                         <!-- Monocles. -->
1099                         <varlistentry id="search-engine-monocles">
1100                             <term>
1101                                 <menuchoice>
1102                                     <shortcut>
1103                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo>
1104                                     </shortcut>
1105
1106                                     <guimenu>On-The-Fly Settings</guimenu>
1107
1108                                     <guisubmenu>Search Engine</guisubmenu>
1109
1110                                     <guimenuitem>Monocles</guimenuitem>
1111                                 </menuchoice>
1112                             </term>
1113
1114                             <listitem>
1115                                 <para>
1116                                     Use Mojeek as the search engine.
1117                                 </para>
1118                             </listitem>
1119                         </varlistentry>
1120
1121                         <!-- MetaGer. -->
1122                         <varlistentry id="search-engine-metager">
1123                             <term>
1124                                 <menuchoice>
1125                                     <shortcut>
1126                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>E</keycap></keycombo>
1127                                     </shortcut>
1128
1129                                     <guimenu>On-The-Fly Settings</guimenu>
1130
1131                                     <guisubmenu>Search Engine</guisubmenu>
1132
1133                                     <guimenuitem>MetaGer</guimenuitem>
1134                                 </menuchoice>
1135                             </term>
1136
1137                             <listitem>
1138                                 <para>
1139                                     Use MetaGer as the search engine.
1140                                 </para>
1141                             </listitem>
1142                         </varlistentry>
1143
1144                         <!-- Google. -->
1145                         <varlistentry id="search-engine-google">
1146                             <term>
1147                                 <menuchoice>
1148                                     <shortcut>
1149                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>G</keycap></keycombo>
1150                                     </shortcut>
1151
1152                                     <guimenu>On-The-Fly Settings</guimenu>
1153
1154                                     <guisubmenu>Search Engine</guisubmenu>
1155
1156                                     <guimenuitem>Google</guimenuitem>
1157                                 </menuchoice>
1158                             </term>
1159
1160                             <listitem>
1161                                 <para>
1162                                     Use Google as the search engine.
1163                                 </para>
1164                             </listitem>
1165                         </varlistentry>
1166
1167                         <!-- Bing. -->
1168                         <varlistentry id="search-engine-bing">
1169                             <term>
1170                                 <menuchoice>
1171                                     <shortcut>
1172                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo>
1173                                     </shortcut>
1174
1175                                     <guimenu>On-The-Fly Settings</guimenu>
1176
1177                                     <guisubmenu>Search Engine</guisubmenu>
1178
1179                                     <guimenuitem>Bing</guimenuitem>
1180                                 </menuchoice>
1181                             </term>
1182
1183                             <listitem>
1184                                 <para>
1185                                     Use Bing as the search engine.
1186                                 </para>
1187                             </listitem>
1188                         </varlistentry>
1189
1190                         <!-- Yahoo. -->
1191                         <varlistentry id="search-engine-yahoo">
1192                             <term>
1193                                 <menuchoice>
1194                                     <shortcut>
1195                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>Y</keycap></keycombo>
1196                                     </shortcut>
1197
1198                                     <guimenu>On-The-Fly Settings</guimenu>
1199
1200                                     <guisubmenu>Search Engine</guisubmenu>
1201
1202                                     <guimenuitem>Yahoo</guimenuitem>
1203                                 </menuchoice>
1204                             </term>
1205
1206                             <listitem>
1207                                 <para>
1208                                     Use Yahoo as the search engine.
1209                                 </para>
1210                             </listitem>
1211                         </varlistentry>
1212
1213                         <!-- Custom Search Engine. -->
1214                         <varlistentry id="search-engine-custom">
1215                             <term>
1216                                 <menuchoice>
1217                                     <shortcut>
1218                                         <keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo>
1219                                     </shortcut>
1220
1221                                     <guimenu>On-The-Fly Settings</guimenu>
1222
1223                                     <guisubmenu>Search Engine</guisubmenu>
1224
1225                                     <guimenuitem>Custom</guimenuitem>
1226                                 </menuchoice>
1227                             </term>
1228
1229                             <listitem>
1230                                 <para>
1231                                     Use the custom search engine. This action is only active if a custom search engine is set in the settings.
1232                                 </para>
1233                             </listitem>
1234                         </varlistentry>
1235                     </variablelist>
1236                 </sect3>
1237             </sect2>
1238
1239             <!-- Bookmarks. -->
1240             <sect2>
1241                 <title>Bookmarks</title>
1242
1243                 <variablelist>
1244                     <!-- Edit Bookmarks. -->
1245                     <varlistentry id="edit-bookmarks">
1246                         <term>
1247                             <menuchoice>
1248                                 <shortcut>
1249                                     <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>B</keycap></keycombo>
1250                                 </shortcut>
1251
1252                                 <guimenu>Bookmarks</guimenu>
1253
1254                                 <guimenuitem>Edit Bookamrks</guimenuitem>
1255                             </menuchoice>
1256                         </term>
1257
1258                         <listitem>
1259                             <para>
1260                                 Open the bookmark editing dialog.
1261                             </para>
1262                         </listitem>
1263                     </varlistentry>
1264
1265                     <!-- Add Bookmark. -->
1266                     <varlistentry id="add-bookmark">
1267                         <term>
1268                             <menuchoice>
1269                                 <shortcut>
1270                                     <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
1271                                 </shortcut>
1272
1273                                 <guimenu>Bookmarks</guimenu>
1274
1275                                 <guimenuitem>Add Bookmark</guimenuitem>
1276                             </menuchoice>
1277                         </term>
1278
1279                         <listitem>
1280                             <para>
1281                                 Add a new bookmark.
1282                             </para>
1283                         </listitem>
1284                     </varlistentry>
1285
1286                     <!-- Add Folder. -->
1287                     <varlistentry id="add-folder">
1288                         <term>
1289                             <menuchoice>
1290                                 <shortcut>
1291                                     <keycombo action="simul">&Meta;<keycap>F</keycap></keycombo>
1292                                 </shortcut>
1293
1294                                 <guimenu>Bookmarks</guimenu>
1295
1296                                 <guimenuitem>Add Folder</guimenuitem>
1297                             </menuchoice>
1298                         </term>
1299
1300                         <listitem>
1301                             <para>
1302                                 Add a bookmark folder.  The meta key on most keyboards is the Windows key.
1303                             </para>
1304                         </listitem>
1305                     </varlistentry>
1306
1307                     <!-- View Bookmarks Toolbar. -->
1308                     <varlistentry id="view-bookmarks-toolbar">
1309                         <term>
1310                             <menuchoice>
1311                                 <shortcut>
1312                                     <keycombo action="simul">&Ctrl;&Alt;<keycap>B</keycap></keycombo>
1313                                 </shortcut>
1314
1315                                 <guimenu>Bookmarks</guimenu>
1316
1317                                 <guimenuitem>View Bookmarks Toolbar</guimenuitem>
1318                             </menuchoice>
1319                         </term>
1320
1321                         <listitem>
1322                             <para>
1323                                 Toggle the visibility of the bookmarks toolbar.
1324                             </para>
1325                         </listitem>
1326                     </varlistentry>
1327                 </variablelist>
1328             </sect2>
1329
1330             <!-- Settings. -->
1331             <sect2>
1332                 <title>Settings</title>
1333
1334                 <variablelist>
1335                     <!-- Domain Settings. -->
1336                     <varlistentry id="settings-domain-settings">
1337                         <term>
1338                             <menuchoice>
1339                                 <shortcut>
1340                                     <keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo>
1341                                 </shortcut>
1342
1343                                 <guimenu>Settings</guimenu>
1344
1345                                 <guimenuitem>Domain Settings</guimenuitem>
1346
1347                             </menuchoice>
1348                         </term>
1349
1350                         <listitem>
1351                             <para>
1352                                 Display the domain settings dialog.
1353                             </para>
1354                         </listitem>
1355                     </varlistentry>
1356
1357                     <!-- Cookies. -->
1358                     <varlistentry id="settings-cookies">
1359                         <term>
1360                             <menuchoice>
1361                                 <shortcut>
1362                                     <keycombo action="simul">&Ctrl;<keycap>;</keycap></keycombo>
1363                                 </shortcut>
1364
1365                                 <guimenu>Settings</guimenu>
1366
1367                                 <guimenuitem>Cookies</guimenuitem>
1368                             </menuchoice>
1369                         </term>
1370
1371                         <listitem>
1372                             <para>
1373                                 Display the cookies dialog.
1374                             </para>
1375                         </listitem>
1376                     </varlistentry>
1377                 </variablelist>
1378             </sect2>
1379
1380             <!-- Common Settings and Help Entries. -->
1381             <sect2 id="common-settings-help-menus">
1382                 <title>Common Settings and Help Entries</title>
1383
1384                 <para>
1385                     &privacybrowser; has many common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu> menu items.
1386                     For more information read the sections about the <ulink url="help:/fundamentals/ui.html#menus-settings">Settings Menu</ulink>
1387                     and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>.
1388                 </para>
1389             </sect2>
1390
1391             <!-- Other Commands. -->
1392             <sect2>
1393                 <title>Other Commands</title>
1394
1395                 <variablelist>
1396                     <!-- Find Case Sensitive. -->
1397                     <varlistentry id="find-case-sensitive">
1398                         <term>
1399                             <command>
1400                                 &Ctrl;+<keycap>S</keycap>
1401                             </command>
1402                         </term>
1403
1404                         <listitem>
1405                             <para>
1406                                 Toggle find case sensitive if the find toolbar is visible.
1407                             </para>
1408                         </listitem>
1409                     </varlistentry>
1410
1411                     <!-- Open link in new tab. -->
1412                     <varlistentry id="new-tab">
1413                         <term>
1414                             <command>
1415                                 &Ctrl;+&Shift;+Click
1416                             </command>
1417                         </term>
1418
1419                         <listitem>
1420                             <para>
1421                                 Open link in new tab. This performs the same action as right-clicking on the link and selecting “Open link in new tab”.
1422                             </para>
1423                         </listitem>
1424                     </varlistentry>
1425
1426                     <!-- Open link in background tab. -->
1427                     <varlistentry id="new-background-tab">
1428                         <term>
1429                             <command>
1430                                 &Ctrl;+Click
1431                             </command>
1432                         </term>
1433
1434                         <listitem>
1435                             <para>
1436                                 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”.
1437                             </para>
1438                         </listitem>
1439                     </varlistentry>
1440
1441                     <!-- Open link in new window. -->
1442                     <varlistentry id="new-window">
1443                         <term>
1444                             <command>
1445                                 &Shift;+Click
1446                             </command>
1447                         </term>
1448
1449                         <listitem>
1450                             <para>
1451                                 Open link in new window. This performs the same action as right-clicking on the link and selecting “Open link in new window”.
1452                             </para>
1453                         </listitem>
1454                     </varlistentry>
1455
1456                     <!-- Save link. -->
1457                     <varlistentry id="save-link">
1458                         <term>
1459                             <command>
1460                                 &Alt;+Click
1461                             </command>
1462                         </term>
1463
1464                         <listitem>
1465                             <para>
1466                                 Save link. This performs the same action as right-clicking on the link and selecting “Save link”.
1467                             </para>
1468                         </listitem>
1469                     </varlistentry>
1470
1471                     <!-- F11. -->
1472                     <varlistentry id="f11">
1473                         <term>
1474                             <command>
1475                                 <keycap>F11</keycap>
1476                             </command>
1477                         </term>
1478
1479                         <listitem>
1480                             <para>
1481                                 Toggle full screen mode. This performs the same action as <xref linkend="view-full-screen-mode"/>.
1482                             </para>
1483                         </listitem>
1484                     </varlistentry>
1485
1486                     <!-- Escape. -->
1487                     <varlistentry id="escape">
1488                         <term>
1489                             <command>
1490                                 <keycap>&Esc;</keycap>
1491                             </command>
1492                         </term>
1493
1494                         <listitem>
1495                             <para>
1496                                 Escape runs the first command that applies from the following list.
1497                             </para>
1498
1499                             <itemizedlist>
1500                                 <listitem>
1501                                     <para>
1502                                         Exit full screen browsing.
1503                                     </para>
1504                                 </listitem>
1505
1506                                 <listitem>
1507                                     <para>
1508                                         Clear the find text line edit and the find text highlights.
1509                                     </para>
1510                                 </listitem>
1511
1512                                 <listitem>
1513                                     <para>
1514                                         Hide the find text toolbar.
1515                                     </para>
1516                                 </listitem>
1517                             </itemizedlist>
1518                         </listitem>
1519                     </varlistentry>
1520                 </variablelist>
1521             </sect2>
1522         </sect1>
1523
1524     <!-- Cookies Dialog. -->
1525     <sect1 id="cookies-dialog">
1526         <title>Cookies Dialog</title>
1527
1528         <para>
1529             The cookies dialog is accessed through <xref linkend="settings-cookies"/> (see <xref linkend="cookies"/>).
1530         </para>
1531
1532         <sect2 id="cookies-dialog-commands">
1533             <title>Commands</title>
1534
1535             <variablelist>
1536                 <!-- Add Cookie. -->
1537                 <varlistentry id="add-cookie">
1538                     <term>
1539                         <command>
1540                             <keycap>A</keycap>
1541                         </command>
1542                     </term>
1543
1544                     <listitem>
1545                         <para>
1546                             Open the add cookie dialog.
1547                         </para>
1548                     </listitem>
1549                 </varlistentry>
1550
1551                 <!-- Edit Cookie. -->
1552                 <varlistentry id="edit-cookie">
1553                     <term>
1554                         <command>
1555                             <keycap>E</keycap>
1556                         </command>
1557                     </term>
1558
1559                     <listitem>
1560                         <para>
1561                             Open the edit cookie dialog. This command is only valid if a cookie is currently selected.
1562                         </para>
1563                     </listitem>
1564                 </varlistentry>
1565
1566                 <!-- Delete Cookies. -->
1567                 <varlistentry id="delete-cookies">
1568                     <term>
1569                         <command>
1570                             <keycap>D</keycap> or <keycap>&Del;</keycap>
1571                         </command>
1572                     </term>
1573
1574                     <listitem>
1575                         <para>
1576                             Delete the currently selected cookies. A dialog will confirm the deletion before it is processed.
1577                         </para>
1578                     </listitem>
1579                 </varlistentry>
1580
1581                 <!-- Delete All Cookies. -->
1582                 <varlistentry id="delete-all-cookie">
1583                     <term>
1584                         <command>
1585                             <keycap>L</keycap>
1586                         </command>
1587                     </term>
1588
1589                     <listitem>
1590                         <para>
1591                             Delete all the cookies. A dialog will confirm the deletion before it is processed.
1592                         </para>
1593                     </listitem>
1594                 </varlistentry>
1595
1596                 <!-- Close. -->
1597                 <varlistentry id="close-cookies-dialog">
1598                     <term>
1599                         <command>
1600                             <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
1601                         </command>
1602                     </term>
1603
1604                     <listitem>
1605                         <para>
1606                             Close the cookies dialog.
1607                         </para>
1608                     </listitem>
1609                 </varlistentry>
1610             </variablelist>
1611         </sect2>
1612     </sect1>
1613
1614     <!-- Save Dialog. -->
1615     <sect1 id="save-dialog">
1616         <title>Save Dialog</title>
1617
1618         <para>
1619             The save dialog pops up when a download is initiated.
1620         </para>
1621
1622         <sect2 id="save-dialog-commands">
1623             <title>Commands</title>
1624
1625             <variablelist>
1626                 <!-- Save. -->
1627                 <varlistentry id="save-dialog-save">
1628                     <term>
1629                         <command>
1630                             <keycap>S</keycap>
1631                         </command>
1632                     </term>
1633
1634                     <listitem>
1635                         <para>
1636                             Save the file.
1637                         </para>
1638                     </listitem>
1639                 </varlistentry>
1640
1641                 <!-- Close. -->
1642                 <varlistentry id="save-dialog-close">
1643                     <term>
1644                         <command>
1645                             <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
1646                         </command>
1647                     </term>
1648
1649                     <listitem>
1650                         <para>
1651                             Close the save dialog without saving the file.
1652                         </para>
1653                     </listitem>
1654                 </varlistentry>
1655             </variablelist>
1656         </sect2>
1657     </sect1>
1658     </chapter>
1659
1660     <!-- Changelog. -->
1661     <chapter id="changelog">
1662         <title>Changelog</title>
1663
1664         <!-- Version 0.4. -->
1665         <sect1 id="version_0.4">
1666             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-4/">0.4</ulink> -
1667                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=b4c8c8d02113d14c2a07751eb3b0c1bdeec7abb4">13 June 2023</ulink></title>
1668
1669             <itemizedlist>
1670                 <listitem><para>Add a setting to <ulink url="https://redmine.stoutner.com/issues/1002">control spatial navigation</ulink>.</para></listitem>
1671                 <listitem><para>Add an action to <ulink url="https://redmine.stoutner.com/issues/982">reload and bypass cache</ulink>.</para></listitem>
1672                 <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>
1673                 <listitem><para>Add <ulink url="https://redmine.stoutner.com/issues/1009">keyboard+click commands</ulink> to the Handbook.</para></listitem>
1674             </itemizedlist>
1675         </sect1>
1676
1677         <!-- Version 0.3. -->
1678         <sect1 id="version_0.3">
1679             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-3/">0.3</ulink> -
1680                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=ace098e8677ac0d6468b825c73e65b82c0d6993e">8 May 2023</ulink></title>
1681
1682             <itemizedlist>
1683                 <listitem><para>Add the changelog <ulink url="https://redmine.stoutner.com/issues/1000">to the Handbook</ulink>.</para></listitem>
1684                 <listitem><para>Add the missing <ulink url="https://redmine.stoutner.com/issues/999">current domain settings icon</ulink> on Gnome and Xfce.</para></listitem>
1685                 <listitem><para>Make changes to <ulink url="https://redmine.stoutner.com/issues/1005">build on Guix</ulink>.</para></listitem>
1686             </itemizedlist>
1687         </sect1>
1688
1689         <!-- Version 0.2. -->
1690         <sect1 id="version_0.2">
1691             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-2/">0.2</ulink> -
1692                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=44b5d3a1f6a5e7fc2aa8530845f26eba7bc26f9a">17 April 2023</ulink></title>
1693
1694             <itemizedlist>
1695                 <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>
1696                 <listitem><para>Fix problems with <ulink url="https://redmine.stoutner.com/issues/992">missing</ulink>
1697                     <ulink url="https://redmine.stoutner.com/issues/993">icons</ulink> on GNOME.</para></listitem>
1698                 <listitem><para>Display an <ulink url="https://redmine.stoutner.com/issues/980">animated favorite icon</ulink> while a webpage is loading.</para></listitem>
1699                 <listitem><para><ulink url="https://redmine.stoutner.com/issues/975">Fix the Handbook</ulink> on non-KDE systems.</para></listitem>
1700                 <listitem><para>Change the <ulink url="https://redmine.stoutner.com/issues/978">order of entries</ulink> in the WebEngine context menu.</para></listitem>
1701                 <listitem><para>Make spellcheck languages <ulink url="https://redmine.stoutner.com/issues/958">easier to click on</ulink>.</para></listitem>
1702                 <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>
1703                 <listitem><para>Add a section to the Handbook about <ulink url="https://redmine.stoutner.com/issues/976">HTTP pings</ulink>.</para></listitem>
1704             </itemizedlist>
1705         </sect1>
1706
1707         <!-- Version 0.1. -->
1708         <sect1 id="version_0.1">
1709             <title><ulink url="https://www.stoutner.com/privacy-browser-pc-0-1/">0.1</ulink> -
1710                 <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=73459c6685ec5e58d776f2594c9b587802363b1c">11 March 2023</ulink></title>
1711
1712             <itemizedlist>
1713                 <listitem><para>Initial release.</para></listitem>
1714             </itemizedlist>
1715         </sect1>
1716     </chapter>
1717
1718     <!-- FAQ. -->
1719     <chapter id="faq">
1720         <title>Questions and Answers</title>
1721
1722         <qandaset id="faqlist">
1723             <qandaentry>
1724                 <!-- Why are there no questions. -->
1725                 <question>
1726                     <para>
1727                         Why are there no questions?
1728                     </para>
1729                 </question>
1730
1731                 <answer>
1732                     <para>
1733                         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. ;)
1734                     </para>
1735                 </answer>
1736             </qandaentry>
1737         </qandaset>
1738     </chapter>
1739
1740     <!-- Credits. -->
1741     <chapter id="credits">
1742         <title>Credits and License</title>
1743
1744         <para>
1745             Privacy Browser PC copyright 2016-2017,2021-2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
1746         </para>
1747
1748         <!-- Program. -->
1749         <sect1 id="program">
1750             <title>Program</title>
1751
1752             <para>
1753                 The source code is available at <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=summary">gitweb.stoutner.com</ulink>
1754                 or by running <filename>git clone https://git.stoutner.com/PrivacyBrowserPC.git</filename>.
1755             </para>
1756
1757             <para>
1758                 Translators:
1759                 <itemizedlist>
1760                     <listitem>
1761                         <para>
1762                             Translations will be added in a future release.
1763                         </para>
1764                     </listitem>
1765                 </itemizedlist>
1766             </para>
1767
1768             <!-- The program license. -->
1769             &underGPL;
1770         </sect1>
1771
1772         <!-- Documentation. -->
1773         <sect1 id="documentation">
1774             <title>Documentation</title>
1775
1776             <para>
1777                 <filename>doc/index.docbook</filename> and <filename>src/com.stoutner.privacybrowser.appdata.xml</filename> are released under the
1778                 <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.
1779                 All other documentation is released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
1780             </para>
1781
1782             <!-- The documentation license. -->
1783             &underFDL;
1784         </sect1>
1785
1786         <!-- Icons. -->
1787         <sect1 id="icons">
1788             <title>Icons</title>
1789
1790             <para>
1791                 <inlinemediaobject>
1792                     <imageobject>
1793                         <imagedata fileref="privacybrowser.png" format="PNG"/>
1794                     </imageobject>
1795
1796                     <textobject>
1797                         <phrase>
1798                             Privacy Browser
1799                         </phrase>
1800                     </textobject>
1801                 </inlinemediaobject>
1802
1803                 <inlinemediaobject>
1804                     <imageobject>
1805                         <imagedata fileref="javascript.png" format="PNG"/>
1806                     </imageobject>
1807
1808                     <textobject>
1809                         <phrase>
1810                             JavaScript
1811                         </phrase>
1812                     </textobject>
1813                 </inlinemediaobject>
1814
1815                 <inlinemediaobject>
1816                     <imageobject>
1817                         <imagedata fileref="privacybrowser-monochrome.png" format="PNG"/>
1818                     </imageobject>
1819
1820                     <textobject>
1821                         <phrase>
1822                             Privacy Browser Monochrome
1823                         </phrase>
1824                     </textobject>
1825                 </inlinemediaobject>
1826
1827                 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>
1828                 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.
1829                 The resulting images are released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
1830             </para>
1831
1832             <para>
1833                 <inlinemediaobject>
1834                     <imageobject>
1835                         <imagedata fileref="loading.gif" format="GIF"/>
1836                     </imageobject>
1837
1838                     <textobject>
1839                         <phrase>
1840                             Loading
1841                         </phrase>
1842                     </textobject>
1843                 </inlinemediaobject>
1844
1845                 comes from <ulink url="https://github.com/Codelessly/FlutterLoadingGIFs/blob/master/packages/cupertino_activity_indicator_selective.gif">FlutterLoadingGIFs</ulink>
1846                 where it is named <filename>cupertino_activity_indicator_selective.gif</filename>.
1847                 It is released under the <ulink url="https://opensource.org/license/0bsd/">Zero-Clause BSD License</ulink>.
1848             </para>
1849         </sect1>
1850     </chapter>
1851 </book>