Merge ~bandali/ubuntu-manual-tests:add-browsers-testplan into ubuntu-manual-tests:main

[Amin Bandali]

This is a WIP for updating or adding testplans for several browsers, namely firefox, chromium, and epiphany, as well as one for any generic browser. Needs a bit more work before it's fully ready, e.g. incorporating the relevant existing tests for firefox into the new browsers.xml.

[Amin Bandali (bandali)]

This should now be ready for review.

[Sebastien Bacher (seb128)]

Thanks, trying to build the html from the description it seems there are some issues that need fixing, first one as an example

$ tools/test_case_gen definitions/browsers.xml
In <ut:case id='1778_browsers'>: <ut:define name='browser-about-page'> not found

which comes from
    <ut:include ref="about-page" />
in the 1778 testcase definition

the about-page testcase is using
  var name="browser-about-page"

so you can't call it without setting the variable

THe content itself seems fine, there are probably tweaks and improvement which could be done but it probably makes sense to land what you have there as a startpoint and iterate later on as needed

review: Needs Fixing

[Sebastien Bacher (seb128)]

We might also want to not include the 'browsers' testcase to simplify the job since the problems seem to be mostly coming from that case which is less specific, in practice we will test known browsers anyway

Unmerged commits

cc43d87... by Amin Bandali on 2022-12-20

Add testplans for browsers

This adds testplans for firefox, chromium, epiphany, and one for any
generic browser.

