source: chapter06/patch.xml@ 9c9d585

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<section xmlns="http://docbook.org/docbook-ng"
         xml:id="ch-system-patch" xreflabel="Patch" role="wrap">
<info><title>Patch-&patch-version;</title></info>
<?dbhtml filename="patch.html"?>

<indexterm zone="ch-system-patch"><primary sortas="a-Patch">Patch</primary></indexterm>

<section role="package"><info><title/></info>
<para>The Patch package contains a program for modifying files.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>1.9 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Patch installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
</segmentedlist>
</section>

<section role="installation">
<info><title>Installation of Patch</title></info>

<para>Prepare Patch for compilation (the preprocessor flag
<parameter>-D_GNU_SOURCE</parameter> is only needed on PowerPCs, on other
machines you can leave it out):</para>

<screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/usr</userinput></screen>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>Now install it:</para>

<screen><userinput>make install</userinput></screen>

</section>


<section xml:id="contents-patch" role="content"><info><title>Contents of Patch</title></info>

<segmentedlist>
<segtitle>Installed program</segtitle>
<seglistitem><seg>patch</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry xml:id="patch">
<term><command>patch</command></term>
<listitem>
<indexterm zone="ch-system-patch patch"><primary sortas="b-patch">patch</primary></indexterm>
<para>modifies files according to a patch file.
A patch file normally is a difference listing created with the <command>diff</command> program.
By applying these differences to the original files, <command>patch</command> creates the patched
versions. Using patches instead of entirely new tarballs to keep your sources
up-to-date can save you a lot of download time.</para>
</listitem>
</varlistentry>
</variablelist>

</section>

</section>