source: general/genlib/nspr.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 6.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY nspr-download-http "&mozilla-http;/nspr/releases/v&nspr-version;/src/nspr-&nspr-version;.tar.gz">
8 <!ENTITY nspr-download-ftp " ">
9 <!ENTITY nspr-md5sum "99780f9ffa3459392c1143f1408e0e08">
10 <!ENTITY nspr-size "1.0 MB">
11 <!ENTITY nspr-buildsize "11 MB">
12 <!ENTITY nspr-time "less than 0.1 SBU">
13]>
14
15<sect1 id="nspr" xreflabel="NSPR-&nspr-version;">
16 <?dbhtml filename="nspr.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>NSPR-&nspr-version;</title>
23
24 <indexterm zone="nspr">
25 <primary sortas="a-NSPR">NSPR</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to NSPR</title>
30
31 <para>
32 <application>Netscape Portable Runtime</application> (NSPR) provides a
33 platform-neutral API for system level and libc like functions.
34 </para>
35
36 &lfs101_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&nspr-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&nspr-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &nspr-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &nspr-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &nspr-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &nspr-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <para condition="html" role="usernotes">
73 User Notes: <ulink url="&blfs-wiki;/nspr"/>
74 </para>
75 </sect2>
76
77 <sect2 role="installation">
78 <title>Installation of NSPR</title>
79
80 <para>
81 Install <application>NSPR</application> by running the following commands:
82 </para>
83
84<screen><userinput>cd nspr &amp;&amp;
85sed -ri 's#^(RELEASE_BINS =).*#\1#' pr/src/misc/Makefile.in &amp;&amp;
86sed -i 's#$(LIBRARY) ##' config/rules.mk &amp;&amp;
87
88./configure --prefix=/usr \
89 --with-mozilla \
90 --with-pthreads \
91 $([ $(uname -m) = x86_64 ] &amp;&amp; echo --enable-64bit) &amp;&amp;
92make</userinput></screen>
93
94 <para>
95 The testsuite is designed for testing changes to nss or nspr and is
96 not particularly useful for checking a released version (e.g. it needs
97 to be run on a non-optimized build with both nss and nspr directories
98 existing alongside each other). For further details, see the User Notes
99 for nss at <ulink url="&blfs-wiki;/nss"/>
100 </para>
101
102 <para>
103 Now, as the <systemitem class="username">root</systemitem> user:
104 </para>
105
106<screen role="root"><userinput>make install</userinput></screen>
107 </sect2>
108
109 <sect2 role="commands">
110 <title>Command Explanations</title>
111
112 <para>
113 <command>sed -ri 's#^(RELEASE_BINS =).*#\1#'
114 pr/src/misc/Makefile.in</command>: This sed disables installing two unneeded
115 scripts.
116 </para>
117
118 <para>
119 <command>sed -i 's#$(LIBRARY) ##' config/rules.mk</command>: This sed disables
120 installing the static libraries.
121 </para>
122
123 <para>
124 <parameter>--with-mozilla</parameter>: This parameter adds Mozilla support
125 to the libraries (required if you want to build any other Mozilla
126 products and link them to these libraries).
127 </para>
128
129 <para>
130 <parameter>--with-pthreads</parameter>: This parameter forces use of the
131 system pthread library.
132 </para>
133
134 <para>
135 <parameter>$([ $(uname -m) = x86_64 ] &amp;&amp; echo
136 --enable-64bit)</parameter>: The --enable-64bit parameter is
137 <emphasis>required</emphasis> on an x86_64 system to prevent
138 <command>configure</command> failing with a claim that this is a system
139 without pthread support. The [ $(uname -m) = x86_64 ] test ensures it has
140 no effect on a 32 bit system.
141 </para>
142
143 </sect2>
144
145 <sect2 role="content">
146 <title>Contents</title>
147
148 <segmentedlist>
149 <segtitle>Installed Programs</segtitle>
150 <segtitle>Installed Libraries</segtitle>
151 <segtitle>Installed Directories</segtitle>
152
153 <seglistitem>
154 <seg>
155 nspr-config
156 </seg>
157 <seg>
158 libnspr4.so, libplc4.so and libplds4.so
159 </seg>
160 <seg>
161 /usr/include/nspr
162 </seg>
163 </seglistitem>
164 </segmentedlist>
165
166 <variablelist>
167 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
168 <?dbfo list-presentation="list"?>
169 <?dbhtml list-presentation="table"?>
170
171 <varlistentry id="nspr-config">
172 <term><command>nspr-config</command></term>
173 <listitem>
174 <para>
175 provides compiler and linker options to other packages that use
176 <application>NSPR</application>
177 </para>
178 <indexterm zone="nspr nspr-config">
179 <primary sortas="b-nspr-config">nspr-config</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry id="libnspr4">
185 <term><filename class="libraryfile">libnspr4.so</filename></term>
186 <listitem>
187 <para>
188 contains functions that provide platform independence for non-GUI
189 operating system facilities such as threads, thread synchronization,
190 normal file and network I/O, interval timing and calendar time,
191 basic memory management and shared library linking
192 </para>
193 <indexterm zone="nspr libnspr4">
194 <primary sortas="c-libnspr4">libnspr4.so</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="libplc4">
200 <term><filename class="libraryfile">libplc4.so</filename></term>
201 <listitem>
202 <para>
203 contains functions that implement many of the features offered by
204 libnspr4
205 </para>
206 <indexterm zone="nspr libplc4">
207 <primary sortas="c-libplc4">libplc4.so</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="libplds4">
213 <term><filename class="libraryfile">libplds4.so</filename></term>
214 <listitem>
215 <para>
216 contains functions that provide data structures
217 </para>
218 <indexterm zone="nspr libplds4">
219 <primary sortas="c-libplds4">libplds4.so</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 </variablelist>
225
226 </sect2>
227
228</sect1>
Note: See TracBrowser for help on using the repository browser.