Changeset fcc02767 for chapter06/flex.xml
- Timestamp:
- 06/07/2020 08:16:00 PM (4 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 595ff03
- Parents:
- d53fefa
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/flex.xml
rd53fefa rfcc02767 6 6 ]> 7 7 8 <sect1 id="ch- system-flex" role="wrap">8 <sect1 id="ch-tools-flex" role="wrap"> 9 9 <?dbhtml filename="flex.html"?> 10 10 … … 17 17 <title>Flex-&flex-version;</title> 18 18 19 <indexterm zone="ch- system-flex">19 <indexterm zone="ch-tools-flex"> 20 20 <primary sortas="a-Flex">Flex</primary> 21 <secondary>tools</secondary> 21 22 </indexterm> 22 23 … … 24 25 <title/> 25 26 26 <para>The Flex package contains a utility for generating programs that 27 recognize patterns in text.</para> 27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 28 href="../chapter06/flex.xml" 29 xpointer="xpointer(/sect1/sect2[1]/para[1])"/> 28 30 29 31 <segmentedlist> … … 32 34 33 35 <seglistitem> 34 <seg>&flex-ch 6-sbu;</seg>35 <seg>&flex-ch 6-du;</seg>36 <seg>&flex-ch5-sbu;</seg> 37 <seg>&flex-ch5-du;</seg> 36 38 </seglistitem> 37 39 </segmentedlist> … … 42 44 <title>Installation of Flex</title> 43 45 44 <!--45 <para>First, fix a problem introduced with glibc-2.26:</para>46 47 <screen><userinput remap="pre">sed -i "/math.h/a #include <malloc.h>" src/flexdef.h</userinput></screen>48 49 <para>The build procedure assumes the <application>help2man</application>50 program is available to create a man page from the executable - -help option.51 This is not present, so we use an environment variable to skip this process.52 Now, prepare Flex for compilation:</para> -->53 54 46 <para>Prepare Flex for compilation:</para> 55 47 56 < !-- <screen><userinput remap="configure">HELP2MAN=/tools/bin/true \ -->57 <screen><userinput remap="configure">./configure --prefix=/usr--docdir=/usr/share/doc/flex-&flex-version;</userinput></screen>48 <screen><userinput remap="configure">./configure --prefix=/usr \ 49 --docdir=/usr/share/doc/flex-&flex-version;</userinput></screen> 58 50 51 <!-- 52 <variablelist> 53 <title>The meaning of the new configure option:</title> 54 55 <varlistentry> 56 <term><parameter>- -disable-bootstrap</parameter></term> 57 <listitem> 58 <para>Normally, building flex is done in two stages. A first 59 programs, which is used to generate the source of a second one, 60 which is then compiled. When using cross-compilation, the first 61 program is generated on the build system. However, due to a bug 62 in configure, the presence of some function is tested only on the 63 host system. If this function is not found on the build system, the 64 build fails. This can be prevented by disabling the two stage 65 build.</para> 66 </listitem> 67 </varlistentry> 68 </variablelist> 69 --> 59 70 <para>Compile the package:</para> 60 71 61 72 <screen><userinput remap="make">make</userinput></screen> 62 63 <para>To test the results (about 0.5 SBU), issue:</para>64 65 <screen><userinput remap="test">make check</userinput></screen>66 73 67 74 <para>Install the package:</para> … … 69 76 <screen><userinput remap="install">make install</userinput></screen> 70 77 71 <para>A few programs do not know about <command>flex</command> yet and72 try to run its predecessor, <command>lex</command>. To support those73 programs, create a symbolic link named <filename>lex</filename> that74 runs <filename>flex</filename> in <command>lex</command> emulation75 mode:</para>76 77 <screen><userinput remap="install">ln -sv flex /usr/bin/lex</userinput></screen>78 79 78 </sect2> 80 79 81 <sect2 id="contents-flex"role="content">82 <title >Contents of Flex</title>80 <sect2 role="content"> 81 <title/> 83 82 84 <segmentedlist> 85 <segtitle>Installed programs</segtitle> 86 <segtitle>Installed libraries</segtitle> 87 <segtitle>Installed directory</segtitle> 88 89 <seglistitem> 90 <seg>flex, flex++ (link to flex), and lex (link to flex)</seg> 91 <seg>libfl.so</seg> 92 <seg>/usr/share/doc/flex-&flex-version;</seg> 93 </seglistitem> 94 </segmentedlist> 95 96 <variablelist> 97 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 98 <?dbfo list-presentation="list"?> 99 <?dbhtml list-presentation="table"?> 100 101 <varlistentry id="flex"> 102 <term><command>flex</command></term> 103 <listitem> 104 <para>A tool for generating programs that recognize patterns in text; 105 it allows for the versatility to specify the rules for pattern-finding, 106 eradicating the need to develop a specialized program</para> 107 <indexterm zone="ch-system-flex flex"> 108 <primary sortas="b-flex">flex</primary> 109 </indexterm> 110 </listitem> 111 </varlistentry> 112 113 <varlistentry id="flexpp"> 114 <term><command>flex++</command></term> 115 <listitem> 116 <para>An extension of flex, is used for generating C++ code 117 and classes. It is a symbolic link to <command>flex</command></para> 118 <indexterm zone="ch-system-flex flexpp"> 119 <primary sortas="b-flex++">flex++</primary> 120 </indexterm> 121 </listitem> 122 </varlistentry> 123 124 <varlistentry id="lex"> 125 <term><command>lex</command></term> 126 <listitem> 127 <para>A symbolic link that runs <command>flex</command> in 128 <command>lex</command> emulation mode</para> 129 <indexterm zone="ch-system-flex lex"> 130 <primary sortas="b-lex">lex</primary> 131 </indexterm> 132 </listitem> 133 </varlistentry> 134 135 <varlistentry id="libfl"> 136 <term><filename class="libraryfile">libfl</filename></term> 137 <listitem> 138 <para>The <filename class="libraryfile">flex</filename> library</para> 139 <indexterm zone="ch-system-flex libfl"> 140 <primary sortas="c-libfl">libfl</primary> 141 </indexterm> 142 </listitem> 143 </varlistentry> 144 145 </variablelist> 83 <para>Details on this package are located in 84 <xref linkend="contents-flex" role="."/></para> 146 85 147 86 </sect2>
Note:
See TracChangeset
for help on using the changeset viewer.