Index: archive/js52.xml
===================================================================
--- archive/js52.xml	(revision 55c80c62286c06f6b96c6f865ab06b5bc996a1cd)
+++ archive/js52.xml	(revision 55c80c62286c06f6b96c6f865ab06b5bc996a1cd)
@@ -0,0 +1,222 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY js52-download-http "http://ftp.gnome.org/pub/gnome/teams/releng/tarballs-needing-help/mozjs/mozjs-&JS52-version;.tar.gz">
+  <!ENTITY js52-download-ftp  "ftp://ftp.gnome.org/pub/gnome/teams/releng/tarballs-needing-help/mozjs/mozjs-&JS52-version;.tar.gz">
+  <!ENTITY js52-md5sum        "72bd9a715ed1ab70b2aebe92969f6b63">
+  <!ENTITY js52-size          "36 MB">
+  <!ENTITY js52-buildsize     "627 MB">
+  <!ENTITY js52-time          "6.4 SBU">
+]>
+
+<sect1 id="js52" xreflabel="js52-&JS52-version;">
+  <?dbhtml filename="js52.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>JS-&JS52-version;</title>
+
+  <indexterm zone="js52">
+    <primary sortas="a-js52">js52</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to JS</title>
+
+    <para>
+      <application>JS</application> is Mozilla's JavaScript engine
+      written in C. This package is present for GJS and polkit.
+    </para>
+
+    &lfs84_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&js52-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&js52-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &js52-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &js52-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &js52-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &js52-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">JS52 Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="autoconf213"/>,
+      <xref linkend="icu"/>,
+      <xref linkend="nspr"/>,
+      <xref linkend="python2"/>,
+      <xref linkend="xorg7-lib"/>, and
+      <!-- <xref linkend="yasm"/>, -->
+      <xref linkend="zip"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="doxygen"/>
+    </para>
+
+    <para condition="html" role="usernotes">
+      User Notes: <ulink url="&blfs-wiki;/js52"/>
+    </para>
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of JS</title>
+
+    <para>
+      Install <application>JS</application> by running the following
+      commands:
+    </para>
+
+    &shell-env;
+
+<screen><userinput>cd js/src &amp;&amp;
+
+grep -rl -- '-Werror=format' |
+    xargs sed -i 's/error=format/no-&amp;/' &amp;&amp;
+
+./configure --prefix=/usr       \
+            --with-intl-api     \
+            --with-system-zlib  \
+            --with-system-nspr  \
+            --with-system-icu   \
+            --enable-readline   &amp;&amp;
+make</userinput></screen>
+
+    <para>
+      This package does not come with a working test suite.
+    </para>
+
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <command>grep -rl ...</command>: Allows building with GCC-9.1.
+    </para>
+
+    <para>
+      <parameter>--with-*</parameter>: These parameters allow the build system
+      to use system versions of the above libriares. These are required for
+      stability.
+    </para>
+
+    <para>
+      <parameter>--enable-readline</parameter>: This switch enables Readline
+      support in the JS shell.
+    </para>
+<!--    
+    <para>
+      <parameter>- -enable-threadsafe</parameter>: This switch enables support
+      for multiple threads at one time. This increases performance as well as
+      stability.
+    </para>
+-->
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries)</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>
+          js52 and js52-config
+        </seg>
+        <!-- Yes, the static library is required. -->
+        <seg>
+          libmozjs-52.so and libjs_static.ajs
+        </seg>
+        <seg>
+          /usr/include/mozjs-52
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="js5-js52">
+        <term><command>js52</command></term>
+        <listitem>
+          <para>
+            provides a command line interface to the
+            <application>JavaScript</application> engine.
+          </para>
+          <indexterm zone="js52 js52">
+            <primary sortas="b-js52">js52</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="js52-config">
+        <term><command>js52-config</command></term>
+        <listitem>
+          <para>
+            is used to find the JS compiler and linker flags.
+          </para>
+          <indexterm zone="js52 js52-config">
+            <primary sortas="b-js52-config">js52-config</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libmozjs-52">
+        <term><filename class="libraryfile">libmozjs-52.so</filename></term>
+        <listitem>
+          <para>
+            contains the Mozilla JavaScript API functions.
+          </para>
+          <indexterm zone="js52 libmozjs-52">
+            <primary sortas="c-libmozjs52">libmozjs-52.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect2>
+</sect1>
