source: xsoft/graphweb/mozilla/mozilla-inst.xml@ f92a515

<sect2>
<title>Installation of <application>Mozilla</application></title>

<note>
<para>According to the financial institutions, the following hack makes your
browser insecure. You have been warned. Many sites use an MS-IE specific tag 
(autocomplete=off) to prevent autocomplete from working in some forms. This 
tag is now supported in <application>Mozilla</application> to appease the financial institutions. As per 
the requirements of the financial institutions, they will not even accept a 
solution where this a preference option. However our opinion is that it should 
be in the hands of the user. To enable autocomplete to bypass
this restriction, we need to make a slight modification in the code.</para>

<para>Open the file <filename>extensions/wallet/src/wallet.cpp</filename> in
the <application>Mozilla</application> source tree and search for the line:
<screen>#define WALLET_DONT_CACHE_ALL_PASSWORDS</screen>
Then delete or comment out the line.  Now, if anyone tells you MS-IE is user
friendly, give them this example!</para>
</note>

<para>If you plan to install Enigmail, extract the ipc and engimail tarballs
in the <filename class="directory">extensions</filename> directory.</para>

<para>Compile <application>Mozilla</application> by running the following 
commands:</para>

<screen><userinput><command>export MOZILLA_OFFICIAL="1" &amp;&amp;
export BUILD_OFFICIAL="1" &amp;&amp;
./configure --prefix=/usr \
            --enable-default-mozilla-five-home \
            --enable-toolkit-gtk2 --enable-default-toolkit=gtk2 \
            --with-x --with-system-zlib \
            --with-system-jpeg --with-system-png --with-system-mng \
            --enable-xft --enable-crypto \
            --enable-java-supplement \
            --disable-accessibility \
            --disable-tests --disable-debug \
            --disable-logging --enable-reorder \
            --enable-strip --disable-pedantic \
            --enable-cpp-rtti --enable-extensions=all &amp;&amp;
make</command></userinput></screen>

<para>If installing Enigmail, execute the following steps:</para>

<screen><userinput><command>cd extensions/ipc &amp;&amp;
./makemake -r &amp;&amp;
make &amp;&amp;
cd ../enigmail &amp;&amp;
./makemake -r &amp;&amp;
make &amp;&amp;
cd ../..</command></userinput></screen>

<para>Install <application>Mozilla</application> as follows:</para>

<screen><userinput><command>make install &amp;&amp;
install -d /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
   /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
ln -nsf mozilla-&mozilla-version; /usr/include/mozilla &amp;&amp;
ln -nsf mozilla-&mozilla-version; /usr/lib/mozilla</command></userinput></screen>

<para>Install Enigmail as follows:</para>

<screen><userinput><command>for i in components/enigmime.xpt \
components/ipc.xpt components/libenigmime.so components/enigmail.js \
components/enigmail.xpt chrome/enigmail.jar
do
        install dist/bin/$i /usr/lib/mozilla-&mozilla-version;/$i
done</command></userinput></screen>

<para>To enable multi-user operation, execute the following:</para>

<screen><userinput><command>cd /usr/lib/mozilla-&mozilla-version; &amp;&amp;
export LD_LIBRARY_PATH="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
export MOZILLA_FIVE_HOME="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
./regxpcom &amp;&amp;
./regchrome &amp;&amp;
touch `find /usr/lib/mozilla-&mozilla-version; -name *.rdf`</command></userinput></screen>

</sect2>

<sect2>
<title>Optional Extra Switches</title>

<para>Each of these switches can be added to the configure line in order to
have the described effect on the <application>Mozilla</application> compile.</para>

<para><option>--enable-elf-dynstr-gc</option>: Removes un-referenced
strings from <acronym>ELF</acronym> shared objects generated during the build. 
Note that this option breaks build on alpha.</para>

<para><option>--disable-mailnews</option>: Disable the mail and news
clients.</para>

<para><option>--disable-ldap</option>: Disable <acronym>LDAP</acronym> 
Support, recommended if mail is disabled.</para>

<para><option>--enable-calendar</option>: Build the calendar client.</para>

<para><option>--enable-xterm-updates</option>: This option is
for enabling the <command>xterm</command> title with the current command when 
compiling.</para>

<para><option>--enable-plaintext-editor-only</option>: Disable support
for <acronym>HTML</acronym> editing. Do not use this switch if you are building 
the mail-news component.</para>

</sect2>

<sect2>
<title>Additional build notes for <application>Mozilla Firebird</application> &firebird-version;</title>

<para>Add the following env variable (The variable is named Phoenix since
that was the original name for the <application>Mozilla
Firebird</application> project):</para>

<screen><userinput><command>export MOZ_PHOENIX="1"</command></userinput></screen>

<para>Make sure that the following switches are passed to
<command>./configure</command>: <option>--disable-calendar</option> and
<option>--disable-mailnews</option>.</para>

<para>We recommend installing in a separate prefix 
such as <parameter>--prefix=/opt/firebird-&firebird-version;</parameter>
to prevent clashes with
an installed <application>Mozilla</application>.</para>

<para>The <application>Mozilla Firebird</application> executable is
<command>MozillaFirebird</command>.</para>

</sect2>

<sect2>
<title>Additional build notes for <application>Mozilla Thunderbird</application> &thunderbird-version;</title>

<para>Add the following env variable:</para>

<screen><userinput><command>export MOZ_THUNDERBIRD="1"</command></userinput></screen>

<para>Make sure that the following switches is passed to
<command>./configure</command>: <option>--disable-calendar</option>.</para>

<para>We recommend installing in a separate prefix 
such as
<parameter>--prefix=/opt/thunderbird-&thunderbird-version;</parameter>
to prevent clashes with
an installed <application>Mozilla</application>.</para>

<para>The <application>Mozilla Thunderbird</application> executable is
<command>thunderbird</command>.</para>

</sect2>