source: general/prog/ninja.xml@ 07499ecc

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 07499ecc was 07499ecc, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Archive udisks
Tags for general/progs

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

  • Property mode set to 100644
File size: 6.3 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 ninja-download-http "https://github.com/ninja-build/ninja/archive/v&ninja-version;/ninja-&ninja-version;.tar.gz">
8 <!ENTITY ninja-download-ftp " ">
9 <!ENTITY ninja-md5sum "5fdb04461cc7f5d02536b3bfc0300166">
10 <!ENTITY ninja-size "184 KB">
11 <!ENTITY ninja-buildsize "48 MB">
12 <!ENTITY ninja-time "0.2 SBU">
13]>
14
15<sect1 id="ninja" xreflabel="Ninja-&ninja-version;">
16 <?dbhtml filename="ninja.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Ninja-&ninja-version;</title>
24
25 <indexterm zone="ninja">
26 <primary sortas="a-Ninja">Ninja</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Ninja</title>
31
32 <para>
33 <application>Ninja</application> is a small build system with a focus on
34 speed.
35 </para>
36
37 <note>
38 <para>This package was installed as a part of the base LFS
39 system. The only reason to reinstall is to use the optional
40 dependencies for additional support files or documentation.
41 </para>
42 </note>
43
44 &lfs83_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&ninja-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&ninja-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &ninja-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &ninja-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &ninja-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &ninja-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Ninja Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="python3"/>
85 </para>
86
87 <bridgehead renderas="sect4">Optional</bridgehead>
88 <para role="optional">
89 <xref linkend="asciidoc"/> (to build the manual),
90 <xref linkend="emacs"/> (to generate lisp files),
91 <xref linkend="doxygen"/> (to build API documentation), and
92 <ulink url="http://re2c.sourceforge.net/">re2c</ulink>
93 (only needed to modify the build)
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/ninja"/>
98 </para>
99
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of Ninja</title>
104
105 <para>
106 Install <application>Ninja</application> by running the following
107 commands:
108 </para>
109
110<screen><userinput>python3 configure.py --bootstrap</userinput></screen>
111
112 <para>If Emacs is installed and you wish to build lisp files:</para>
113
114<screen><userinput>emacs -Q --batch -f batch-byte-compile misc/ninja-mode.el</userinput></screen>
115
116 <para>
117 To test the results, issue the following commands:
118 </para>
119
120<screen><userinput>python3 configure.py &amp;&amp;
121./ninja ninja_test &amp;&amp;
122./ninja_test --gtest_filter=-SubprocessTest.SetWithLots</userinput></screen>
123
124 <para>
125 Now, as the <systemitem class="username">root</systemitem> user:
126 </para>
127
128<screen role="root"><userinput>install -vm755 ninja /usr/bin/ &amp;&amp;
129install -vDm644 misc/ninja.vim \
130 /usr/share/vim/vim&vim-majmin;/syntax/ninja.vim &amp;&amp;
131install -vDm644 misc/bash-completion \
132 /usr/share/bash-completion/completions/ninja &amp;&amp;
133install -vDm644 misc/zsh-completion \
134 /usr/share/zsh/site-functions/_ninja</userinput></screen>
135
136 <para>
137 If Emacs is installed, while still the
138 <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>install -vDm644 misc/ninja-mode.el \
142 /usr/share/emacs/site-lisp/ninja-mode.el
143install -vDm644 misc/ninja-mode.elc \
144 /usr/share/emacs/site-lisp/ninja-mode.elc</userinput></screen>
145
146 <para>
147 If you have <xref linkend="asciidoc"/> installed and wish to build the
148 HTML manual, execute the following commands (as the
149 <systemitem class="username">root</systemitem> user):
150 </para>
151
152<screen role="root"><userinput>ninja manual &amp;&amp;
153install -vDm644 doc/manual.html /usr/share/doc/ninja-&ninja-version;/manual.html</userinput></screen>
154
155 <para>
156 If you have <xref linkend="doxygen"/> installed and wish to build the
157 API documentation, execute the following commands (as the
158 <systemitem class="username">root</systemitem> user):
159 </para>
160
161<screen role="root"><userinput>ninja doxygen &amp;&amp;
162install -vDm644 -t /usr/share/doc/ninja-&ninja-version;/ doc/doxygen/html/*</userinput></screen>
163
164 </sect2>
165
166 <sect2 role="commands">
167 <title>Command Explanations</title>
168
169 <para>
170 <command>emacs -Q --batch -f batch-byte-compile
171 misc/ninja-mode.el</command>: regenerates the emacs lisp files.
172 </para>
173
174 </sect2>
175
176 <sect2 role="content">
177 <title>Contents</title>
178
179 <segmentedlist>
180 <segtitle>Installed Programs</segtitle>
181 <segtitle>Installed Library</segtitle>
182 <segtitle>Installed Directories</segtitle>
183
184 <seglistitem>
185 <seg>
186 ninja
187 </seg>
188 <seg>
189 none
190 </seg>
191 <seg>
192 /usr/share/doc/ninja-&ninja-version;
193 </seg>
194 </seglistitem>
195 </segmentedlist>
196
197 <variablelist>
198 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
199 <?dbfo list-presentation="list"?>
200 <?dbhtml list-presentation="table"?>
201
202 <varlistentry id="ninja-prog">
203 <term><command>ninja</command></term>
204 <listitem>
205 <para>
206 is the Ninja build system.
207 </para>
208 <indexterm zone="ninja ninja-prog">
209 <primary sortas="b-ninja">ninja</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 </variablelist>
215
216 </sect2>
217
218</sect1>
Note: See TracBrowser for help on using the repository browser.