Index: general/genlib/js60.xml
===================================================================
--- general/genlib/js60.xml	(revision b1fb2a9b4c2e7e70988a768423d7af3402c653ea)
+++ general/genlib/js60.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -127,5 +127,13 @@
     </para>
 
-    &shell-env;
+<!--    &shell-env;-->
+
+     <note>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="../../xincludes/mozshm.xml"/>
+
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="../../xincludes/mozconfigure.xml"/>
+     </note>
 
 <screen><userinput>mkdir mozjs-build &amp;&amp;
Index: general/genlib/js68.xml
===================================================================
--- general/genlib/js68.xml	(revision b1fb2a9b4c2e7e70988a768423d7af3402c653ea)
+++ general/genlib/js68.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -143,5 +143,14 @@
     </para>
 
-    &shell-env;
+<!--    &shell-env;-->
+
+     <note>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="../../xincludes/mozshm.xml"/>
+
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="../../xincludes/mozconfigure.xml"/>
+     </note>
+
 
 <screen><userinput>sed '21,+4d' -i js/moz.configure &amp;&amp;
Index: xincludes/mozconfigure.xml
===================================================================
--- xincludes/mozconfigure.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
+++ xincludes/mozconfigure.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" >
+
+<!-- $LastChangedBy$
+     $Date$ -->
+
+    <!-- to go inside a NOTE on mozilla packages which need SHELL
+         specified in chroot, following the mozshm include -->
+
+    <para>
+      Second, either as the <systemitem class="username">root</systemitem>
+      user export the <envar>$SHELL</envar> environment variable using
+      <command>export SHELL=/bin/sh</command> or else prepend
+      <envar>SHELL=/bin/sh</envar> when running the
+      <command>configure</command> command.
+    </para>
+
Index: xincludes/mozmach.xml
===================================================================
--- xincludes/mozmach.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
+++ xincludes/mozmach.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" >
+
+<!-- $LastChangedBy$
+     $Date$ -->
+
+    <!-- to go inside a NOTE on mozilla packages which need SHELL
+         specified in chroot, following the mozshm include -->
+
+    <para>
+      Second, either as the <systemitem class="username">root</systemitem>
+      user export the <envar>$SHELL</envar> environment variable using
+      <command>export SHELL=/bin/sh</command> or else prepend
+      <envar>SHELL=/bin/sh</envar> when running the
+      <command>./mach</command> commands.
+    </para>
+
Index: xincludes/mozshm.xml
===================================================================
--- xincludes/mozshm.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
+++ xincludes/mozshm.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" >
+
+<!-- $LastChangedBy$
+     $Date$ -->
+
+    <!-- to go inside a NOTE on mozilla packages which need shm
+         mounted when configured or similar in chroot.
+         Unfortunately, the DTD says an xinclude can only include
+         one paragraph. -->
+
+    <para>
+      If you are compiling this package in chroot you must do two things.
+      First, as the <systemitem class="username">root</systemitem> user,
+      ensure that <filename>/dev/shm</filename> is mounted. If you do not
+      do this, the <application>Python</application> configury will fail
+      with a traceback report referencing
+      <filename>/usr/lib/pythonN.N/multiprocessing/synchronize.py</filename>.
+      Run:
+
+<screen role="nodump"><userinput>mountpoint /dev/shm >/dev/null ||
+ mount -t tmpfs devshm /dev/shm</userinput></screen>
+
+    </para>
+    <!-- follow with appropriate text about exporting SHELL -->
Index: xsoft/graphweb/firefox.xml
===================================================================
--- xsoft/graphweb/firefox.xml	(revision b1fb2a9b4c2e7e70988a768423d7af3402c653ea)
+++ xsoft/graphweb/firefox.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -355,10 +355,13 @@
 echo "613364a7-9418-4c86-bcee-57e32fd70c23" > mozilla-key</userinput></screen>
 
-    <note><para>
-      If you are compiling <application>Firefox</application> in chroot, make
-      sure you have <envar>$SHELL</envar> environment variable set or prepend
-      <envar>SHELL=/bin/sh</envar>. Also ensure that <filename>/dev/shm</filename>
-      is mounted.
-    </para></note>
+    <note>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+       href="../../xincludes/mozshm.xml"/>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+       href="../../xincludes/mozmach.xml"/>
+
+    </note>
     <!--
     <para>
Index: xsoft/graphweb/seamonkey.xml
===================================================================
--- xsoft/graphweb/seamonkey.xml	(revision b1fb2a9b4c2e7e70988a768423d7af3402c653ea)
+++ xsoft/graphweb/seamonkey.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -256,9 +256,17 @@
 EOF</userinput></screen>
 
-    <note><para>
-      If you are compiling <application>SeaMonkey</application> in chroot, make
-      sure you have the <envar>SHELL</envar> environment variable set or prepend
-      <envar>SHELL=/bin/sh</envar> to the first make command below.
-    </para></note>
+    <note>
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+       href="../../xincludes/mozshm.xml"/>
+      <!-- if this package switches to using ./mach, replace the
+           folliowing by including mozmach.xml -->
+      <para>
+        Second, either as the <systemitem class="username">root</systemitem>
+        user export the <envar>$SHELL</envar> environment variable using
+        <command>export SHELL=/bin/sh</command> or else prepend
+        <envar>SHELL=/bin/sh</envar> when running the first
+        <command>make</command> command.
+      </para>
+    </note>
 
     <para>
Index: xsoft/other/thunderbird.xml
===================================================================
--- xsoft/other/thunderbird.xml	(revision b1fb2a9b4c2e7e70988a768423d7af3402c653ea)
+++ xsoft/other/thunderbird.xml	(revision 5b0a978e5d9c65837d7fe23ee7023fc5000c0ae3)
@@ -229,8 +229,12 @@
     </para>
 
-    <note><para>
-      If you are compiling <application>Thunderbird</application> in chroot,
-      prepend <envar>SHELL=/bin/sh</envar> to the build command below.
-    </para></note>
+    <note>
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+       href="../../xincludes/mozshm.xml"/>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+       href="../../xincludes/mozmach.xml"/>
+
+    </note>
 <!--
     <para>
