aboutsummaryrefslogtreecommitdiffstats
path: root/chapter05/flex.xml
blob: 730fd735cad995335b78df2b31e75808c4ea58d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<?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-tools-flex" role="wrap">
  <?dbhtml filename="flex.html"?>

  <sect1info condition="script">
    <productname>flex</productname>
    <productnumber>&flex-version;</productnumber>
    <address>&flex-url;</address>
  </sect1info>

  <title>Flex-&flex-version;</title>

  <indexterm zone="ch-tools-flex">
    <primary sortas="a-Flex">Flex</primary>
    <secondary>tools</secondary>
  </indexterm>

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

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../chapter06/flex.xml"
    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&flex-ch5-sbu;</seg>
        <seg>&flex-ch5-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

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

    <para>Flex contains several known bugs. These can be fixed with the
    following patch:</para>

<screen><userinput remap="pre">patch -Np1 -i ../&flex-fixes-patch;</userinput></screen>

    <para>The GNU autotools will detect that the Flex source code has been
    modified by the previous patch and tries to update the man page
    accordingly.  This does not work on many systems, and the default page is
    fine, so make sure it does not get regenerated:</para>

<screen><userinput remap="pre">touch doc/flex.1</userinput></screen>

    <para>Now prepare Flex for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/tools</userinput></screen>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>To test the results, issue:</para>

<screen><userinput remap="test">make check</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

  </sect2>

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

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

  </sect2>

</sect1>