Index: xsoft/graphweb/firefox.xml
===================================================================
--- xsoft/graphweb/firefox.xml	(revision 855a40e89b2eb80e15995d27a218be16e9590e2f)
+++ xsoft/graphweb/firefox.xml	(revision 326f8301c6cc7c38e28c34878cd7b2fbeb155756)
@@ -7,7 +7,7 @@
   <!ENTITY firefox-download-http "&mozilla-http;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.xz">
   <!ENTITY firefox-download-ftp  " ">
-  <!ENTITY firefox-md5sum        "18586d62f24671fa15f4a5dd7b19c09c">
-  <!ENTITY firefox-size          "239 MB">
-  <!ENTITY firefox-buildsize     "7.2 GB (148 MB installed) without tests">
+  <!ENTITY firefox-md5sum        "0d5b70d2cf074ed6716b13c3e8d43a18">
+  <!ENTITY firefox-size          "236 MB">
+  <!ENTITY firefox-buildsize     "7.4 GB (152 MB installed) without tests">
   <!ENTITY firefox-time          "20 SBU (with parallelism=4) without tests">
 ]>
@@ -75,7 +75,13 @@
         The build times for this version of firefox (using stylo, the new CSS
         rendering code) seem to vary widely between different machines. On one
-        old Intel i3 the build took 33 SBU. The reason for this is not understood.
-        A build with stylo disabled is typically 1 or 2 SBU quicker and needs
-        0.8GB less disk space.
+        old Intel i3 the build took considerably longer. The reason for this is
+        not understood. A build with stylo disabled is typically 1 or 2 SBU
+        quicker and needs 0.8GB less disk space.
+      </para>
+
+      <para>
+        Although upstream prefer to use <application>PulseAudio</application>,
+        for the moment <application>Alsa</application> can still be used. Both
+        may need runtime configuration to get sound working.
       </para>
     </note>
@@ -123,9 +129,11 @@
       both <xref linkend="gtk3"/> and
       <xref linkend="gtk2"/>, 
+      <xref linkend="libnotify"/>,
       <xref linkend="nss"/>,
       <xref linkend="pulseaudio"/>
       (or
       <xref linkend="alsa-lib"/> if you edit the mozconfig; 
-        now deprecated by mozilla), 
+        now deprecated by mozilla), in either case please read the
+        Configuration Information,
       <xref linkend="rust"/>,
       <xref linkend="unzip"/>,
@@ -345,7 +353,7 @@
  https://bugzilla.mozilla.org/show_bug.cgi?id=1341234
  which is reported to be fixed in ff58 -->
-<screen><userinput>export BINDGEN_CFLAGS=$(pkg-config --cflags nspr pixman-1) &amp;&amp;
-make -f client.mk                                          &amp;&amp;
-unset BINDGEN_CFLAGS</userinput></screen>
+<screen><userinput>
+./mach build
+</userinput></screen>
 
     <para>
@@ -364,9 +372,8 @@
     </para>
 
-<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
-chown -R 0:0 /usr/lib/firefox-&firefox-version;   &amp;&amp;
-
-mkdir -pv    /usr/lib/mozilla/plugins  &amp;&amp;
-ln    -sfv   ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
+<screen role="root"><userinput>./mach install                                                  &amp;&amp;
+
+mkdir -pv  /usr/lib/mozilla/plugins                             &amp;&amp;
+ln    -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
 <!--
     <para>
@@ -385,15 +392,13 @@
 
     <para>
-      <command>export BINDGEN_CFLAGS=$(pkg-config --cflags nspr pixman-1)</command>:
-      This works around a bug in the style rust package to allow it to find the
-      system headers for <package>nspr</package> and <package>pixman</package>.
-    </para>
-
-    <para>
-      <command>make -f client.mk ...</command>: Mozilla products are packaged to
-      allow the use of a configuration file which can be used to pass the
-      configuration settings to the <command>configure</command> command.
-      <command>make</command> uses the <filename>client.mk</filename> file to
-      get initial configuration and setup parameters.
+      <command>./mach build</command>: <application>Firefox</application>
+      now uses this <application>python2</application> script to run the
+      build and install.
+    </para>
+
+    <para>
+      <option>./mach build --verbose</option>: Use this alternative if you
+      need details of which files are being compiled, together with any C or
+      C++ flags being used.
     </para>
 
@@ -449,4 +454,65 @@
         /usr/share/pixmaps/firefox.png</userinput></screen>
 
+    <sect3><title>Configuration Information</title>
+
+      <para>
+        The application settings for firefox are accessible by keying
+        <command>about:config</command> in the address bar.
+      </para>
+
+      <para>
+        With this version of <application>firefox</application>, getting
+        working sound can be a problem.  Although upstream prefers pulseaudio,
+        on balance using <application>Alsa</application> may be easier.
+      </para>
+
+      <para>
+        If you enabled <application>Alsa</application> for sound, you may need
+        to alter one variable to get working sound. If you run
+        <command>firefox</command> from a term and try to play something with
+        sound you might encounter error messages like:
+      </para>
+
+      <para>
+         <literal>Sandbox: seccomp sandbox violation: pid 3941, tid 4030,
+         syscall 16, args 48 2147767296 139909894784796 0 0 0.</literal>
+      </para>
+
+      <para>
+        That was on x86_64, on i686 the syscall number is 54. To allow this
+        syscall, in <command>about:config</command> change
+        <command>security.sandbox.content.syscall_whitelist</command> to 16
+        (or 54 if using i686).
+      </para>
+
+      <para>
+        If you use <command>pulseaudio</command> in a Desktop Environment, it
+        might already be started by that DE.  But if it is not, although
+        firefox-57 managed to start it, firefox-58 does not.  If you run
+        <command>firefox</command> from a term, trying to play sound will
+        encounter error messages warning <literal>Can't get cubeb
+        context!</literal>
+      </para>
+
+    <para>
+      The fix for this is to close firefox, start pulseaudio to check it
+      does start (if not, read the information on Configuring in <xref
+      linkend="pulseaudio"/>) and restart firefox to check it is working.
+      If it now works, add the following to your <filename>~/.xinitrc</filename>:
+<phrase revision="sysv">
+<literal>pulseaudio --verbose --log-target=syslog&amp;</literal></phrase>
+<phrase revision="systemd">
+<literal>pulseaudio --verbose --log-target=journald&amp;</literal></phrase>
+        (unfortunately, on some systems this does not work).
+      </para>
+
+      <para>
+        You may wish to use multiple profiles within firefox. To do that, invoke
+        firefox as <command>firefox --ProfileManager</command>. You can also
+        check which profile is currently in use from
+        <command>about:profiles</command>.
+      </para>
+
+    </sect3>
   </sect2>
 
