mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-03-12 10:29:43 +00:00
a3ebe8aa2b
because some references appear to refer to the program itself, and not to the package. Corrected English idiom here and there.
138 lines
4.2 KiB
XML
138 lines
4.2 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
%general-entities;
|
|
]>
|
|
|
|
<sect1 id="ch-system-ninja" role="wrap">
|
|
<?dbhtml filename="ninja.html"?>
|
|
|
|
<sect1info condition="script">
|
|
<productname>ninja</productname>
|
|
<productnumber>&ninja-version;</productnumber>
|
|
<address>&ninja-url;</address>
|
|
</sect1info>
|
|
|
|
<title>Ninja-&ninja-version;</title>
|
|
|
|
<indexterm zone="ch-system-ninja">
|
|
<primary sortas="a-Ninja">Ninja</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title/>
|
|
|
|
<para>Ninja is a small build system with a focus on speed.</para>
|
|
|
|
<segmentedlist>
|
|
<segtitle>&buildtime;</segtitle>
|
|
<segtitle>&diskspace;</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>&ninja-fin-sbu;</seg>
|
|
<seg>&ninja-fin-du;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<tip revision="sysv">
|
|
<para>This section is not strictly required when LFS does not use
|
|
systemd. On the other hand, Ninja, along with Meson, makes
|
|
a powerful build system combination,
|
|
which will probably be used more and more often. It is required for
|
|
several packages in <ulink url="&blfs-book;">the BLFS
|
|
book</ulink>.</para>
|
|
</tip>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Ninja</title>
|
|
|
|
<para>When run, ninja normally utilizes the greatest possible number of processes
|
|
in parallel. By default this is the number of cores on the system,
|
|
plus two. This may overheat the CPU, or make the system run out
|
|
of memory. When ninja is invoked from the command line, passing the -jN parameter
|
|
will limit the number of parallel processes. Some packages
|
|
embed the execution of ninja, and do not pass the -j parameter on to it.</para>
|
|
|
|
<para>Using the <emphasis>optional</emphasis> procedure below allows a user to
|
|
limit the number of parallel processes via an environment variable,
|
|
NINJAJOBS. <emphasis role="bold">For example</emphasis>, setting:
|
|
|
|
<screen>export NINJAJOBS=4</screen>
|
|
|
|
will limit ninja to four parallel processes.</para>
|
|
|
|
<para>If desired, make ninja recognize the environment variable
|
|
NINJAJOBS by running the stream editor:</para>
|
|
|
|
<screen><userinput remap="pre">sed -i '/int Guess/a \
|
|
int j = 0;\
|
|
char* jobs = getenv( "NINJAJOBS" );\
|
|
if ( jobs != NULL ) j = atoi( jobs );\
|
|
if ( j > 0 ) return j;\
|
|
' src/ninja.cc</userinput></screen>
|
|
|
|
<para>Build Ninja with:</para>
|
|
|
|
<screen><userinput remap="configure">python3 configure.py --bootstrap</userinput></screen>
|
|
|
|
<variablelist>
|
|
<title>The meaning of the build option:</title>
|
|
|
|
<varlistentry>
|
|
<term><parameter>--bootstrap</parameter></term>
|
|
<listitem>
|
|
<para>This parameter forces Ninja to rebuild itself for the current
|
|
system.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>To test the results, issue:</para>
|
|
|
|
<screen><userinput remap="test">./ninja ninja_test
|
|
./ninja_test --gtest_filter=-SubprocessTest.SetWithLots</userinput></screen>
|
|
|
|
<para>Install the package:</para>
|
|
|
|
<screen><userinput remap="install">install -vm755 ninja /usr/bin/
|
|
install -vDm644 misc/bash-completion /usr/share/bash-completion/completions/ninja
|
|
install -vDm644 misc/zsh-completion /usr/share/zsh/site-functions/_ninja</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="contents-ninja" role="content">
|
|
<title>Contents of Ninja</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed programs</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>ninja</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="ninja">
|
|
<term><command>ninja</command></term>
|
|
<listitem>
|
|
<para>is the Ninja build system</para>
|
|
<indexterm zone="ch-system-ninja ninja">
|
|
<primary sortas="b-ninja">ninja</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|