Added clarification about NSS/NSPR libraries to the Evolution and Evolution Data Server instructions

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

gnome/add/evolution-data-server.xml

@@ -68,9 +68,19 @@ xreflabel="Evolution Data Server-&evolution-data-server-version;">
     <para role="required"><xref linkend="libgnomeui"/> and
     <xref linkend="libsoup"/></para>
 
+    <bridgehead renderas="sect4">Recommended
+    (For SSL and S/MIME support)</bridgehead>
+    <para role="recommended"><xref linkend="nss"/></para>
+
+    <para>The <application>NSS</application> package is not required if you
+    have <xref linkend="firefox"/>, <xref linkend="thunderbird"/> or
+    <xref linkend="seamonkey"/> installed. These packages contain internal
+    copies of <application>NSS</application> (or they used a system-installed
+    copy). If any of the three packages are installed, one way or another you
+    will already have NSS/NSPR libraries on your system.</para>
+
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="openldap"/>,
-    <xref linkend="nss"/>,
     <xref linkend="sendmail"/>
     (or any other <ulink url="../server/mail.html">MTA</ulink>
     that provides a <command>sendmail</command> command),
@@ -90,9 +100,27 @@ xreflabel="Evolution Data Server-&evolution-data-server-version;">
     <para>Install <application>Evolution Data Server</application> by running
     the following commands:</para>
 
