Changeset 23102484


Ignore:
Timestamp:
01/17/2006 08:46:21 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Children:
f658b21
Parents:
5aa74f2
Message:

Ported the proper r7279 plus r7281 from trunk to alphabetical.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/alphabetical/BOOK@7282 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Location:
chapter05
Files:
13 edited

Legend:

Unmodified
Added
Removed

  • chapter05/adjusting.xml

    r5aa74f2 r23102484  
    99  <?dbhtml filename="adjusting.html"?>
    1010
    11   <title>Ajustar las herramientas</title>
     11  <title>Adjusting the Toolchain</title>
    1212
    13   <para>Ahora que se han instalado las librerías de C temporales, todas las
    14   herramientas que compilemos en el resto de este capítulo deberían enlazarse
    15   contra ellas. Para conseguirlo, deben ajustarse el enlazador y el fichero
    16   specs del compilador.</para>
     13  <para>Now that the temporary C libraries have been installed, all
     14  tools compiled in the rest of this chapter should be linked against
     15  these libraries. In order to accomplish this, the linker and the
     16  compiler's specs file need to be adjusted.</para>
    1717
    18   <para>El enlazador, que se ajustó al final del primer paso de Binutils,
    19   se instala ejecutando el siguiente comando desde el directorio
    20   <filename class="directory">binutils-build</filename>:</para>
     18  <para>The linker, adjusted at the end of the first pass of Binutils,
     19  is installed by running the following command from within the
     20  <filename class="directory">binutils-build</filename> directory:</para>
    2121
    2222<screen><userinput>make -C ld install</userinput></screen>
    2323
    24   <para>Desde ahora todo se enlazará solamente contra las librerías que hay en
    25   <filename class="directory">/tools/lib</filename>.</para>
     24  <para>From this point onwards, everything will link only against the
     25  libraries in <filename class="directory">/tools/lib</filename>.</para>
    2626
    2727  <note>
    28     <para>Si por alguna razón olvidaste el aviso sobre conservar los directorios
    29     de las fuentes y de construcción del primer paso de Binutils, ignora el
    30     comando anterior. El resultado es la pequeña pega de que los siguientes
    31     programas de pruebas se enlazarán contra las librerías del anfitrión. Esto
    32     no es lo ideal, pero no es un gran problema. La situación se corregirá
    33     cuando instalemos un poco más adelante la segunda fase de Binutils.</para>
     28    <para>If the earlier warning to retain the Binutils source and
     29    build directories from the first pass was missed, ignore the above
     30    command. This results in a small chance that the subsequent testing
     31    programs will link against libraries on the host. This is not ideal,
     32    but it is not a major problem. The situation is corrected when the
     33    second pass of Binutils is installed later.</para>
    3434  </note>
    3535
    36   <para>Ahora que se ha instalado el enlazador ajustado, debes eliminar los
    37   directorios de las fuentes y de construcción de Binutils.</para>
     36  <para>Now that the adjusted linker is installed, the Binutils build and source
     37  directories should be removed.</para>
    3838
    39   <para>Lo siguiente esapuntar GCC al nuevo enlazador dinámico. Esto se hace
    40   volcando el fichero <quote>specs</quote>de GCC a un lugar en el que GCC lo
    41   busque por defecto. Entonces una simple sustitución <command>sed</command>
    42   altera el enlazdor inámic que GCC usará:</para>
     39  <para>The next task is to point GCC to the new dynamic linker. This is done by
     40  dumping GCC's <quote>specs</quote> file to a location where GCC will look for it
     41  by default. A simple <command>sed</command> substitution then alters the
     42  dynamic linker that GCC will use:</para>
    4343
    44 <!-- Ampersands are needed to allow cut and paste -->
     44<!-- Ampersands are needed to allow copy and paste -->
    4545<screen><userinput>SPECFILE=`dirname $(gcc -print-libgcc-file-name)`/specs &amp;&amp;
    4646gcc -dumpspecs > $SPECFILE &amp;&amp;
    … …  
    4949unset SPECFILE</userinput></screen>
    5050
    51   <para><phrase condition="html">Recomendamos que copies y pegues lo anterior
    52   para asegurar que no hay errores.</phrase> Alternativamente, puedes editar el
    53   fichero specs a mano si quieres. Esto se hace reemplazando cada aparición de
    54   <quote>/lib/ld-linux.so.2</quote> con <quote>/tools/lib/ld-linux.so.2</quote>.</para>
     51  <para>It is recommended that the above command be copy-and-pasted in order to
     52  ensure accuracy. Alternatively, the specs file can be edited by hand. This is
     53  done by replacing every occurrence of <quote>/lib/ld-linux.so.2</quote> with
     54  <quote>/tools/lib/ld-linux.so.2</quote></para>
    5555
    56   <para>Asegúrate de revisar visualmente el fichero specs para
    57   verificar que se han hecho los cambios deseados.</para>
     56  <para>Be sure to visually inspect the specs file in order to verify the
     57  intended changes have been made.</para>
    5858
    5959  <important>
    60     <para>Si estás trabajando sobre una plataforma en la que el nombre del
    61     enlazador dinámico no es <filename class="libraryfile">ld-linux.so.2</filename>,
    62     en el anterior comando debes sustituir <filename>ld-linux.so.2</filename> con
    63     el nombre del enlazador dinámico de tu plataforma. En caso necesario consulta
    64     la <xref linkend="ch-tools-toolchaintechnotes"/>.</para>
     60    <para>If working on a platform where the name of the dynamic linker is
     61    something other than <filename class="libraryfile">ld-linux.so.2</filename>,
     62    replace <quote>ld-linux.so.2</quote> with the name of the platform's
     63    dynamic linker in the above commands. Refer back to <xref
     64    linkend="ch-tools-toolchaintechnotes" role=","/> if necessary.</para>
    6565  </important>
    6666
    67   <para>Durante el proceso de construcción, GCC ejecuta un guión
    68   (<command>fixincludes</command>) que explora el sistema buscando ficheros de
    69   cabecera que puedan necesitar ser corregidos (que pueden contener errores de
    70   sintaxis, por ejemplo), e instala las versiones corregidas en un directorio
    71   privado. Existe la posibilidad de que, como resultado de este proceso, algunos
    72   ficheros de cabecera del sistema anfitrión se hayan colado dentro de dicho
    73   directorio privado de cabeceras de GCC. Como el resto de este capítulo sólo
    74   necesita las cabeceras de GCC y Glibc, que ya han sido instaladas, cualquier
    75   cabecera <quote>fijada</quote> puede borrarse sin problemas. Esto ayuda a
    76   evitar que cualquier cabecera del anfitrión contamine el entorno de
    77   construcción. Ejecuta los siguientes comandos para eliminr dichos ficheros de
    78   cabecera (puede que encuentres más facil copiar y pegar estos comandos en vez
    79   de teclearlos, debido a su longitud):</para>
     67  <para>During the build process, GCC runs a script
     68  (<command>fixincludes</command>) that scans the system for header files
     69  that may need to be fixed (they might contain syntax errors, for example),
     70  and installs the fixed versions in a private include directory. There is a
     71  possibility that, as a result of this process, some header files from the
     72  host system have found their way into GCC's private include directory. As
     73  the rest of this chapter only requires the headers from GCC and Glibc,
     74  which have both been installed at this point, any <quote>fixed</quote>
     75  headers can safely be removed. This helps to avoid any host headers
     76  polluting the build environment. Run the following commands to remove the
     77  header files in GCC's private include directory (you may find it easier to
     78  copy and paste these commands, rather than typing them by hand, due to
     79  their length):</para>
    8080
    8181<!-- && used to ease copy and pasting -->
    … …  
    8686
    8787  <caution>
    88     <para>En este punto es obligatorio parar y asegurarse de que las operaciones
    89     básicas (compilación y enlazado) de las nuevas herramientas funcionan como
    90     se espera. Para esto vamos a hacer una simple comprobación:</para>
     88    <para>At this point, it is imperative to stop and ensure that the basic
     89    functions (compiling and linking) of the new toolchain are working as
     90    expected. To perform a sanity check, run the following commands:</para>
    9191
    9292<screen><userinput>echo 'main(){}' &gt; dummy.c
    … …  
    9494readelf -l a.out | grep ': /tools'</userinput></screen>
    9595
    96     <para>Si todo funciona correctamente, no debe haber errores y la salida del
    97     último comando debe ser:</para>
     96    <para>If everything is working correctly, there should be no errors,
     97    and the output of the last command will be of the form:</para>
    9898
    9999<screen><computeroutput>[Requesting program interpreter:
    100     /tools/lib/ld-linux.so.2]
    101 
    102 [Intérprete de programa solicitado:
    103100    /tools/lib/ld-linux.so.2]</computeroutput></screen>
    104101
    105     <para>Confirma que <filename class="directory">/tools/lib</filename>
    106     aparezca como el prefijo de tu enlazador dinámico.</para>
     102    <para>Note that <filename class="directory">/tools/lib</filename>
     103    appears as the prefix of the dynamic linker.</para>
    107104
    108     <para>Si no recibes una salida como la mostrada arriba, o no hay salida
    109     alguna, algo está seriamente mal. Investiga y revisa tus pasos para
    110     encontrar el problema y corregirlo. El problema debe resolverse antes de
    111     continuar. Primero, repite la comprobación de sanidad usando
    112     <command>gcc</command> en vez de <command>cc</command>. Si esto funciona
    113     significa que falta el enlace simbólico <filename
    114     class="symlink">/tools/bin/cc</filename>. Vuelve a la <xref
    115     linkend="ch-tools-gcc-pass1"/> e instala el enlace simbólico. Seguidamente,
    116     asegúrate de que tu <envar>PATH</envar> es correcto. Puedes comprobarlo
    117     ejecutando <command>echo $PATH</command> y verificando que <filename
    118     class="directory">/tools/bin</filename> está en cabeza de la lista. Si
    119     el <envar>PATH</envar> está mal puede significar que no has ingresado
    120     como usuario <systemitem class="username">lfs</systemitem> o que algo
    121     salió mal en la <xref linkend="ch-tools-settingenviron"/>. Otra opción es
    122     que algo pudo ir mal en el anterior arreglo del fichero specs. En este caso,
    123     repite el arreglo del fichero<phrase condition="html"> asegurándote de
    124     copiar y pegar los comandos como se recomendó</phrase>.</para>
     105    <para>If the output is not shown as above or there was no output at all,
     106    then something is wrong. Investigate and retrace the steps to find out
     107    where the problem is and correct it. This issue must be resolved before
     108    continuing on. First, perform the sanity check again, using
     109    <command>gcc</command> instead of <command>cc</command>. If this works,
     110    then the <filename class="symlink">/tools/bin/cc</filename> symlink is
     111    missing. Revisit <xref linkend="ch-tools-gcc-pass1" role=","/> and install
     112    the symlink. Next, ensure that the <envar>PATH</envar> is correct. This
     113    can be checked by running <command>echo $PATH</command> and verifying that
     114    <filename class="directory">/tools/bin</filename> is at the head of the
     115    list. If the <envar>PATH</envar> is wrong it could mean that you are not
     116    logged in as user <systemitem class="username">lfs</systemitem> or that
     117    something went wrong back in <xref linkend="ch-tools-settingenviron"
     118    role="."/> Another option is that something may have gone wrong with the
     119    specs file amendment above. In this case, redo the specs file amendment,
     120    being careful to copy-and-paste the commands.</para>
    125121
    126     <para>Cuando todo esté bien, borra los ficheros de prueba:</para>
     122    <para>Once all is well, clean up the test files:</para>
    127123
    128124<screen><userinput>rm -v dummy.c a.out</userinput></screen>
    129125
    130     <para>La construcción de TCL en la siguiente sección servirá como comprobación
    131     adicional de que las herramientas se han construido correctamente. Si la
    132     construcción de TCL falla, esto es una indicación de que algo fué mal durante
    133     la instalación de Binutils, GCC o Glibc, pero no con el propio TCL.</para>
     126    <para>Building TCL in the next section will serve as an additional check that
     127    the toolchain has been built properly.  If TCL fails to build, it is an
     128    indication that something has gone wrong with the Binutils, GCC, or Glibc
     129    installation, but not with TCL itself.</para>
    134130  </caution>
    135131

  • chapter05/bash.xml

    r5aa74f2 r23102484  
    1313  <indexterm zone="ch-tools-bash">
    1414    <primary sortas="a-Bash">Bash</primary>
    15     <secondary>herramientas</secondary>
     15    <secondary>tools</secondary>
    1616  </indexterm>
    1717
    … …  
    4040
    4141  <sect2 role="installation">
    42     <title>Instalación de Bash</title>
     42    <title>Installation of Bash</title>
    4343
    44     <para>Prepara Bash para su compilación:</para>
     44    <para>Prepare Bash for compilation:</para>
    4545
    4646<screen><userinput>./configure --prefix=/tools --without-bash-malloc</userinput></screen>
    4747
    4848    <variablelist>
    49       <title>Significado de la opción de configure:</title>
     49      <title>The meaning of the configure options:</title>
    5050
    5151      <varlistentry>
    5252        <term><parameter>--without-bash-malloc</parameter></term>
    5353        <listitem>
    54           <para>Esta opción desactiva el uso de la función de ubicación de memoria
    55           (<function>malloc</function>) de Bash, que se sabe que provoca
    56           violaciones de segmento. Al desactivar esta opción Bash utilizará la
    57           función <function>malloc</function> de Glibc, que es más estable.</para>
     54          <para>This options turns off the use of Bash's memory allocation
     55          (<function>malloc</function>) function which is known to cause
     56          segmentation faults. By turning this option off, Bash will use
     57          the <function>malloc</function> functions from Glibc which are
     58          more stable.</para>
    5859        </listitem>
    5960      </varlistentry>
     61
    6062    </variablelist>
    6163
    62     <para>Compila el paquete:</para>
     64    <para>Compile the package:</para>
    6365
    6466<screen><userinput>make</userinput></screen>
    6567
    66     <para>Para comprobar los resultados, ejecuta:
     68    <para>To test the results, issue:
    6769    <userinput>make tests</userinput>.</para>
    6870
    69     <para>Instala el paquete:</para>
     71    <para>Install the package:</para>
    7072
    7173<screen><userinput>make install</userinput></screen>
    7274
    73     <para>Crea un enlace para los programas que usan <command>sh</command>
    74     como intérprete de comandos:</para>
     75    <para>Make a link for the programs that use <command>sh</command> for
     76    a shell:</para>
    7577
    7678<screen><userinput>ln -vs bash /tools/bin/sh</userinput></screen>
    … …  
    8183    <title/>
    8284
    83     <para>Los detalles sobre este paquete se encuentran en la <xref
    84     linkend="contents-bash"/>.</para>
     85    <para>Details on this package are located in
     86    <xref linkend="contents-bash" role="."/></para>
    8587
    8688  </sect2>

  • chapter05/binutils-pass1.xml

    r5aa74f2 r23102484  
    99  <?dbhtml filename="binutils-pass1.html"?>
    1010
    11   <title>Binutils-&binutils-version; - Fase 1</title>
     11  <title>Binutils-&binutils-version; - Pass 1</title>
    1212
    1313  <indexterm zone="ch-tools-binutils-pass1">
    1414    <primary sortas="a-Binutils">Binutils</primary>
    15     <secondary>herramientas, fase 1</secondary>
     15    <secondary>tools, pass 1</secondary>
    1616  </indexterm>
    1717
    … …  
    4040
    4141  <sect2 role="installation">
    42     <title>Instalación de Binutils</title>
     42    <title>Installation of Binutils</title>
    4343
    44     <para>Es importante que Binutils sea el primer paquete que compiles, pues
    45     tanto Glibc como GCC llevan a cabo varias comprobaciones sobre el enlazador y
    46     el ensamblador disponibles para determinar qué características activar.</para>
     44    <para>It is important that Binutils be the first package compiled
     45    because both Glibc and GCC perform various tests on the available
     46    linker and assembler to determine which of their own features to
     47    enable.</para>
    4748
    48     <para>La documentación de Binutils recomienda construirlo en un directorio
    49     dedicado, fuera del árbol de las fuentes:</para>
     49    <para>The Binutils documentation recommends building Binutils outside of the
     50    source directory in a dedicated build directory:</para>
    5051
    5152<screen><userinput>mkdir -v ../binutils-build
    … …  
    5354
    5455    <note>
    55       <para>Si quieres que los valores de los SBUs mostrados en el resto del
    56       libro sean de utilidad, mide el tiempo que se tarda en construir este
    57       paquete desde la compilación hasta la primera instalación. Para ello,
    58       envuelve los comandos dentro de un comando <command>time</command> de
    59       esta forma: <userinput>time { ./configure ... &amp;&amp; make &amp;&amp;
    60       make install; }</userinput>.</para>
     56      <para>In order for the SBU values listed in the rest of the book
     57      to be of any use, measure the time it takes to build this package from
     58      the configuration, up to and including the first install. To achieve
     59      this easily, wrap the three commands in a <command>time</command>
     60      command like this: <userinput>time { ./configure ... &amp;&amp; make
     61      &amp;&amp; make install; }</userinput>.</para>
    6162    </note>
    6263
    63     <para>Prepara Binutils para su compilación:</para>
     64    <para>Now prepare Binutils for compilation:</para>
    6465
    6566<screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools --disable-nls</userinput></screen>
    6667
    6768    <variablelist>
    68       <title>Significado de las opciones de configure:</title>
     69      <title>The meaning of the configure options:</title>
    6970
    7071      <varlistentry>
    7172        <term><parameter>--prefix=/tools</parameter></term>
    7273        <listitem>
    73           <para>Esto le indica al guión configure que los programas de
    74           Binutils se instalarán en el directorio <filename
    75           class="directory">/tools</filename>.</para>
     74          <para>This tells the configure script to prepare to install the
     75          Binutils programs in the <filename class="directory">/tools</filename>
     76          directory.</para>
    7677        </listitem>
    7778      </varlistentry>
    … …  
    8081        <term><parameter>--disable-nls</parameter></term>
    8182        <listitem>
    82           <para>Esta opción desactiva la internacionalización, pues i18n no es
    83           necesario en las herramientas temporales.</para>
     83          <para>This disables internationalization as i18n is not needed for the
     84          temporary tools.</para>
    8485        </listitem>
    8586      </varlistentry>
    … …  
    8788    </variablelist>
    8889
    89     <para>Compila el paquete:</para>
     90    <para>Continue with compiling the package:</para>
    9091
    9192<screen><userinput>make</userinput></screen>
    9293
    93     <para>La compilación se ha completado. Normalmente deberíamos ejecutar
    94     ahora el banco de pruebas, pero en esta temprana fase el entorno de
    95     trabajo para los bancos de pruebas (Tcl, Expect y DejaGnu) todavía no
    96     está en su sitio. Los beneficios de ejecutar las pruebas ahora son mínimos,
    97     pues los programas de esta primera fase pronto serán sustituidos por los
    98     de la segunda.</para>
     94    <para>Compilation is now complete. Ordinarily we would now run the
     95    test suite, but at this early stage the test suite framework (Tcl,
     96    Expect, and DejaGNU) is not yet in place. The benefits of running the
     97    tests at this point are minimal since the programs from this
     98    first pass will soon be replaced by those from the second.</para>
    9999
    100     <para>Instala el paquete:</para>
     100    <para>Install the package:</para>
    101101
    102102<screen><userinput>make install</userinput></screen>
    103103
    104     <para>Prepara el enlazador para la posterior fase de
    105     <quote>ajuste</quote>:</para>
     104    <para>Next, prepare the linker for the <quote>Adjusting</quote> phase
     105    later on:</para>
    106106
    107107<screen><userinput>make -C ld clean
    … …  
    109109
    110110    <variablelist>
    111       <title>Significado de los parámetros de make:</title>
     111      <title>The meaning of the make parameters:</title>
    112112
    113113      <varlistentry>
    114114        <term><parameter>-C ld clean</parameter></term>
    115115        <listitem>
    116           <para>Esto le indica al programa make que elimine todos los ficheros
    117           compilados que haya en el subdirectorio
    118           <filename class="directory">ld</filename>.</para>
     116          <para>This tells the make program to remove all compiled
     117          files in the <filename class="directory">ld</filename>
     118          subdirectory.</para>
    119119        </listitem>
    120120      </varlistentry>
    … …  
    123123        <term><parameter>-C ld LIB_PATH=/tools/lib</parameter></term>
    124124        <listitem>
    125           <para>Esta opción vuelve a construir todo dentro del subdirectorio
    126           <filename class="directory">ld</filename>. Especificar la variable
    127           <envar>LIB_PATH</envar> del Makefile en la línea de comandos nos
    128           permite obviar su valor por defecto y apuntar a nuestro directorio
    129           de herramientas temporales. El valor de esta variable especifica
    130           la ruta de búsqueda de librerías por defecto del enlazador. Estos
    131           preparativos se utilizan más tarde en este capítulo.</para>
     125          <para>This option rebuilds everything in the <filename
     126          class="directory">ld</filename> subdirectory. Specifying the
     127          <envar>LIB_PATH</envar> Makefile variable on the command line
     128          allows us to override the default value and point it to the
     129          temporary tools location. The value of this variable specifies
     130          the linker's default library search path. This preparation is
     131          used later in the chapter.</para>
    132132        </listitem>
    133133      </varlistentry>
    … …  
    136136
    137137    <warning>
    138       <para><emphasis>No borres</emphasis> los directorios de fuentes y de
    139       construcción de Binutils. Los necesitarás un poco más adelante en este
    140       capítulo en el estado en que se encuentran ahora.</para>
     138      <para><emphasis>Do not</emphasis> remove the Binutils build and source
     139      directories yet. These will be needed again in their current state later
     140      in this chapter.</para>
    141141    </warning>
    142142
    … …  
    146146    <title/>
    147147
    148     <para>Los detalles sobre este paquete se encuentran en la
    149     <xref linkend="contents-binutils"/>.</para>
     148    <para>Details on this package are located in
     149    <xref linkend="contents-binutils" role="."/></para>
    150150
    151151  </sect2>

  • chapter05/binutils-pass2.xml

    r5aa74f2 r23102484  
    66]>
    77
    8 <sect1 id="ch-tools-binutils-pass2">
     8<sect1 id="ch-tools-binutils-pass2" role="wrap">
    99  <?dbhtml filename="binutils-pass2.html"?>
    1010
    11   <title>Binutils-&binutils-version; - Fase 2</title>
     11  <title>Binutils-&binutils-version; - Pass 2</title>
    1212
    1313  <indexterm zone="ch-tools-binutils-pass2">
    1414    <primary sortas="a-Binutils">Binutils</primary>
    15     <secondary>herramientas, fase 2</secondary>
     15    <secondary>tools, pass 2</secondary>
    1616  </indexterm>
    1717
    … …  
    4040
    4141  <sect2 role="installation">
    42     <title>Reinstalación de Binutils</title>
     42    <title>Re-installation of Binutils</title>
    4343
    44     <para>Vuelve a crear un directorio dedicado para la construcción:</para>
     44    <para>Create a separate build directory again:</para>
    4545
    4646<screen><userinput>mkdir -v ../binutils-build
    4747cd ../binutils-build</userinput></screen>
    4848
    49     <para>Prepara Binutils para su compilación:</para>
     49    <para>Prepare Binutils for compilation:</para>
    5050
    5151<screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
    … …  
    5353
    5454    <variablelist>
    55       <title>Significado de la nueva opción de configure:</title>
     55      <title>The meaning of the new configure options:</title>
    5656
    5757      <varlistentry>
    5858        <term><parameter>--with-lib-path=/tools/lib</parameter></term>
    5959        <listitem>
    60           <para>Esto le indica al guión configure que especifique la ruta
    61           de búsqueda de librerías por defecto durante la compilación de
    62           Binutils, resultando en que se le pase <filename
    63           class="directory">/tools/lib</filename> al enlazador. Esto evita
    64           que el enlazador busque en los directorios de librerías del
    65           anfitrión.</para>
     60          <para>This tells the configure script to specify the library
     61          search path during the compilation of Binutils, resulting in
     62          <filename class="directory">/tools/lib</filename> being passed
     63          to the linker. This prevents the linker from searching through
     64          library directories on the host.</para>
    6665        </listitem>
    6766      </varlistentry>
    … …  
    6968    </variablelist>
    7069
    71     <para>Compila el paquete:</para>
     70    <para>Compile the package:</para>
    7271
    7372<screen><userinput>make</userinput></screen>
    7473
    75     <para>La compilación está completa. Como se explicó antes, no recomendamos
    76     ejecutar los bancos de pruebas de las herramientas temporales en este
    77     capítulo. Si de todas formas deseas ejecutar el banco de pruebas de Binutils,
    78     hazlo con el siguiente comando:</para>
     74    <para>Compilation is now complete. As discussed earlier, running the
     75    test suite is not mandatory for the temporary tools here in this
     76    chapter. To run the Binutils test suite anyway, issue the following
     77    command:</para>
    7978
    8079<screen><userinput>make check</userinput></screen>
    8180
    82     <para>Instala el paquete:</para>
     81    <para>Install the package:</para>
    8382
    8483<screen><userinput>make install</userinput></screen>
    8584
    86     <para>Prepara el enlazador para la fase de <quote>Reajuste</quote> del
    87     próximo capítulo:</para>
     85    <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in
     86    the next chapter:</para>
    8887
    8988<screen><userinput>make -C ld clean
    … …  
    9190
    9291    <warning>
    93       <para><emphasis>No borres</emphasis> todavía los directorios de
    94       fuentes y de construcción de Binutils. Se necesitarán durante el
    95       siguiente capítulo en el estado en que se encuentran ahora.</para>
     92      <para><emphasis>Do not</emphasis> remove the Binutils source and build
     93      directories yet. These directories will be needed again in the next
     94      chapter in their current state.</para>
    9695    </warning>
    9796
    … …  
    101100    <title/>
    102101
    103     <para>Los detalles sobre este paquete se encuentran en la
    104     <xref linkend="contents-binutils"/>.</para>
     102    <para>Details on this package are located in
     103    <xref linkend="contents-binutils" role="."/></para>
    105104
    106105  </sect2>

  • chapter05/bison.xml

    r5aa74f2 r23102484  
    1313  <indexterm zone="ch-tools-bison">
    1414    <primary sortas="a-Bison">Bison</primary>
    15     <secondary>herramientas</secondary>
     15    <secondary>tools</secondary>
    1616  </indexterm>
    1717
    … …  
    4040
    4141  <sect2 role="installation">
    42     <title>Instalación de Bison</title>
     42    <title>Installation of Bison</title>
    4343
    44     <para>Prepara Bison para su compilación:</para>
     44    <para>Prepare Bison for compilation:</para>
    4545
    4646<screen><userinput>./configure --prefix=/tools</userinput></screen>
    4747
    48     <para>Compila el paquete:</para>
     48    <para>Compile the package:</para>
    4949
    5050<screen><userinput>make</userinput></screen>
    5151
    52     <para>Para comprobar los resultados, ejecuta:
     52    <para>To test the results, issue:
    5353    <userinput>make check</userinput>.</para>
    5454
    55     <para>Instala el paquete:</para>
     55    <para>Install the package:</para>
    5656
    5757<screen><userinput>make install</userinput></screen>
    … …  
    6262    <title/>
    6363
    64     <para>Los detalles sobre ste paquete se encuentran en la
    65     <xref linkend="contents-bison"/>.</para>
     64    <para>Details on this package are located in
     65    <xref linkend="contents-bison" role="."/></para>
    6666
    6767  </sect2>

  • chapter05/bzip2.xml

    r5aa74f2 r23102484  
    1313  <indexterm zone="ch-tools-bzip2">
    1414    <primary sortas="a-Bzip2">Bzip2</primary>
    15     <secondary>herramientas</secondary>
     15    <secondary>tools</secondary>
    1616  </indexterm>
    1717
    … …  
    4040
    4141  <sect2 role="installation">
    42     <title>Instalación de Bzip2</title>
     42    <title>Installation of Bzip2</title>
    4343
    44     <para>El paquete Bzip2 no tiene un guión <command>configure</command>.
    45     Compílalo y comprueba los resultados con:</para>
     44    <para>The Bzip2 package does not contain a <command>configure</command>
     45    script. Compile and test it with:</para>
    4646
    4747<screen><userinput>make</userinput></screen>
    4848
    49     <para>Instala el paquete:</para>
     49    <para>Install the package:</para>
    5050
    5151<screen><userinput>make PREFIX=/tools install</userinput></screen>
    … …  
    5656    <title/>
    5757
    58     <para>Los detalles sobre este paquete se encuentran en la
    59     <xref linkend="contents-bzip2"/>.</para>
     58    <para>Details on this package are located in
     59    <xref linkend="contents-bzip2" role="."/></para>
    6060
    6161  </sect2>

  • chapter05/coreutils.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-coreutils" role="wrap">
    7 <title>Coreutils-&coreutils-version;</title>
    8 <?dbhtml filename="coreutils.html"?>
     9  <?dbhtml filename="coreutils.html"?>
    910
    10 <indexterm zone="ch-tools-coreutils">
    11 <primary sortas="a-Coreutils">Coreutils</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Coreutils-&coreutils-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-coreutils">
     14    <primary sortas="a-Coreutils">Coreutils</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.9 SBU</seg><seg>53.3 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/coreutils.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Coreutils</title>
     29      <seglistitem>
     30        <seg>0.9 SBU</seg>
     31        <seg>53.3 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Coreutils for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/coreutils.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Coreutils</title>
     43
     44    <para>Prepare Coreutils for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>Compile the package:</para>
     48    <para>Compile the package:</para>
    3549
    3650<screen><userinput>make</userinput></screen>
    3751
    38 <para>To test the results, issue:
    39 <userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput>. The
    40 <parameter>RUN_EXPENSIVE_TESTS=yes</parameter> parameter tells the
    41 test suite to run several additional tests that are considered
    42 relatively expensive (in terms of CPU power and memory usage) on some
    43 platforms, but generally are not a problem on Linux.</para>
     52    <para>To test the results, issue:
     53    <userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput>. The
     54    <parameter>RUN_EXPENSIVE_TESTS=yes</parameter> parameter tells the
     55    test suite to run several additional tests that are considered
     56    relatively expensive (in terms of CPU power and memory usage) on some
     57    platforms, but generally are not a problem on Linux.</para>
    4458
    45 <para>Install the package:</para>
     59    <para>Install the package:</para>
    4660
    4761<screen><userinput>make install</userinput></screen>
    4862
    49 </sect2>
     63  </sect2>
    5064
    51 <sect2 role="content"><title/>
    52 <para>Details on this package are located in <xref
    53 linkend="contents-coreutils" role="."/></para>
    54 </sect2>
     65  <sect2 role="content">
     66    <title/>
     67
     68    <para>Details on this package are located in
     69    <xref linkend="contents-coreutils" role="."/></para>
     70
     71  </sect2>
    5572
    5673</sect1>
    57 

  • chapter05/dejagnu.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-dejagnu" role="wrap">
    7 <title>DejaGNU-&dejagnu-version;</title>
    8 <?dbhtml filename="dejagnu.html"?>
     9  <?dbhtml filename="dejagnu.html"?>
    910
    10 <indexterm zone="ch-tools-dejagnu"><primary sortas="a-DejaGNU">DejaGNU</primary></indexterm>
     11  <title>DejaGNU-&dejagnu-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The DejaGNU package contains a framework for testing other programs.</para>
     13  <indexterm zone="ch-tools-dejagnu">
     14    <primary sortas="a-DejaGNU">DejaGNU</primary>
     15  </indexterm>
    1416
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.1 SBU</seg><seg>6.1 MB</seg></seglistitem>
    19 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2019
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, Expect,
    24 GCC, Glibc, Grep, Make, Sed, and Tcl</seg></seglistitem>
    25 </segmentedlist>
    26 </sect2>
     20    <para>The DejaGNU package contains a framework for testing other
     21    programs.</para>
    2722
    28 <sect2 role="installation">
    29 <title>Installation of DejaGNU</title>
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
    3026
    31 <para>Prepare DejaGNU for compilation:</para>
     27      <seglistitem>
     28        <seg>0.1 SBU</seg>
     29        <seg>6.1 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
     32
     33    <segmentedlist>
     34      <segtitle>&dependencies;</segtitle>
     35
     36      <seglistitem>
     37        <seg>Bash, Binutils, Coreutils, Diffutils, Expect, GCC, Glibc, Grep,
     38        Make, Sed, and Tcl</seg>
     39      </seglistitem>
     40    </segmentedlist>
     41
     42  </sect2>
     43
     44  <sect2 role="installation">
     45    <title>Installation of DejaGNU</title>
     46
     47    <para>Prepare DejaGNU for compilation:</para>
    3248
    3349<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3450
    35 <para>Build and install the package:</para>
     51    <para>Build and install the package:</para>
    3652
    3753<screen><userinput>make install</userinput></screen>
    3854
    39 <para>To test the results, issue: <userinput>make check</userinput>.</para>
     55    <para>To test the results, issue:
     56    <userinput>make check</userinput>.</para>
    4057
    41 </sect2>
     58  </sect2>
    4259
    4360
    44 <sect2 id="contents-dejagnu" role="content"><title>Contents of DejaGNU</title>
     61  <sect2 id="contents-dejagnu" role="content">
     62    <title>Contents of DejaGNU</title>
    4563
    46 <segmentedlist>
    47 <segtitle>Installed program</segtitle>
    48 <seglistitem><seg>runtest</seg></seglistitem>
    49 </segmentedlist>
     64    <segmentedlist>
     65      <segtitle>Installed program</segtitle>
    5066
    51 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    52 <?dbfo list-presentation="list"?>
    53 <?dbhtml list-presentation="table"?>
     67      <seglistitem>
     68        <seg>runtest</seg>
     69      </seglistitem>
     70    </segmentedlist>
    5471
    55 <varlistentry id="runtest">
    56 <term><command>runtest</command></term>
    57 <listitem>
    58 <para>A wrapper script that locates the proper
    59 <command>expect</command> shell and then runs DejaGNU</para>
    60 <indexterm zone="ch-tools-dejagnu runtest"><primary sortas="b-runtest">runtest</primary></indexterm>
    61 </listitem>
    62 </varlistentry>
    63 </variablelist>
     72    <variablelist>
     73      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     74      <?dbfo list-presentation="list"?>
     75      <?dbhtml list-presentation="table"?>
    6476
    65 </sect2>
     77      <varlistentry id="runtest">
     78        <term><command>runtest</command></term>
     79        <listitem>
     80          <para>A wrapper script that locates the proper
     81          <command>expect</command> shell and then runs DejaGNU</para>
     82          <indexterm zone="ch-tools-dejagnu runtest">
     83            <primary sortas="b-runtest">runtest</primary>
     84          </indexterm>
     85        </listitem>
     86      </varlistentry>
     87
     88    </variablelist>
     89
     90  </sect2>
    6691
    6792</sect1>
    68 

  • chapter05/diffutils.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-diffutils" role="wrap">
    7 <title>Diffutils-&diffutils-version;</title>
    8 <?dbhtml filename="diffutils.html"?>
     9  <?dbhtml filename="diffutils.html"?>
    910
    10 <indexterm zone="ch-tools-diffutils">
    11 <primary sortas="a-Diffutils">Diffutils</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Diffutils-&diffutils-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-diffutils">
     14    <primary sortas="a-Diffutils">Diffutils</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.1 SBU</seg><seg>5.6 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/diffutils.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Diffutils</title>
     29      <seglistitem>
     30        <seg>0.1 SBU</seg>
     31        <seg>5.6 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Diffutils for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/diffutils.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Diffutils</title>
     43
     44    <para>Prepare Diffutils for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>Compile the package:</para>
     48    <para>Compile the package:</para>
    3549
    3650<screen><userinput>make</userinput></screen>
    3751
    38 <para>This package does not come with a test suite.</para>
     52    <para>This package does not come with a test suite.</para>
    3953
    40 <para>Install the package:</para>
     54    <para>Install the package:</para>
    4155
    4256<screen><userinput>make install</userinput></screen>
    4357
    44 </sect2>
     58  </sect2>
    4559
    46 <sect2 role="content"><title/>
    47 <para>Details on this package are located in <xref
    48 linkend="contents-diffutils" role="."/></para>
    49 </sect2>
     60  <sect2 role="content">
     61    <title/>
     62
     63    <para>Details on this package are located in
     64    <xref linkend="contents-diffutils" role="."/></para>
     65
     66  </sect2>
    5067
    5168</sect1>
    52 

  • chapter05/expect.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-expect" role="wrap">
    7 <title>Expect-&expect-version;</title>
    8 <?dbhtml filename="expect.html"?>
     9  <?dbhtml filename="expect.html"?>
    910
    10 <indexterm zone="ch-tools-expect"><primary sortas="a-Expect">Expect</primary></indexterm>
     11  <title>Expect-&expect-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Expect package contains a program for carrying out scripted dialogues
    14 with other interactive programs.</para>
     13  <indexterm zone="ch-tools-expect">
     14    <primary sortas="a-Expect">Expect</primary>
     15  </indexterm>
    1516
    16 <segmentedlist>
    17 <segtitle>&buildtime;</segtitle>
    18 <segtitle>&diskspace;</segtitle>
    19 <seglistitem><seg>0.1 SBU</seg><seg>4.0 MB</seg></seglistitem>
    20 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2119
    22 <segmentedlist>
    23 <segtitle>&dependencies;</segtitle>
    24 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    25 GCC, Glibc, Grep, Make, Patch, Sed, and Tcl</seg></seglistitem>
    26 </segmentedlist>
    27 </sect2>
     20    <para>The Expect package contains a program for carrying out scripted
     21    dialogues with other interactive programs.</para>
    2822
    29 <sect2 role="installation">
    30 <title>Installation of Expect</title>
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
    3126
    32 <para>First, fix a bug that can result in false failures during the GCC test
    33 suite run:</para>
     27      <seglistitem>
     28        <seg>0.1 SBU</seg>
     29        <seg>4.0 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
     32
     33    <segmentedlist>
     34      <segtitle>&dependencies;</segtitle>
     35
     36      <seglistitem>
     37        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
     38        Patch, Sed, and Tcl</seg>
     39      </seglistitem>
     40    </segmentedlist>
     41
     42  </sect2>
     43
     44  <sect2 role="installation">
     45    <title>Installation of Expect</title>
     46
     47    <para>First, fix a bug that can result in false failures during the GCC test
     48    suite run:</para>
    3449
    3550<screen><userinput>patch -Np1 -i ../&expect-spawn-patch;</userinput></screen>
    3651
    37 <para>Now prepare Expect for compilation:</para>
     52    <para>Now prepare Expect for compilation:</para>
    3853
    3954<screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib \
    40    --with-tclinclude=/tools/include --with-x=no</userinput></screen>
     55  --with-tclinclude=/tools/include --with-x=no</userinput></screen>
    4156
    42 <para>The meaning of the configure options:</para>
     57    <variablelist>
     58      <title>The meaning of the configure options:</title>
    4359
    44 <variablelist>
    45 <varlistentry>
    46 <term><parameter>--with-tcl=/tools/lib</parameter></term>
    47 <listitem><para>This ensures that the configure script finds the Tcl installation in
    48 the temporary tools location instead of possibly locating an existing
    49 one on the host system.</para></listitem>
    50 </varlistentry>
     60      <varlistentry>
     61        <term><parameter>--with-tcl=/tools/lib</parameter></term>
     62        <listitem>
     63          <para>This ensures that the configure script finds the Tcl
     64          installation in the temporary tools location instead of possibly
     65          locating an existing one on the host system.</para>
     66        </listitem>
     67      </varlistentry>
    5168
    52 <varlistentry>
    53 <term><parameter>--with-tclinclude=/tools/include</parameter></term>
    54 <listitem><para>This explicitly tells Expect where to find Tcl's internal headers.
    55 Using this option avoids conditions where <command>configure</command> fails because
    56 it cannot automatically discover the location of Tcl's headers.</para></listitem>
    57 </varlistentry>
     69      <varlistentry>
     70        <term><parameter>--with-tclinclude=/tools/include</parameter></term>
     71        <listitem>
     72          <para>This explicitly tells Expect where to find Tcl's internal
     73          headers. Using this option avoids conditions where
     74          <command>configure</command> fails because it cannot automatically
     75          discover the location of Tcl's headers.</para>
     76        </listitem>
     77      </varlistentry>
    5878
    59 <varlistentry>
    60 <term><parameter>--with-x=no</parameter></term>
    61 <listitem><para>This tells the configure script not to search for Tk
    62 (the Tcl GUI component) or the X Window System libraries, both of
    63 which may reside on the host system but will not exist in the temporary
    64 environment.</para></listitem>
    65 </varlistentry>
    66 </variablelist>
     79      <varlistentry>
     80        <term><parameter>--with-x=no</parameter></term>
     81        <listitem>
     82          <para>This tells the configure script not to search for Tk (the
     83          Tcl GUI component) or the X Window System libraries, both of which
     84          may reside on the host system but will not exist in the temporary
     85          environment.</para>
     86        </listitem>
     87      </varlistentry>
    6788
    68 <para>Build the package:</para>
     89    </variablelist>
     90
     91    <para>Build the package:</para>
    6992
    7093<screen><userinput>make</userinput></screen>
    7194
    72 <para>To test the results, issue: <userinput>make test</userinput>.
    73 Note that the Expect test suite is known to experience failures under
    74 certain host conditions that are not within our control. Therefore,
    75 test suite failures here are not surprising and are not considered
    76 critical.</para>
     95    <para>To test the results, issue: <userinput>make test</userinput>.
     96    Note that the Expect test suite is known to experience failures under
     97    certain host conditions that are not within our control. Therefore,
     98    test suite failures here are not surprising and are not considered
     99    critical.</para>
    77100
    78 <para>Install the package:</para>
     101    <para>Install the package:</para>
    79102
    80103<screen><userinput>make SCRIPTS="" install</userinput></screen>
    81104
    82 <para>The meaning of the make parameter:</para>
     105    <variablelist>
     106      <title>The meaning of the make parameter:</title>
    83107
    84 <variablelist>
    85 <varlistentry>
    86 <term><parameter>SCRIPTS=""</parameter></term>
    87 <listitem><para>This prevents installation of the supplementary expect
    88 scripts, which are not needed.</para></listitem>
    89 </varlistentry>
    90 </variablelist>
     108      <varlistentry>
     109        <term><parameter>SCRIPTS=""</parameter></term>
     110        <listitem>
     111          <para>This prevents installation of the supplementary Expect
     112          scripts, which are not needed.</para>
     113        </listitem>
     114      </varlistentry>
    91115
    92 </sect2>
     116    </variablelist>
    93117
    94 <sect2 id="contents-expect" role="content"><title>Contents of Expect</title>
     118  </sect2>
    95119
    96 <segmentedlist>
    97 <segtitle>Installed program</segtitle>
    98 <segtitle>Installed library</segtitle>
    99 <seglistitem><seg>expect</seg><seg>libexpect-&expect-lib-version;.a</seg></seglistitem>
    100 </segmentedlist>
     120  <sect2 id="contents-expect" role="content">
     121    <title>Contents of Expect</title>
    101122
    102 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    103 <?dbfo list-presentation="list"?>
    104 <?dbhtml list-presentation="table"?>
     123    <segmentedlist>
     124      <segtitle>Installed program</segtitle>
     125      <segtitle>Installed library</segtitle>
    105126
    106 <varlistentry id="expect">
    107 <term><command>expect</command></term>
    108 <listitem>
    109 <para>Communicates with other interactive
    110 programs according to a script</para>
    111 <indexterm zone="ch-tools-expect expect"><primary sortas="b-expect">expect</primary></indexterm>
    112 </listitem>
    113 </varlistentry>
     127      <seglistitem>
     128        <seg>expect</seg>
     129        <seg>libexpect-&expect-lib-version;.a</seg>
     130      </seglistitem>
     131    </segmentedlist>
    114132
    115 <varlistentry id="libexpect">
    116 <term><filename class="libraryfile">libexpect-&expect-lib-version;.a</filename></term>
    117 <listitem>
    118 <para>Contains functions that allow Expect to be used as a Tcl extension or to
    119 be used directly from C or C++ (without Tcl)</para>
    120 <indexterm zone="ch-tools-expect libexpect"><primary
    121 sortas="c-libexpect-&expect-lib-version;">libexpect-&expect-lib-version;</primary></indexterm>
    122 </listitem>
    123 </varlistentry>
    124 </variablelist>
     133    <variablelist>
     134      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     135      <?dbfo list-presentation="list"?>
     136      <?dbhtml list-presentation="table"?>
    125137
    126 </sect2>
     138      <varlistentry id="expect">
     139        <term><command>expect</command></term>
     140        <listitem>
     141          <para>Communicates with other interactive programs according
     142          to a script</para>
     143          <indexterm zone="ch-tools-expect expect">
     144            <primary sortas="b-expect">expect</primary>
     145          </indexterm>
     146        </listitem>
     147      </varlistentry>
     148
     149      <varlistentry id="libexpect">
     150        <term><filename class="libraryfile">libexpect-&expect-lib-version;.a</filename></term>
     151        <listitem>
     152          <para>Contains functions that allow Expect to be used as a Tcl
     153          extension or to be used directly from C or C++ (without Tcl)</para>
     154          <indexterm zone="ch-tools-expect libexpect">
     155            <primary sortas="c-libexpect-&expect-lib-version;">libexpect-&expect-lib-version;</primary>
     156          </indexterm>
     157        </listitem>
     158      </varlistentry>
     159
     160    </variablelist>
     161
     162  </sect2>
    127163
    128164</sect1>
    129 

  • chapter05/findutils.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-findutils" role="wrap">
    7 <title>Findutils-&findutils-version;</title>
    8 <?dbhtml filename="findutils.html"?>
     9  <?dbhtml filename="findutils.html"?>
    910
    10 <indexterm zone="ch-tools-findutils">
    11 <primary sortas="a-Findutils">Findutils</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Findutils-&findutils-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-findutils">
     14    <primary sortas="a-Findutils">Findutils</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.2 SBU</seg><seg>8.9 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/findutils.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Findutils</title>
     29      <seglistitem>
     30        <seg>0.2 SBU</seg>
     31        <seg>8.9 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Findutils for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/findutils.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Findutils</title>
     43
     44    <para>Prepare Findutils for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>Compile the package:</para>
     48    <para>Compile the package:</para>
    3549
    3650<screen><userinput>make</userinput></screen>
    3751
    38 <para>To test the results, issue: <userinput>make check</userinput>.</para>
     52    <para>To test the results, issue:
     53    <userinput>make check</userinput>.</para>
    3954
    40 <para>Install the package:</para>
     55    <para>Install the package:</para>
    4156
    4257<screen><userinput>make install</userinput></screen>
    4358
    44 </sect2>
     59  </sect2>
    4560
    46 <sect2 role="content"><title/>
    47 <para>Details on this package are located in <xref
    48 linkend="contents-findutils" role="."/></para>
    49 </sect2>
     61  <sect2 role="content">
     62    <title/>
     63
     64    <para>Details on this package are located in
     65    <xref linkend="contents-findutils" role="."/></para>
     66
     67  </sect2>
    5068
    5169</sect1>
    52 

  • chapter05/flex.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-flex" role="wrap">
    7 <title>Flex-&flex-version;</title>
    8 <?dbhtml filename="flex.html"?>
     9  <?dbhtml filename="flex.html"?>
    910
    10 <indexterm zone="ch-tools-flex">
    11 <primary sortas="a-Flex">Flex</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Flex-&flex-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-flex">
     14    <primary sortas="a-Flex">Flex</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.6 SBU</seg><seg>22.5 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/flex.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Flex</title>
     29      <seglistitem>
     30        <seg>0.6 SBU</seg>
     31        <seg>22.5 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Flex contains several known bugs. These can be fixed with the
    31 following patch:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/flex.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Flex</title>
     43
     44    <para>Flex contains several known bugs. These can be fixed with the
     45    following patch:</para>
    3246
    3347<screen><userinput>patch -Np1 -i ../&flex-fixes-patch;</userinput></screen>
    3448
    35 <para>The GNU autotools will detect that the Flex source code has been
    36 modified by the previous patch and tries to update the man page
    37 accordingly.  This does not work on many systems, and the default page is
    38 fine, so make sure it does not get regenerated:</para>
     49    <para>The GNU autotools will detect that the Flex source code has been
     50    modified by the previous patch and tries to update the man page
     51    accordingly.  This does not work on many systems, and the default page is
     52    fine, so make sure it does not get regenerated:</para>
    3953
    4054<screen><userinput>touch doc/flex.1</userinput></screen>
    4155
    42 <para>Now prepare Flex for compilation:</para>
     56    <para>Now prepare Flex for compilation:</para>
    4357
    4458<screen><userinput>./configure --prefix=/tools</userinput></screen>
    4559
    46 <para>Compile the package:</para>
     60    <para>Compile the package:</para>
    4761
    4862<screen><userinput>make</userinput></screen>
    4963
    50 <para>To test the results, issue:
    51 <userinput>make check</userinput>.</para>
     64    <para>To test the results, issue:
     65    <userinput>make check</userinput>.</para>
    5266
    53 <para>Install the package:</para>
     67    <para>Install the package:</para>
    5468
    5569<screen><userinput>make install</userinput></screen>
    5670
    57 </sect2>
     71  </sect2>
    5872
    59 <sect2 role="content"><title/>
    60 <para>Details on this package are located in <xref
    61 linkend="contents-flex" role="."/></para>
    62 </sect2>
     73  <sect2 role="content">
     74    <title/>
     75
     76    <para>Details on this package are located in
     77    <xref linkend="contents-flex" role="."/></para>
     78
     79  </sect2>
    6380
    6481</sect1>
    65 

  • chapter05/gawk.xml

    r5aa74f2 r23102484  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-gawk" role="wrap">
    7 <title>Gawk-&gawk-version;</title>
    8 <?dbhtml filename="gawk.html"?>
     9  <?dbhtml filename="gawk.html"?>
    910
    10 <indexterm zone="ch-tools-gawk">
    11 <primary sortas="a-Gawk">Gawk</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Gawk-&gawk-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-gawk">
     14    <primary sortas="a-Gawk">Gawk</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.2 SBU</seg><seg>16.4 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/gawk.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Gawk</title>
     29      <seglistitem>
     30        <seg>0.2 SBU</seg>
     31        <seg>16.4 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Gawk for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/gawk.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Gawk</title>
     43
     44    <para>Prepare Gawk for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>Due to a bug in the <command>configure</command> script, Gawk fails
    35 to detect certain aspects of locale support in Glibc. This
    36 bug leads to, e.g., Gettext testsuite failures. Work around this issue
    37 by appending the missing macro definitions to <filename>config.h</filename>:</para>
     48    <para>Due to a bug in the <command>configure</command> script, Gawk fails
     49    to detect certain aspects of locale support in Glibc. This bug leads to,
     50    e.g., Gettext testsuite failures. Work around this issue by appending the
     51    missing macro definitions to <filename>config.h</filename>:</para>
     52
    3853<screen><userinput>cat &gt;&gt;config.h &lt;&lt;"EOF"
    3954<literal>#define HAVE_LANGINFO_CODESET 1
    … …  
    4156EOF</userinput></screen>
    4257
    43 <para>Compile the package:</para>
     58    <para>Compile the package:</para>
    4459
    4560<screen><userinput>make</userinput></screen>
    4661
    47 <para>To test the results, issue: <userinput>make check</userinput>.</para>
     62    <para>To test the results, issue:
     63    <userinput>make check</userinput>.</para>
    4864
    49 <para>Install the package:</para>
     65    <para>Install the package:</para>
    5066
    5167<screen><userinput>make install</userinput></screen>
    5268
    53 </sect2>
     69  </sect2>
    5470
    55 <sect2 role="content"><title/>
    56 <para>Details on this package are located in <xref
    57 linkend="contents-gawk" role="."/></para>
    58 </sect2>
     71  <sect2 role="content">
     72    <title/>
     73
     74    <para>Details on this package are located in
     75    <xref linkend="contents-gawk" role="."/></para>
     76
     77  </sect2>
    5978
    6079</sect1>
    61 
Note: See TracChangeset for help on using the changeset viewer.