source: BOOK/temp-system/common/ncurses.xml@ 4b96748f

<?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-temp-system-ncurses" role="wrap">
  <?dbhtml filename="ncurses.html"?>

  <title>Ncurses-&ncurses-version;</title>

  <indexterm zone="ch-temp-system-ncurses">
    <primary sortas="a-Ncurses">Ncurses</primary>
    <secondary>temporary system</secondary>
  </indexterm>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  href="../../final-system/common/ncurses.xml"
  xpointer="xpointer(//*[@role='package'])"/>

  <sect2 role="installation">
    <title>Installation of Ncurses</title>

    <para os="h">We will need Ncurses for several other packages in the
    temporary environment, including Bash, Util-linux, and Vim.</para>

    <para os="p1">The following patch fixes an issue with some Bash versions:</para>

<screen os="p2"><userinput>patch -Np1 -i ../&ncurses-bashfix-patch;</userinput></screen>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/ncurses.xml"
    xpointer="xpointer(//*[@os='a'])"/>

<screen os="b"><userinput>./configure --prefix=/tools --with-shared \
    --build=${CLFS_HOST} --host=${CLFS_TARGET} \
    --without-debug --without-ada \
    --enable-overwrite --with-build-cc=gcc</userinput></screen>

    <variablelist os="c">
      <title>The meaning of the new configure options:</title>

      <varlistentry>
        <term><parameter>--with-shared</parameter></term>
        <listitem>
          <para>This tells Ncurses to create a shared library.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-debug</parameter></term>
        <listitem>
          <para>This tells Ncurses not to build with debug information.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-ada</parameter></term>
        <listitem>
          <para>This ensures that Ncurses does not build support for the
          Ada compiler which may be present on the host but will not be
          available when building the final system.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--enable-overwrite</parameter></term>
        <listitem>
          <para>This tells Ncurses to install its header files into
          <filename class="directory">/tools/include</filename>, instead of
          <filename class="directory">/tools/include/ncurses</filename>, to
          ensure that other packages can find the Ncurses headers
          successfully.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--with-build-cc=gcc</parameter></term>
        <listitem>
          <para>This tells Ncurses which compiler to use to build native tools
          when cross-compiling.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/ncurses.xml"
    xpointer="xpointer(//*[@os='c'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/ncurses.xml"
    xpointer="xpointer(//*[@os='d'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/ncurses.xml"
    xpointer="xpointer(//*[@os='f'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/ncurses.xml"
    xpointer="xpointer(//*[@os='g'])"/>

  </sect2>

  <sect2 role="content">
    <title/>

    <para>Details on this package are located in <xref
    linkend="contents-ncurses" role="."/></para>

  </sect2>

</sect1>