+    <note>
+      <para>The instructions below assume you have the NSS/NSPR libraries
+      installed on your system. If you elected not to install
+      <application>NSS</application> (or one of the other packages mentioned
+      above), you'll need to remove the following four parameter settings from
+      the <command>configure</command> command below:</para>
+
+      <literallayout><parameter>            --enable-nss
+            --enable-smime
+            --with-nspr-includes=/usr/include/nspr
+            --with-nss-includes=/usr/include/nss</parameter></literallayout>
+    </note>
+
 <screen><userinput>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
             --libexecdir=`pkg-config --variable=prefix \
-            ORBit-2.0`/lib/evolution-data-server-1.2 &amp;&amp;
+                ORBit-2.0`/lib/evolution-data-server-1.2 \
+            --enable-nntp \
+            --enable-nss \
+            --enable-smime \
+            --with-nspr-includes=/usr/include/nspr \
+            --with-nss-includes=/usr/include/nss &amp;&amp;
 make</userinput></screen>
 
     <para>To test the results, issue: <command>make -k check</command>.</para>
@@ -113,6 +141,24 @@ make</userinput></screen>
     instead of <filename
     class="directory">$GNOME_PREFIX/libexec</filename>.</para>
 
+    <para><parameter>--enable-nntp</parameter>: This parameter is used to build
+    the Usenet news (NNTP) backend.</para>
+
+    <para><parameter>--enable-nss</parameter>: This parameter is used to pull
+    in the Mozilla Network Security Services libraries for SSL support.</para>
+
+    <para><parameter>--enable-smime</parameter>: This parameter is used to pull
+    in the Mozilla Network Security Services libraries for S/MIME
+    support.</para>
+
+    <para><parameter>--with-{nspr,nss}-includes</parameter>: This parameter is
+    used to identify where the Mozilla Network Security Services interface
+    headers are located. By default,
+    <application>Evolution Data Server</application> uses
+    <filename>mozilla-{nss,nspr}.pc</filename> files to locate the headers
+    and chances are you will not have <application>Mozilla</application>
+    installed.</para>
+
     <note>
       <para>To enable many of the optional dependencies, review the information
       from <command>./configure --help</command> for the necessary parameters

introduction/welcome/changelog.xml

@@ -44,11 +44,15 @@
     <listitem>
       <para>April 26th, 2006</para>
       <itemizedlist>
+        <listitem>
+          <para>[randy] - Added clarification about NSS/NSPR libraries to the
+          Evolution and Evolution Data Server instructions.</para>
+        </listitem>
         <listitem>
           <para>[bdubbs] - Updated to iso-codes-0.51.</para>
         </listitem>
         <listitem>
-          <para>[bdubbs] - Updated ntp configuration to use pool serevers.</para>
+          <para>[bdubbs] - Updated ntp configuration to use pool servers.</para>
         </listitem>
         <listitem>
           <para>[bdubbs] - Updated to dhcp-3.0.3.</para>

xsoft/office/evolution.xml

@@ -65,23 +65,31 @@
     <para role="required"><xref linkend="gtkhtml"/> and
     <xref linkend="evolution-data-server"/></para>
 
-    <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended"><xref linkend="nss"/> (required for SSL and
-    S/MIME support)</para>
+    <bridgehead renderas="sect4">Recommended
+    (For SSL and S/MIME support)</bridgehead>
+    <para role="recommended"><xref linkend="nss"/></para>
+
+    <para>The <application>NSS</application> package is not
+    required if you have <xref linkend="firefox"/>,
+    <xref linkend="thunderbird"/> or <xref linkend="seamonkey"/> installed.
+    These packages contain internal copies of <application>NSS</application>
+    (or they used a system-installed copy). If any of the three packages
+    are installed, one way or another you will already have
+    NSS/NSPR libraries on your system.</para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="gstreamer"/>,
     <xref linkend="openldap"/>,
     <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
     <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
-    <ulink url="&gnome-download-http;/gnome-pilot-conduits/2.0/">
-    GNOME Pilot conduits</ulink> (requires <xref linkend="pilot-link"/> then
-    <ulink url="&gnome-download-http;/gnome-pilot/2.0/">
-    GNOME Pilot</ulink>),
+    <ulink url="&gnome-download-http;/gnome-pilot-conduits/2.0/">GNOME
+    Pilot conduits</ulink> (requires
+    <xref linkend="pilot-link"/> then
+    <ulink url="&gnome-download-http;/gnome-pilot/2.0/">GNOME Pilot</ulink>),
     <ulink url="&gnome-download-http;/gnome-spell/1.0/">
     GNOME Spell</ulink>,
     <xref linkend="dbus"/>,
-    <xref linkend="kdebase"/>,
+    <!-- <xref linkend="kdebase"/>, -->
     <xref linkend="gtk-doc"/>, and
     <xref linkend="docbook-utils"/></para>
 
@@ -96,10 +104,28 @@
     <para>Install <application>Evolution</application> by running the following
     commands:</para>
 
+    <note>
+      <para>The instructions below assume you have the NSS/NSPR libraries
+      installed on your system. If you elected not to install
+      <application>NSS</application> (or one of the other packages mentioned
+      above), you'll need to remove the following four parameter settings from
+      the <command>configure</command> command below:</para>
+
+      <literallayout><parameter>            --enable-nss
+            --enable-smime
+            --with-nspr-includes=/usr/include/nspr
+            --with-nss-includes=/usr/include/nss</parameter></literallayout>
+    </note>
+
 <screen><userinput>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
             --libexecdir=`pkg-config --variable=prefix ORBit-2.0`/lib \
             --localstatedir=/var/lib \
-            --sysconfdir=&gnome-etc-dir; &amp;&amp;
+            --sysconfdir=&gnome-etc-dir; \
+            --enable-nntp \
+            --enable-nss \
+            --enable-smime \
+            --with-nspr-includes=/usr/include/nspr \
+            --with-nss-includes=/usr/include/nss &amp;&amp;
 make</userinput></screen>
 
     <para>This package does not come with a test suite.</para>
@@ -122,6 +148,23 @@ ln -v -s evolution-2.4 \
     you wish to build and install the documentation.</para>
     -->
 
+    <para><parameter>--enable-nntp</parameter>: This parameter is used to build
+    the Usenet news (NNTP) backend.</para>
+
+    <para><parameter>--enable-nss</parameter>: This parameter is used to pull
+    in the Mozilla Network Security Services libraries for SSL support.</para>
+
+    <para><parameter>--enable-smime</parameter>: This parameter is used to pull
+    in the Mozilla Network Security Services libraries for S/MIME
+    support.</para>
+
+    <para><parameter>--with-{nspr,nss}-includes</parameter>: This parameter is
+    used to identify where the Mozilla Network Security Services interface
+    headers are located. By default, <application>Evolution</application> uses
+    <filename>mozilla-{nss,nspr}.pc</filename> files to locate the headers
+    and chances are you will not have <application>Mozilla</application>
+    installed.</para>
+
     <para><option>--with-openldap</option>: This parameter will compile
     LDAP support into <application>Evolution</application>.</para>