chapter05/ncurses.xml

   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
   8 <sect1 id="ch-tools-ncurses" role="wrap">
   9   <?dbhtml filename="ncurses.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>ncurses</productname>
  13     <productnumber>&ncurses-version;</productnumber>
  14     <address>&ncurses-url;</address>
  15   </sect1info>
  16
  17   <title>Ncurses-&ncurses-version;</title>
  18
  19   <indexterm zone="ch-tools-ncurses">
  20     <primary sortas="a-Ncurses">Ncurses</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/ncurses.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&ncurses-ch5-sbu;</seg>
  37         <seg>&ncurses-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Ncurses</title>
  45
  46     <para>Prepare Ncurses for compilation:</para>
  47
  48 <screen><userinput remap="configure">./configure --prefix=/tools --with-shared \
  49     --without-debug --without-ada --enable-overwrite</userinput></screen>
  50
  51     <variablelist>
  52       <title>The meaning of the configure options:</title>
  53
  54       <varlistentry>
  55         <term><parameter>--without-ada</parameter></term>
  56         <listitem>
  57           <para>This ensures that Ncurses does not build support for the Ada
  58           compiler which may be present on the host but will not be available
  59           once we enter the <command>chroot</command> environment.</para>
  60         </listitem>
  61       </varlistentry>
  62
  63       <varlistentry>
  64         <term><parameter>--enable-overwrite</parameter></term>
  65         <listitem>
  66           <para>This tells Ncurses to install its header files into
  67           <filename class="directory">/tools/include</filename>, instead of
  68           <filename class="directory">/tools/include/ncurses</filename>, to
  69           ensure that other packages can find the Ncurses headers
  70           successfully.</para>
  71         </listitem>
  72       </varlistentry>
  73
  74     </variablelist>
  75
  76     <para>Compile the package:</para>
  77
  78 <screen><userinput remap="make">make</userinput></screen>
  79
  80     <para>This package has a test suite, but it can only be run after the
  81     package has been installed.  The tests reside in the
  82     <filename class="directory">test/</filename> directory.  See the
  83     <filename>README</filename> file in that directory for further details.
  84     </para>
  85
  86     <para>Install the package:</para>
  87
  88 <screen><userinput remap="install">make install</userinput></screen>
  89
  90   </sect2>
  91
  92   <sect2 role="content">
  93     <title/>
  94
  95     <para>Details on this package are located in
  96     <xref linkend="contents-ncurses" role="."/></para>
  97
  98   </sect2>
  99
 100 </sect1>