diff --git a/definitions/browsers.xml b/definitions/browsers.xml
new file mode 100644
index 0000000..a72a6d3
--- /dev/null
+++ b/definitions/browsers.xml
@@ -0,0 +1,592 @@
+<?xml version="1.0" encoding="utf-8" ?>
+
+<!-- See TEMPLATE.xml for an explanation of this file layout. -->
+
+<ut:configuration xmlns:ut="urn:com:ubuntu:tests">
+  <ut:template>
+    <p>This is a test plan for testing <ut:var name="browser" />.</p>
+    <p>These manual tests are meant to be used as a starting point and
+      guideline for testing/validating <ut:var name="browser" />, and
+      they are not exhaustive.</p>
+    <ut:var name="top-notice" />
+    <dl>
+      <ut:tests />
+    </dl>
+    <p>If <strong>all</strong> actions produce the expected results
+      listed, please <a href="results#add_result">submit</a> a
+      'passed' result.</p>
+    <p>If <strong>any</strong> action fails, or produces an unexpected
+      result, please <a href="results#add_result">submit</a> a
+      'failed' result and <a href="../../buginstructions">file a
+      bug</a>.  Please be sure to include the bug number when you
+      <a href="results#add_result">submit</a> your result.</p>
+  </ut:template>
+
+
+  <ut:test id="initial-setup">
+    <dt>Install the snap or deb package depending on your FAMILY
+      version and <ut:var name="browser" /> version you'd like to test
+      (for example, starting with impish, firefox is only available as
+      a snap, whereas on focal and earlier versions it was primarily
+      a deb).</dt>
+  </ut:test>
+
+  <ut:test id="autopkgtests">
+    <dt>Ensure that the
+      <a href="https://autopkgtest.ubuntu.com">autopkgtests</a> for
+      <ut:var name="browser" /> pass on the amd64, i386, arm64, and
+      armhf architectures.</dt>
+  </ut:test>
+
+  <ut:test id="about-page">
+    <dt>Open <ut:var name="browser" />'s about page, and verify the
+      correctness of version number, user agent string, profile
+      directory, and the status of GPU support.  Note that the name
+      and/or location of this page may differ across browsers.
+      <ut:var name="browser-about-page" /></dt>
+  </ut:test>
+
+  <ut:test id="custom-url-scheme-mailto">
+    <dt>Click on
+      <a href="mailto:[e-mail]">[e-mail]</a>.</dt>
+    <dd>Ensure that your default email client is opened to compose a
+      message to [e-mail].</dd>
+  </ut:test>
+
+  <ut:test id="custom-url-scheme-snap">
+    <dt>Browse to
+      <a href="https://snapcraft.io/0ad">https://snapcraft.io/0ad</a>,
+      click on the green 'Install' button, then click the 'View in
+      Desktop store' button.</dt>
+    <dd>Verify that the software store is opened on the details page
+      for 0 A.D.</dd>
+  </ut:test>
+
+  <ut:test id="default-browser-correct">
+    <dt>From the system Settings application, open the Default
+      Applications panel.  You can so by running
+      <code>gnome-control-center default-apps</code>
+      in a terminal.</dt>
+    <dd>Verify the correct browser is indicated as the default.
+      On Ubuntu, firefox is the default browser out of the box.
+      If <ut:var name="browser" /> is not the default, it would be
+      good to try setting it as the default browser and verify that
+      it remains the default after upgrading its package.</dd>
+  </ut:test>
+
+  <ut:test id="default-browser-set-from-browser">
+    <dt>Set <ut:var name="browser" /> as the default browser from its
+      preferences system (if supported).
+      <ut:var name="default-browser-from-browser-tip" />
+      Then, open the system Settings application's Default
+      Applications panel (if you previously had it open, change to
+      another panel and then back to Default Applications, to trigger
+      a reload of the shown settings values).</dt>
+    <dd>Verify that <ut:var name="browser" /> is now the default
+      browser.  Per the previous test, it would be good to also check
+      that <ut:var name="browser" /> remains the default after
+      upgrading it.</dd>
+  </ut:test>
+
+  <ut:test id="default-browser-set-other-from-system">
+    <dt>From the system Settings application, change the default
+      browser to another browser (you will need more than one browser
+      installed to test this).</dt>
+    <dd>Verify that <ut:var name="browser" /> correctly detects no
+      longer being the default browser (if it can do so), and that its
+      button to make itself the default browser is visible and active.
+      <ut:var name="default-browser-from-browser-tip" /></dd>
+  </ut:test>
+
+  <ut:test id="default-browser-set-from-system">
+    <dt>From the system Settings application, change the default
+      browser to <ut:var name="browser" /></dt>
+    <dd>Verify that <ut:var name="browser" /> correctly detects being
+      the default browser (if it can do so), and optionally that its
+      button to make itself the default browser is now hidden or
+      disabled.
+      <ut:var name="default-browser-from-browser-tip" /></dd>
+  </ut:test>
+
+  <ut:test id="search-engine-referral-google">
+    <dt>From <ut:var name="browser" />'s preferences, set the
+      default search engine to Google (most likely already the default
+      search engine out of the box), then do a web search from
+      <ut:var name="browser" />'s address bar and/or search bar.
+      <ut:var name="search-engine-change-tip" /></dt>
+    <dd>Verify that the <code>client=ubuntu</code> referral code is
+      one of the present URL parameters in the address bar.</dd>
+  </ut:test>
+
+  <ut:test id="search-engine-referral-ddg">
+    <dt>From <ut:var name="browser" />'s preferences, set the
+      default search engine to DuckDuckGo, then do a web search from
+      <ut:var name="browser" />'s address bar and/or search bar.
+      <ut:var name="search-engine-change-tip" /></dt>
+    <dd>Verify that the <code>t=canonical</code> referral code is
+      one of the present URL parameters in the address bar.</dd>
+  </ut:test>
+
+  <ut:test id="search-address-bar-wikipedia-ubuntu">
+    <dt>Type <code>Ubuntu</code> into <ut:var name="browser" />'s
+      address bar, but before pressing Enter to carry out the search,
+      click on the Wikipedia icon that has appeared below the address
+      bar to select Wikipedia as the search engine.  Then, press Enter
+      to perform the search.</dt>
+    <dd>Verify that the Ubuntu page on Wikipedia is opened.</dd>
+  </ut:test>
+
+  <ut:test id="download-generic-file">
+    <dt>Download a tarball (e.g.
+      <a href="https://launchpad.net/ubuntu/+archive/primary/+sourcefiles/grace/1:5.1.25-13/grace_5.1.25.orig.tar.gz">grace_5.1.25.orig.tar.gz</a>).
+      Open <ut:var name="browser" />'s downloads view if it has
+      one.</dt>
+    <dd>Verify that the file is fully downloaded.</dd>
+    <dd>Verify that you can open the parent folder containing the
+      downloaded file, if <ut:var name="browser" /> has a button to do
+      so.  This should open the folder containing the file in nautilus
+      or your default file manager.</dd>
+    <dd>Verify that you can open the downloaded file from the browser.
+      For instance, for a tarball, it should open in an archive
+      manager like <code>file-roller</code>.</dd>
+  </ut:test>
+
+  <ut:test id="download-doc-file">
+    <dt>Download a
+      <a href="https://interoperability.blob.core.windows.net/files/MS-DOC/%5bMS-DOC%5d-221115.docx">sample
+      DOC(X) file</a>.  Open <ut:var name="browser" />'s downloads
+      view if it has one.</dt>
+    <dd>Verify that the file is fully downloaded.</dd>
+    <dd>Verify that you can open the parent folder containing the
+      downloaded file, if <ut:var name="browser" /> has a button to do
+      so.  This should open the folder containing the file in nautilus
+      or your default file manager.</dd>
+    <dd>Verify that you can open the downloaded file from the browser.
+      In this case, it should open in
+      <a href="https://wiki.ubuntu.com/LibreOffice">LibreOffice</a>
+      Writer.</dd>
+  </ut:test>
+
+  <ut:test id="download-pdf-file">
+    <dt>If <ut:var name="browser" /> supports rendering and displaying
+      PDF files directly in the browser itself, open a
+      <a href="https://helpx.adobe.com/pdf/acrobat_reference.pdf">sample
+      PDF file</a>.
+      <ut:var name="supported" /></dt>
+    <dd>Verify the PDF file is opened in <ut:var name="browser" />
+      itself.</dd>
+    <dd>Verify that you can scroll through the pages.</dd>
+    <dd>Verify that you can zoom in an out.</dd>
+    <dd>Verify that you can save (download) the file to disk.</dd>
+  </ut:test>
+
+  <ut:test id="html5test">
+    <dt>Browse to
+      <a href="https://html5test.com">https://html5test.com</a>.</dt>
+    <dd>Verify that <ut:var name="browser" /> was correctly detected
+      as the browser.</dd>
+    <dd>Verify that the score is as expected (this will vary from
+      browser to browser).
+      <ut:var name="html5test-score" /></dd>
+  </ut:test>
+
+  <ut:test id="geolocation">
+    <dt>If <ut:var name="browser" /> supports geolocation, browse to
+      <a href="https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API/Using_the_Geolocation_API#result">https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API/Using_the_Geolocation_API#result</a>.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that you get prompted to allow/deny geolocation
+      access.</dd>
+    <dd>Allow access, and verify that your approximate location is
+      found.</dd>
+  </ut:test>
+
+  <ut:test id="webrtc">
+    <dt>If <ut:var name="browser" /> supports WebRTC, browse to
+      <a href="https://mozilla.github.io/webrtc-landing/gum_test.html">https://mozilla.github.io/webrtc-landing/gum_test.html</a>.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that camera, microphone, and screen capture work as
+      expected.<br />
+      <b>Note:</b> Make sure to test both sharing the entire screen,
+      and sharing specific windows, under Wayland; there have been
+      breakages in the past.</dd>
+  </ut:test>
+
+  <ut:test id="webgl">
+    <dt>If <ut:var name="browser" /> supports WebGL, browse to
+      <a href="https://webglsamples.org/aquarium/aquarium.html">https://webglsamples.org/aquarium/aquarium.html</a>.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that on real hardware you get a good number of frames
+      per second (FPS), such as 60, with the default number of sprites
+      (500 fishes).</dd>
+  </ut:test>
+
+  <ut:test id="safe-browsing-warnings">
+    <dt>If <ut:var name="browser" /> supports safe browsing warnings,
+      browse to
+      <a href="https://testsafebrowsing.appspot.com">https://testsafebrowsing.appspot.com</a>,
+      and try clicking on several of the links.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that you get appropriate dissuasive warnings, depending
+      on the link.</dd>
+  </ut:test>
+
+  <ut:test id="video-playback-yt-any">
+    <dt>If <ut:var name="browser" /> supports JavaScript and HTML 5
+      video playback, browse to
+      <a href="https://yewtu.be">https://yewtu.be</a> and/or
+      <a href="https://www.youtube.com">https://www.youtube.com</a>,
+      and watch any video.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that the video plays.</dd>
+    <dd>Verify that you can pause and resume the video.</dd>
+    <dd>Verify that you can enter and exit full-screen.</dd>
+    <dd>Verify that while the video is playing, the screensaver or
+      screen blanking is inhibited.</dd>
+  </ut:test>
+
+  <ut:test id="video-playback-yt-360">
+    <dt>If <ut:var name="browser" /> supports JavaScript and HTML 5
+      video playback, watch any 360° video, for instance
+      <a href="https://videojs-vr.netlify.app">https://videojs-vr.netlify.app</a>
+      and/or
+      <a href="https://www.youtube.com/watch?v=wczdECcwRw0">https://www.youtube.com/watch?v=wczdECcwRw0</a>.
+      <ut:var name="supported" /></dt>
+    <dd>Verify that you can pan with the mouse (by clicking and
+      dragging on the video player) to spin around in the scene while
+      it's playing back.</dd>
+  </ut:test>
+
+  <ut:test id="reader-mode">
+    <dt>If <ut:var name="browser" /> has a reader mode functionality
+      (reader modes usually try to simplify and remove clutter from a
+      page, keeping only the main material, for a more reader-friendly
+      view for reading long text), browse to a page like
+      <a href="https://www.gnu.org/philosophy/free-sw.html">https://www.gnu.org/philosophy/free-sw.html</a>,
+      and enable the reader view.
+      <ut:var name="reader-mode-tip" /></dt>
+    <dd>Verify that the reader view is working as expected, presenting
+      a clean and simplified view of the page.</dd>
+  </ut:test>
+
+  <ut:test id="bookmarks">
+    <dt>If <ut:var name="browser" /> has a bookmark functionality,
+      browse to any page and try adding it as a bookmark.</dt>
+    <dd>Verify that the bookmark is created, and that you can use it
+      to browse to the page again, including after restarting
+      <ut:var name="browser" />.</dd>
+  </ut:test>
+
+  <ut:test id="history">
+    <dt>If <ut:var name="browser" /> has a browsing history
+      functionality, browse to a few web sites and web pages.  Then,
+      open the browser history.</dt>
+    <dd>Verify that the pages you just visited appear in the browsing
+      history.  Optionally, the pages might also appear on
+      <ut:var name="browser" />'s new tab/window page, or be displayed
+      as a suggestion when typing in the address bar.</dd>
+  </ut:test>
+
+  <ut:test id="print-page">
+    <dt>Browse to
+      <a href="https://wiki.ubuntu.com">https://wiki.ubuntu.com</a>.
+      From <ut:var name="browser" />'s menus, select "Print...", often
+      accessible using the <kbd>Ctrl+P</kbd> keyboard shortcut as
+      well.</dt>
+    <dd>Verify that <ut:var name="browser" />'s print or print preview
+      dialog is opened.</dd>
+    <dt>Select an available printer from the print dialog.  It might
+      be easiest to select the option to print/save the page to a PDF
+      file.  Then click the Print or Save button.</dt>
+    <dd>Verify that the Ubuntu Wiki page was printed or saved as a PDF
+      file.</dd>
+  </ut:test>
+
+  <ut:test id="extensions">
+    <dt>If <ut:var name="browser" /> has the ability to install
+      add-ons or extensions, try installing one of the available
+      extensions (for instance 'uBlock Origin' or 'LibreJS').</dt>
+    <dd>Verify that the extension is correctly installed and works as
+      expected.</dd>
+    <dt>Try removing the extension you just installed.</dt>
+    <dd>Verify that the extension was correctly removed.</dd>
+  </ut:test>
+
+  <ut:test id="restore-previous-session">
+    <dt>If supported by <ut:var name="browser" />, set its relevant
+      preference option to restore your previous session when you quit
+      the browser.  Then, browse to one or more sites, quit the
+      browser, and launch it again.
+      <ut:var name="restore-previous-session-tip" /></dt>
+    <dd>Verify that your tab(s) from previous session were
+      restored.</dd>
+  </ut:test>
+
+
+  <ut:case id="1778_browsers">
+    <ut:define name="browser">generic browser</ut:define>
+    <ut:define name="top-notice"><p>Note: not all of the features
+        corresponding to the following tests may be implemented by the
+        browser you are testing, or even be in its scope.  For those
+        features, please skip the corresponding tests.</p></ut:define>
+    <ut:include ref="initial-setup" />
+    <ut:include ref="autopkgtests" />
+    <ut:include ref="about-page" />
+    <ut:include ref="custom-url-scheme-mailto" />
+    <ut:include ref="custom-url-scheme-snap" />
+    <ut:include ref="default-browser-correct" />
+    <ut:include ref="default-browser-set-from-browser" />
+    <ut:include ref="default-browser-set-other-from-system" />
+    <ut:include ref="default-browser-set-from-system" />
+    <!-- <ut:include ref="search-engine-referral-google" /> -->
+    <!-- <ut:include ref="search-engine-referral-ddg" /> -->
+    <ut:include ref="download-generic-file" />
+    <ut:include ref="download-doc-file" />
+    <ut:include ref="download-pdf-file" />
+    <ut:include ref="html5test" />
+    <ut:include ref="geolocation" />
+    <ut:include ref="webrtc" />
+    <ut:include ref="webgl" />
+    <ut:include ref="safe-browsing-warnings" />
+    <ut:include ref="video-playback-yt-any" />
+    <ut:include ref="video-playback-yt-360" />
+    <ut:include ref="reader-mode" />
+    <ut:include ref="bookmarks" />
+    <ut:include ref="history" />
+    <ut:include ref="print-page" />
+    <ut:include ref="extensions" />
+    <ut:include ref="restore-previous-session" />
+  </ut:case>
+
+  <ut:case id="1419_Firefox">
+    <ut:define name="browser">firefox</ut:define>
+    <ut:include ref="initial-setup" />
+    <ut:include ref="autopkgtests" />
+    <ut:include ref="about-page">
+      <ut:define name="browser-about-page">In firefox, these can be
+        accessed by browsing to about:support.</ut:define>
+    </ut:include>
+    <ut:include ref="custom-url-scheme-mailto" />
+    <ut:include ref="custom-url-scheme-snap" />
+    <ut:include ref="default-browser-correct" />
+    <ut:define name="default-browser-from-browser-tip">In firefox,
+      you can do this from
+      <code>about:preferences#general</code>.</ut:define>
+    <ut:include ref="default-browser-set-from-browser" />
+    <ut:include ref="default-browser-set-other-from-system" />
+    <ut:include ref="default-browser-set-from-system" />
+    <ut:define name="search-engine-change-tip">In firefox,
+      you can change the default search engine from
+      <code>about:preferences#search</code>.</ut:define>
+    <ut:include ref="search-engine-referral-google" />
+    <!-- <ut:include ref="search-engine-referral-ddg" /> -->
+    <ut:include ref="search-address-bar-wikipedia-ubuntu" />
+    <ut:include ref="download-generic-file" />
+    <ut:include ref="download-doc-file" />
+    <ut:include ref="download-pdf-file">
+      <ut:define name="supported">This is supported in
+        firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="html5test">
+      <ut:define name="html5test-score">The expected score for firefox
+        109 is 515/555 in a normal window, and 499/555 in a private
+        (incognito) window.</ut:define>
+    </ut:include>
+    <ut:include ref="geolocation">
+      <ut:define name="supported">Geolocation is supported in
+      firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="webrtc">
+      <ut:define name="supported">WebRTC is supported in
+        firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="webgl">
+      <ut:define name="supported">WebGL is supported in
+        firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="safe-browsing-warnings">
+      <ut:define name="supported">Safe browsing warnings are supported
+        in firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-any">
+      <ut:define name="supported">This is supported in
+        firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-360">
+      <ut:define name="supported">This is supported in
+        firefox.</ut:define>
+    </ut:include>
+    <ut:include ref="reader-mode">
+      <ut:define name="reader-mode-tip">In firefox, reader mode can be
+        toggled for a page by clicking on its icon at the right end of
+        the address bar, or using the <kbd>Ctrl+Alt+R</kbd> keyboard
+        shortcut.  Note that reader mode may not be available on all
+        pages, depending on factors such as page layout and paragraph
+        lengths.</ut:define>
+    </ut:include>
+    <ut:include ref="bookmarks" />
+    <ut:include ref="history" />
+    <ut:include ref="print-page" />
+    <ut:include ref="extensions" />
+    <ut:include ref="restore-previous-session">
+      <ut:define name="restore-previous-session-tip">In firefox, you
+        can enable this by browsing to
+        <code>about:preferences#general</code> and checking the box
+        next to "Open previous windows and tabs".</ut:define>
+    </ut:include>
+  </ut:case>
+
+  <ut:case id="1779_chromium">
+    <ut:define name="browser">chromium</ut:define>
+    <ut:include ref="initial-setup" />
+    <ut:include ref="autopkgtests" />
+    <ut:include ref="about-page">
+      <ut:define name="browser-about-page">In chromium, these can be
+        accessed by browsing to about:version and
+        about:gpu.</ut:define>
+    </ut:include>
+    <ut:include ref="custom-url-scheme-mailto" />
+    <ut:include ref="custom-url-scheme-snap" />
+    <ut:include ref="default-browser-correct" />
+    <ut:define name="default-browser-from-browser-tip">In chromium,
+      you can do this from
+      <code>about:settings/defaultBrowser</code>.</ut:define>
+    <ut:include ref="default-browser-set-from-browser" />
+    <ut:include ref="default-browser-set-other-from-system" />
+    <ut:include ref="default-browser-set-from-system" />
+    <ut:define name="search-engine-change-tip">In chromium,
+      you can change the default search engine from
+      <code>about:settings/search</code>.</ut:define>
+    <ut:include ref="search-engine-referral-google" />
+    <ut:include ref="search-engine-referral-ddg" />
+    <ut:include ref="download-generic-file" />
+    <ut:include ref="download-doc-file" />
+    <ut:include ref="download-pdf-file">
+      <ut:define name="supported">This is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="html5test">
+      <ut:define name="html5test-score">The expected score for
+        chromium 105 is 526/555.</ut:define>
+    </ut:include>
+    <ut:include ref="geolocation">
+      <ut:define name="supported">Geolocation is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="webrtc">
+      <ut:define name="supported">WebRTC is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="webgl">
+      <ut:define name="supported">WebGL is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="safe-browsing-warnings">
+      <ut:define name="supported">Safe browsing warnings are supported
+        in chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-any">
+      <ut:define name="supported">This is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-360">
+      <ut:define name="supported">This is supported in
+        chromium.</ut:define>
+    </ut:include>
+    <ut:include ref="reader-mode">
+      <ut:define name="reader-mode-tip">Chromium does not have a
+        built-in reader mode functionality at this time.</ut:define>
+    </ut:include>
+    <ut:include ref="bookmarks" />
+    <ut:include ref="history" />
+    <ut:include ref="print-page" />
+    <ut:include ref="extensions" />
+    <ut:include ref="restore-previous-session">
+      <ut:define name="restore-previous-session-tip">In chromium, you
+        can enable this by browsing to
+        <code>about:settings/onStartup</code> and selecting "Continue
+        where you left off".</ut:define>
+    </ut:include>
+  </ut:case>
+
+  <ut:case id="1780_epiphany">
+    <ut:define name="browser">epiphany</ut:define>
+    <ut:include ref="initial-setup" />
+    <ut:include ref="autopkgtests" />
+    <ut:include ref="about-page">
+      <ut:define name="browser-about-page">In epiphany, some of these
+        can be accessed by browsing to about:web and about:gpu, and
+        some from outside the browser via gsettings.</ut:define>
+    </ut:include>
+    <ut:include ref="custom-url-scheme-mailto" />
+    <ut:include ref="custom-url-scheme-snap" />
+    <ut:include ref="default-browser-correct" />
+    <ut:define name="default-browser-from-browser-tip">When epiphany
+      detects that it is not the default browser, it will show a
+      banner near the top of the window, asking if would like to "set
+      Web as your default browser?", to which you can answer "Yes",
+      "No", or just close it.</ut:define>
+    <ut:include ref="default-browser-set-from-browser" />
+    <ut:include ref="default-browser-set-other-from-system" />
+    <ut:include ref="default-browser-set-from-system" />
+    <ut:define name="search-engine-change-tip">In epiphany,
+      you can change the default search engine from its "Preferences"
+      window, under the "General" pane.</ut:define>
+    <!-- <ut:include ref="search-engine-referral-google" /> -->
+    <!-- <ut:include ref="search-engine-referral-ddg" /> -->
+    <ut:include ref="download-generic-file" />
+    <ut:include ref="download-doc-file" />
+    <ut:include ref="download-pdf-file">
+      <ut:define name="supported">This is supported in
+        epiphany.</ut:define>
+    </ut:include>
+    <ut:include ref="html5test">
+      <ut:define name="html5test-score">The expected score for
+        epiphany 42.4 with webkitgtk 2.38.2 is 463/555 in a normal
+        window, and 461/555 in a private (incognito)
+        window.</ut:define>
+    </ut:include>
+    <ut:include ref="geolocation">
+      <ut:define name="supported">Geolocation is supposedly supported
+        in epiphany, but it seems to be broken currently.</ut:define>
+    </ut:include>
+    <ut:include ref="webrtc">
+      <ut:define name="supported">WebRTC is currently not supported in
+        epiphany.</ut:define>
+    </ut:include>
+    <ut:include ref="webgl">
+      <ut:define name="supported">WebGL is supported in
+        epiphany.</ut:define>
+    </ut:include>
+    <ut:include ref="safe-browsing-warnings">
+      <ut:define name="supported">Safe browsing warnings are currently
+        not supported in epiphany.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-any">
+      <ut:define name="supported">This is supposedly supported in
+        epiphany, but epiphany seems to have trouble playing some of
+        the videos.</ut:define>
+    </ut:include>
+    <ut:include ref="video-playback-yt-360">
+      <ut:define name="supported">This should already be supported in
+        epiphany, but epiphany seems to have trouble playing some of
+        the videos.</ut:define>
+    </ut:include>
+    <ut:include ref="reader-mode">
+      <ut:define name="reader-mode-tip">In epiphany, reader view can
+        be toggled for a page by clicking on its icon at the right end
+        of the address bar, or using the <kbd>Ctrl+Alt+R</kbd>
+        keyboard shortcut.  Note that reader view may not be available
+        on all pages, depending on factors such as page layout and
+        paragraph lengths.</ut:define>
+    </ut:include>
+    <ut:include ref="bookmarks" />
+    <ut:include ref="history" />
+    <ut:include ref="print-page" />
+    <ut:include ref="extensions" />
+    <ut:include ref="restore-previous-session">
+      <ut:define name="restore-previous-session-tip">In epiphany, you
+        can enable this from the "Preferences" window, under the
+        "General" pane.</ut:define>
+    </ut:include>
+  </ut:case>
+</ut:configuration>