chapter05/flex.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-flex" role="wrap">
   9   <?dbhtml filename="flex.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>flex</productname>
  13     <productnumber>&flex-version;</productnumber>
  14     <address>&flex-url;</address>
  15   </sect1info>
  16
  17   <title>Flex-&flex-version;</title>
  18
  19   <indexterm zone="ch-tools-flex">
  20     <primary sortas="a-Flex">Flex</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/flex.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>&flex-ch5-sbu;</seg>
  37         <seg>&flex-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Flex</title>
  45
  46     <para>Flex contains several known bugs. These can be fixed with the
  47     following patch:</para>
  48
  49 <screen><userinput remap="pre">patch -Np1 -i ../&flex-fixes-patch;</userinput></screen>
  50
  51     <para>The GNU autotools will detect that the Flex source code has been
  52     modified by the previous patch and tries to update the man page
  53     accordingly.  This does not work on many systems, and the default page is
  54     fine, so make sure it does not get regenerated:</para>
  55
  56 <screen><userinput remap="pre">touch doc/flex.1</userinput></screen>
  57
  58     <para>Now prepare Flex for compilation:</para>
  59
  60 <screen><userinput remap="configure">./configure --prefix=/tools</userinput></screen>
  61
  62     <para>Compile the package:</para>
  63
  64 <screen><userinput remap="make">make</userinput></screen>
  65
  66     <para>To test the results, issue:</para>
  67
  68 <screen><userinput remap="test">make check</userinput></screen>
  69
  70     <para>Install the package:</para>
  71
  72 <screen><userinput remap="install">make install</userinput></screen>
  73
  74   </sect2>
  75
  76   <sect2 role="content">
  77     <title/>
  78
  79     <para>Details on this package are located in
  80     <xref linkend="contents-flex" role="."/></para>
  81
  82   </sect2>
  83
  84 </sect1>