Ignore:
Timestamp:
03/14/2012 02:46:53 PM (12 years ago)
Author:
Andrew Benton <andy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
86e74f2f
Parents:
dfdc10b
Message:

firefox-11.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9694 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • x/lib/xulrunner.xml

    rdfdc10b rc1ae13c  
    1010  "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
    1111  <!-- md5sum and size should match firefox, but the buildsize and time will differ -->
    12   <!ENTITY xulrunner-md5sum        "5ce038d591964f72c534fa33b75a62f5">
    13   <!ENTITY xulrunner-size          "72 MB">
     12  <!ENTITY xulrunner-md5sum        "4b07acf47857aff72776d805409cdd1b">
     13  <!ENTITY xulrunner-size          "75 MB">
    1414  <!ENTITY xulrunner-buildsize     "2.6 GB (440 MB installed)">
    1515  <!ENTITY xulrunner-time          "22 SBU">
     
    3333    <title>Introduction to Xulrunner</title>
    3434
    35     <para><application>Xulrunner</application> is a runtime environment for XUL
    36     applications, and forms the major part of the
    37     <application>Mozilla</application> codebase. In particular, it provides the
    38     gecko engine together with pkgconfig files so that applications such as
    39     <application>Yelp</application> can find and use it.  However, be aware that
    40     Gnome applications are transitioning to <application>Webkit</application>
    41     instead of gecko.</para>
     35    <para>
     36      <application>Xulrunner</application> is a runtime environment for XUL
     37      applications, and forms the major part of the
     38      <application>Mozilla</application> codebase. In particular, it provides
     39      the Gecko engine together with pkgconfig files so that other applications
     40      can find and use it.
     41    </para>
    4242
    4343    &lfs71_checked;
     
    4646    <itemizedlist spacing="compact">
    4747      <listitem>
    48         <para>Download (HTTP): <ulink url="&xulrunner-download-http;"/></para>
    49       </listitem>
    50       <listitem>
    51         <para>Download (FTP): <ulink url="&xulrunner-download-ftp;"/></para>
    52       </listitem>
    53       <listitem>
    54         <para>Download MD5 sum: &xulrunner-md5sum;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Download size: &xulrunner-size;</para>
    58       </listitem>
    59       <listitem>
    60         <para>Estimated disk space required: &xulrunner-buildsize;</para>
    61       </listitem>
    62       <listitem>
    63         <para>Estimated build time: &xulrunner-time;</para>
     48        <para>
     49          Download (HTTP): <ulink url="&xulrunner-download-http;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download (FTP): <ulink url="&xulrunner-download-ftp;"/>
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download MD5 sum: &xulrunner-md5sum;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Download size: &xulrunner-size;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated disk space required: &xulrunner-buildsize;
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Estimated build time: &xulrunner-time;
     75        </para>
    6476      </listitem>
    6577    </itemizedlist>
     
    6880
    6981    <bridgehead renderas="sect4">Required</bridgehead>
    70     <para role="required"><xref linkend="alsa-lib"/>, <xref linkend="gtk2"/>,
    71     <xref linkend="zip"/> and <xref linkend="unzip"/>.</para>
    72 
    73     <para>Note: <application>libjpeg</application> and
    74     <application>libpng</application> (patched for apng support) should have
    75     been installed before <application>gdk-pixbuf</application> and should
    76     exist on your system. If for some strange reason you haven't installed
    77     them, you should remove the <option>--with-system-jpeg</option> and
    78     <option>--with-system-png</option> options from the
    79     <filename>mozconfig</filename> file created below.</para>
     82    <para role="required">
     83      <xref linkend="alsa-lib"/>,
     84      <xref linkend="gtk2"/>,
     85      <xref linkend="zip"/> and
     86      <xref linkend="unzip"/>.
     87    </para>
     88
     89    <para>
     90      Note: <application>libjpeg</application> and
     91      <application>libpng</application> (patched for apng support) should have
     92      been installed before <application>gdk-pixbuf</application> and should
     93      exist on your system. If for some strange reason you haven't installed
     94      them, you should remove the <option>--with-system-jpeg</option> and
     95      <option>--with-system-png</option> options from the
     96      <filename>mozconfig</filename> file created below.
     97    </para>
    8098
    8199    <bridgehead renderas="sect4">Recommended</bridgehead>
    82     <para role="recommended"><xref linkend="yasm"/> or
    83     <xref linkend="libvpx"/>.</para>
     100    <para role="recommended">
     101      <xref linkend="yasm"/> or <xref linkend="libvpx"/>
     102      (to allow <application>Xulrunner</application> to play webm videos).
     103    </para>
    84104
    85105    <bridgehead renderas="sect4">Optional</bridgehead>
    86     <para role="optional"><xref linkend="dbus-glib"/>,
    87     <xref linkend="startup-notification"/>, <xref linkend="sqlite"/>,
    88     <ulink url="http://www.webmproject.org/code/">libvpx</ulink>,
    89     <ulink url="http://sourceforge.net/projects/hunspell/">Hunspell</ulink>,
    90     <ulink url="http://libevent.org/">Libevent</ulink>,
    91     <xref linkend="doxygen"/>,
    92     <xref linkend="gnome-vfs"/> and <xref linkend="libgnomeui"/> (for gnome
    93     integration), <xref linkend="libnotify"/>, <xref linkend="nspr"/>,
    94     <xref linkend="nss"/>, <xref linkend="unzip"/>,
    95     <xref linkend="wireless_tools"/>,
    96     <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing
    97     the jemalloc code) and <xref linkend="wget"/></para>
    98 
    99     <para condition="html" role="usernotes">User Notes:
    100     <ulink url="&blfs-wiki;/xulrunner"/></para>
     106    <para role="optional">
     107      <xref linkend="dbus-glib"/>,
     108      <xref linkend="startup-notification"/>,
     109      <xref linkend="sqlite"/>,
     110      <ulink url="http://sourceforge.net/projects/hunspell/">Hunspell</ulink>,
     111      <ulink url="http://libevent.org/">Libevent</ulink>,
     112      <xref linkend="doxygen"/>,
     113      <xref linkend="gnome-vfs"/> and <xref linkend="libgnomeui"/> (for
     114      integration with the old version of <application>Gnome</application>),
     115      <xref linkend="libnotify"/>,
     116      <xref linkend="nspr"/>,
     117      <xref linkend="nss"/>,
     118      <xref linkend="wireless_tools"/>,
     119      <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing
     120      the jemalloc code) and
     121      <xref linkend="wget"/>
     122    </para>
     123
     124    <para condition="html" role="usernotes">
     125      User Notes: <ulink url="&blfs-wiki;/xulrunner"/>
     126    </para>
    101127  </sect2>
    102128
     
    104130    <title>Installation of Xulrunner</title>
    105131
    106     <para>The configuration of <application>Xulrunner</application> is
    107     accomplished by creating a <filename>mozconfig</filename> file containing
    108     the desired configuration options. A default <filename>mozconfig</filename>
    109     is created below. To see the entire list of available configuration options
    110     (and an abbreviated description of each one), issue
    111     <command>./configure --help</command>. You should review the entire file
    112     and comment or uncomment options as necessary.</para>
     132    <para>
     133      The configuration of <application>Xulrunner</application> is accomplished
     134      by creating a <filename>mozconfig</filename> file containing the desired
     135      configuration options. A default <filename>mozconfig</filename> is created
     136      below. To see the entire list of available configuration options (and an
     137      abbreviated description of each one), issue <command>./configure
     138      --help</command>. You should review the entire file and comment or
     139      uncomment options as necessary.
     140    </para>
    113141
    114142<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
     
    156184EOF</userinput></screen>
    157185
    158     <para>Install <application>Xulrunner</application> by issuing the
    159     following commands:</para>
     186    <para>
     187      Install <application>Xulrunner</application> by issuing the following
     188      commands:
     189    </para>
    160190
    161191<screen><userinput>sed -i 's#VPX_CODEC_USE_INPUT_PARTITION#VPX_CODEC_USE_INPUT_FRAGMENTS#' configure &amp;&amp;
     
    163193make -f client.mk</userinput></screen>
    164194
    165     <para>This package does not come with a test suite.</para>
    166 
    167     <para>Now, as the <systemitem class="username">root</systemitem>
    168     user:</para>
     195    <para>
     196      This package does not come with a test suite.
     197    </para>
     198
     199    <para>
     200      Now, as the <systemitem class="username">root</systemitem> user:
     201    </para>
    169202
    170203<screen role="root"><userinput>make -C xulrunner-build-dir install &amp;&amp;
     
    174207chown -Rv root:root /usr/{include,lib,share/idl}/xulrunner-*</userinput></screen>
    175208
    176     <para>If you elected to use the included NSPR and NSS (ie, if you have
    177     <emphasis>not</emphasis> installed <xref linkend="nspr"/> and
    178     <xref linkend="nss"/>), while still the
    179     <systemitem class="username">root</systemitem> user, complete the
    180     installation with the following commands:</para>
     209    <para>
     210      If you elected to use the included NSPR and NSS (ie, if you have
     211      <emphasis>not</emphasis> installed <xref linkend="nspr"/> and
     212      <xref linkend="nss"/>), while still the
     213      <systemitem class="username">root</systemitem> user, complete the
     214      installation with the following commands:
     215    </para>
    181216
    182217<screen role="root"><userinput>for DL in libnss3.so libnssutil3.so libsmime3.so \
     
    190225    <title>Command Explanations</title>
    191226
    192     <para><command>sed -i 's#VPX_CODEC_USE ...</command>: This fixes
    193     <application>Xulrunner's</application> <command>configure</command>
    194     script to properly detect libvpx-v1.0.0. It is not needed if you have
    195     libvpx-v0.9.7 or earlier installed or if you've not installed
    196     <xref linkend="libvpx"/>.</para>
    197 
    198     <para><command>sed ... Requires: nspr</command>: If you try to build
    199     <application>Yelp</application> without this, the
    200     prtypes header from NSPR will not be found. It is arguable whose error this
    201     is (the code presumably works on earlier geckos), but this fix is unlikely
    202     to cause any damage in other packages.</para>
    203 
    204     <para><command>make -f client.mk ...</command>: Mozilla products are
    205     packaged to allow the use of a configuration file which can be used to
    206     pass the configuration settings to the <command>configure</command>
    207     command. <command>make</command> uses the <filename>client.mk</filename>
    208     file to get initial configuration and setup parameters.</para>
    209 
    210     <para><command>ln -sv ../mozilla/plugins ...</command>: Some packages will
    211     install browser plugins into
    212     <filename class="directory">/usr/lib/mozilla/plugins</filename>.
    213     Creating this symlink <application>Xulrunner</application> keeps additional
    214     plugins in a common directory.</para>
    215 
    216     <para><command>for DL in ...</command>: The NSPR and NSS libraries shipped
    217     with this package are installed into
    218     <filename
    219     class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
    220     which means they will not be found at runtime.  By using symbolic links
    221     from <filename class="directory">/usr/lib</filename> the libraries will be
    222     found and the links can be easily changed to point to a newer version
    223     during an upgrade.</para>
    224 
    225    <note>
    226      <para>When you upgrade Xulrunner, remember to update the symlinks.</para>
    227    </note>
     227    <para>
     228      <command>sed -i 's#VPX_CODEC_USE_INPUT_PARTITION ...</command>: This fixes
     229      <application>Xulrunner's</application> <command>configure</command>
     230      script to properly detect <xref linkend="libvpx"/>. It is not needed if
     231      you have libvpx-v0.9.7 or earlier installed or if you've not installed
     232      <application>Libvpx</application>.
     233        </para>
     234
     235    <para>
     236      <command>sed ... Requires: nspr</command>: If you try to build some other
     237      applications without this, the prtypes header from NSPR will not be found.
     238    </para>
     239
     240    <para>
     241      <command>make -f client.mk ...</command>: Mozilla products are packaged to
     242      allow the use of a configuration file which can be used to pass the
     243      configuration settings to the <command>configure</command> command.
     244      <command>make</command> uses the <filename>client.mk</filename> file to
     245      get initial configuration and setup parameters.
     246    </para>
     247
     248    <para>
     249      <command>ln -sv ../mozilla/plugins ...</command>: Some packages will
     250      install browser plugins into
     251      <filename class="directory">/usr/lib/mozilla/plugins</filename>.
     252      Creating this symlink <application>Xulrunner</application> keeps
     253      additional plugins in a common directory.
     254    </para>
     255
     256    <para>
     257      <command>for DL in ...</command>: The NSPR and NSS libraries shipped
     258      with this package are installed into
     259      <filename class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
     260      which means they will not be found at runtime. By using symbolic links
     261      from <filename class="directory">/usr/lib</filename> the libraries will be
     262      found and the links can be easily changed to point to a newer version
     263      during an upgrade.
     264    </para>
     265
     266    <note>
     267      <para>
     268        When you upgrade Xulrunner, remember to update the symlinks.
     269      </para>
     270    </note>
    228271  </sect2>
    229272
     
    256299        <term><command>xulrunner</command></term>
    257300        <listitem>
    258           <para>is a shell script, useful for identifying the version
    259           installed.</para>
     301          <para>
     302            is a shell script, useful for identifying the version installed.
     303          </para>
    260304          <indexterm zone="xulrunner xulrunner-prog">
    261305            <primary sortas="b-xulrunner">xulrunner</primary>
Note: See TracChangeset for help on using the changeset viewer.