ncurses.xml 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. <?xml version="1.0" encoding="UTF-8"?>
  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. <sect1 id="ch-tools-ncurses" role="wrap">
  8. <?dbhtml filename="ncurses.html"?>
  9. <sect1info condition="script">
  10. <productname>ncurses</productname>
  11. <productnumber>&ncurses-version;</productnumber>
  12. <address>&ncurses-url;</address>
  13. </sect1info>
  14. <title>Ncurses-&ncurses-version;</title>
  15. <indexterm zone="ch-tools-ncurses">
  16. <primary sortas="a-Ncurses">Ncurses</primary>
  17. <secondary>tools</secondary>
  18. </indexterm>
  19. <sect2 role="package">
  20. <title/>
  21. <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  22. href="../chapter06/ncurses.xml"
  23. xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  24. <segmentedlist>
  25. <segtitle>&buildtime;</segtitle>
  26. <segtitle>&diskspace;</segtitle>
  27. <seglistitem>
  28. <seg>&ncurses-ch5-sbu;</seg>
  29. <seg>&ncurses-ch5-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>安装 Ncurses</title>
  35. <!--para>First, ensure that <command>gawk</command> is found first during configuration:</para-->
  36. <para>首先,保证在配置时首先找到 <command>gawk</command> 命令:</para>
  37. <screen><userinput remap="pre">sed -i s/mawk// configure</userinput></screen>
  38. <para>准备编译 Ncurses:</para>
  39. <screen><userinput remap="configure">./configure --prefix=/tools \
  40. --with-shared \
  41. --without-debug \
  42. --without-ada \
  43. --enable-widec \
  44. --enable-overwrite</userinput></screen>
  45. <variablelist>
  46. <title>配置选项的含义:</title>
  47. <varlistentry>
  48. <term><parameter>--without-ada</parameter></term>
  49. <listitem>
  50. <!--para>This ensures that Ncurses does not build support for the Ada
  51. compiler which may be present on the host but will not be available
  52. once we enter the <command>chroot</command> environment.</para-->
  53. <para>这保证不构建 Ncurses 的 Ada 编译器支持,宿主环境可能有
  54. Ada 编译器,但进入 <command>chroot</command> 环境后
  55. Ada 编译器就不再可用。</para>
  56. </listitem>
  57. </varlistentry>
  58. <varlistentry>
  59. <term><parameter>--enable-overwrite</parameter></term>
  60. <listitem>
  61. <!--para>This tells Ncurses to install its header files into
  62. <filename class="directory">/tools/include</filename>, instead of
  63. <filename class="directory">/tools/include/ncurses</filename>, to
  64. ensure that other packages can find the Ncurses headers
  65. successfully.</para-->
  66. <para>这告诉 Ncurses 将头文件安装在
  67. <filename class="directory">/tools/include</filename>,
  68. 而不是
  69. <filename class="directory">/tools/include/ncurses</filename>
  70. ,从而保证其他软件包可以成功找到 Ncurses 头文件。</para>
  71. </listitem>
  72. </varlistentry>
  73. <varlistentry>
  74. <term><parameter>--enable-widec</parameter></term>
  75. <listitem>
  76. <!--para>This switch causes wide-character libraries (e.g., <filename
  77. class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
  78. to be built instead of normal ones (e.g., <filename
  79. class="libraryfile">libncurses.so.&ncurses-version;</filename>).
  80. These wide-character libraries are usable in both multibyte and
  81. traditional 8-bit locales, while normal libraries work properly
  82. only in 8-bit locales. Wide-character and normal libraries are
  83. source-compatible, but not binary-compatible.</para-->
  84. <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  85. href="../chapter06/ncurses.xml"
  86. xpointer="xpointer(//*[@os='widec'])"/>
  87. </listitem>
  88. </varlistentry>
  89. </variablelist>
  90. <para>编译该软件包:</para>
  91. <screen><userinput remap="make">make</userinput></screen>
  92. <!--para>This package has a test suite, but it can only be run after the
  93. package has been installed. The tests reside in the
  94. <filename class="directory">test/</filename> directory. See the
  95. <filename>README</filename> file in that directory for further details.
  96. </para-->
  97. <para>该软件包有测试套件,但必须在安装软件包后运行。测试文件位于
  98. <filename class="directory">test/</filename> 目录中,阅读其中的
  99. <filename>README</filename> 文件了解更多信息。</para>
  100. <para>安装该软件包:</para>
  101. <screen><userinput remap="install">make install
  102. ln -s libncursesw.so /tools/lib/libncurses.so</userinput></screen>
  103. </sect2>
  104. <sect2 role="content">
  105. <title/>
  106. <para>该软件包的详细信息可以在
  107. <xref linkend="contents-ncurses"/> 中找到。</para>
  108. </sect2>
  109. </sect1>