source: general/genlib/nodejs.xml@ 25ef5f7

11.0 qt5new trunk
Last change on this file since 25ef5f7 was 25ef5f7, checked in by Douglas R. Reno <renodr@…>, 4 months ago

Restore node.js patch for ICU-69.1

  • Property mode set to 100644
File size: 7.7 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 nodejs-download-http "https://nodejs.org/dist/v&nodejs-version;/node-v&nodejs-version;.tar.xz">
8 <!ENTITY nodejs-download-ftp " ">
9 <!ENTITY nodejs-md5sum "813984b6029b5e69298ca58743732881">
10 <!ENTITY nodejs-size "32 MB">
11 <!ENTITY nodejs-buildsize "748 MB (add 21 MB for tests)">
12 <!ENTITY nodejs-time "9.1 SBU (using parallelism=4; add 2.1 SBU for tests)">
13 <!-- time might be longer on intel, on AMD the initial LFS SBU is very slow -->
14]>
15
16<sect1 id="nodejs" xreflabel="nodejs-&nodejs-version;">
17 <?dbhtml filename="nodejs.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Node.js-&nodejs-version;</title>
24
25 <indexterm zone="nodejs">
26 <primary sortas="a-nodejs">nodejs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Node.js</title>
31
32 <para>
33 <application>Node.js</application> is a
34 <application>JavaScript</application> runtime built on
35 <application>Chrome's</application> V8 JavaScript engine.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&nodejs-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&nodejs-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &nodejs-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &nodejs-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &nodejs-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &nodejs-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/node-v&nodejs-version;-icu_69-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83
84<!--<note>
85 <para>
86 This tarball was created using a BSD version of
87 <application>tar</application> and extracting it with a linux&trade;
88 version will produce harmless warnings about unknown extended header
89 keywords.
90 </para>
91 </note>-->
92
93 <bridgehead renderas="sect3">Node.js Dependencies</bridgehead>
94
95 <bridgehead renderas="sect4">Required</bridgehead>
96 <para role="required">
97 <xref linkend="which"/>
98 </para>
99
100 <bridgehead renderas="sect4">Recommended</bridgehead>
101 <para role="recommended">
102 <xref linkend="c-ares"/>,
103 <xref linkend="icu"/>,
104 <xref linkend="libuv"/>, and
105 <xref linkend="nghttp2"/>
106 </para>
107
108 <bridgehead renderas="sect4">Optional</bridgehead>
109 <para role="optional">
110 <ulink url="https://github.com/nodejs/http-parser">http-parser</ulink> and
111 <ulink url="https://www.npmjs.com/">npm</ulink> (an internal copy of
112 <command>npm</command> will be installed if not present)
113 </para>
114
115 <para condition="html" role="usernotes">
116 User Notes: <ulink url="&blfs-wiki;/nodejs"/>
117 </para>
118
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of Node.js</title>
123
124 <para>
125 First, apply a patch to fix building Node.js against ICU-69.1:
126 </para>
127
128<screen><userinput>patch -Np1 -i ../node-v&nodejs-version;-icu_69-1.patch</userinput></screen>
129
130 <para>
131 Build <application>Node.js</application> by running the following
132 commands:
133 </para>
134
135<screen><userinput>./configure --prefix=/usr \
136 --shared-cares \
137 --shared-libuv \
138 --shared-openssl \
139 --shared-nghttp2 \
140 --shared-zlib \
141 --with-intl=system-icu &amp;&amp;
142make</userinput></screen>
143
144 <para>
145 To test the results, issue: <command>make test-only</command>.
146 <!--One test, test-dns, is known to fail.-->
147 <!-- When using make check, a module is used that wasn't shipped properly
148 with the 12.16.2 release. See Ticket #13379 for details. We should
149 probably restore "make check" after the next version of Node.js.
150 This new command skips the documentation and lint checks. -renodr-->
151 </para>
152
153 <para>
154 Now, as the <systemitem class="username">root</systemitem> user:
155 </para>
156
157<screen role="root"><userinput>make install &amp;&amp;
158ln -sf node /usr/share/doc/node-&nodejs-version;</userinput></screen>
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <parameter>--with-intl=system-icu</parameter>: use the system version
166 of <application>icu</application>. Other values are
167 <option>full-icu</option> (to build a local, full
168 <application>icu</application> library) and <option>small-icu</option>
169 (to build a local, minimal <application>icu</application> library).
170 </para>
171
172 <para>
173 <!-- FIXME : reinstate nghttp2 in this if build is fixed
174 FIXME cont: Seems to be fixed in 12.18.1 -renodr
175 <parameter>\-\-shared-{cares,libuv,nghttp2,openssl,zlib}</parameter>: -->
176 <parameter>--shared-{cares,libuv,nghttp2,openssl,zlib}</parameter>:
177 use the system installed libraries instead of local copies.
178 </para>
179
180 <para>
181 <option>--without-npm</option>: do not build
182 <application>npm</application> (use if you'd like to build a separate
183 <application>npm</application> later).
184 </para>
185
186 <para>
187 <option>--shared-http-parser</option>: use the system
188 installed library instead of a local copy.
189 </para>
190
191 </sect2>
192
193 <sect2 role="content">
194 <title>Contents</title>
195
196 <segmentedlist>
197 <segtitle>Installed Programs</segtitle>
198 <segtitle>Installed Library</segtitle>
199 <segtitle>Installed Directories</segtitle>
200
201 <seglistitem>
202 <seg>
203 node, npm, and npx
204 </seg>
205 <seg>
206 None
207 </seg>
208 <seg>
209 /usr/include/node,
210 /usr/lib/node_modules/npm,
211 /usr/share/doc/{node,node-&nodejs-version;}, and
212 /usr/share/systemtap/tapset
213 </seg>
214 </seglistitem>
215 </segmentedlist>
216
217 <variablelist>
218 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
219 <?dbfo list-presentation="list"?>
220 <?dbhtml list-presentation="table"?>
221
222 <varlistentry id="node">
223 <term><command>node</command></term>
224 <listitem>
225 <para>
226 is the server-side JavaScript runtime
227 </para>
228 <indexterm zone="nodejs node">
229 <primary sortas="b-node">node</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="npm">
235 <term><command>npm</command></term>
236 <listitem>
237 <para>
238 is the <application>Node.js</application> package manager
239 </para>
240 <indexterm zone="nodejs npm">
241 <primary sortas="b-npm">npm</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry>
247 <term>
248 <filename class="directory">/usr/lib/node_modules/npm/</filename>
249 </term>
250 <listitem>
251 <para>
252 is the installation root for Node.js executables and libraries
253 </para>
254 </listitem>
255 </varlistentry>
256
257 </variablelist>
258
259 </sect2>
260
261</sect1>
Note: See TracBrowser for help on using the repository browser.