source: x/lib/fltk.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.9 KB
Line 
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 <!-- Watch directory when updating -->
8 <!ENTITY fltk-download-http "https://fltk.org/pub/fltk/1.3.5/fltk-&fltk-version;-source.tar.gz">
9 <!ENTITY fltk-download-ftp " ">
10 <!ENTITY fltk-md5sum "e85017defd5a03ae82e634311db87bbf">
11 <!ENTITY fltk-size "5.1 MB">
12 <!ENTITY fltk-buildsize "117 MB (with documentation)">
13 <!ENTITY fltk-time "0.2 SBU (Using parallelism=4)">
14]>
15
16<sect1 id="fltk" xreflabel="FLTK-&fltk-version;">
17 <?dbhtml filename="fltk.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>FLTK-&fltk-version;</title>
24
25 <indexterm zone="fltk">
26 <primary sortas="a-FLTK">FLTK</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to FLTK</title>
31
32 <para>
33 FLTK (pronounced "fulltick") is a cross-platform C++ GUI toolkit.
34 FLTK provides modern GUI functionality and supports 3D graphics via
35 OpenGL and its built-in GLUT emulation libraries used for creating
36 graphical user interfaces for applications.
37 </para>
38
39 &lfs101_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&fltk-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&fltk-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &fltk-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &fltk-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &fltk-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &fltk-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">FLTK Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="xorg7-lib"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="hicolor-icon-theme"/>,
85 <xref linkend="libjpeg"/>, and
86 <xref linkend="libpng"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="alsa-lib"/>,
92 <xref linkend="desktop-file-utils"/>,
93 <xref linkend="doxygen"/>,
94 <xref linkend="glu"/>,
95 <xref linkend="mesa"/>, and
96 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
97 </para>
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/fltk"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of FLTK</title>
106
107 <note>
108 <para>
109 The tar extraction directory is fltk-&fltk-version; and not
110 fltk-&fltk-version;-source as indicated by the tarball name.
111 </para>
112 </note>
113
114 <para>
115 Install <application>FLTK</application> by running the following
116 commands:
117 </para>
118
119<screen><userinput>sed -i -e '/cat./d' documentation/Makefile &amp;&amp;
120
121./configure --prefix=/usr \
122 --enable-shared &amp;&amp;
123make</userinput></screen>
124
125 <para>
126 If you wish to create the API documentation, issue:
127 </para>
128
129<screen remap="doc"><userinput>make -C documentation html</userinput></screen>
130
131 <para>
132 The tests for the package are interactive. To execute the tests, run
133 <command>test/unittests</command>. In addition, there are 70 other
134 executable test programs in the <filename
135 class='directory'>test</filename> directory that can be run individually.
136 </para>
137
138 <para>
139 Now, as the <systemitem class="username">root</systemitem> user:
140 </para>
141
142<screen role="root"><userinput>make docdir=/usr/share/doc/fltk-&fltk-version; install</userinput></screen>
143
144 <para>
145 If desired, install some example games built as a part of the tests,
146 extra documentation and example programs. As the <systemitem
147 class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"
151 remap="doc"><userinput>make -C test docdir=/usr/share/doc/fltk-&fltk-version; install-linux &amp;&amp;
152make -C documentation docdir=/usr/share/doc/fltk-&fltk-version; install-linux</userinput></screen>
153
154 </sect2>
155
156 <sect2 role="commands">
157 <title>Command Explanations</title>
158
159 <para>
160 <command>sed ... documentation/Makefile</command>: Avoid installing
161 pages in <filename class='directory'>/usr/share/man/cat*</filename>.
162 </para>
163
164 </sect2>
165
166 <sect2 role="content">
167 <title>Contents</title>
168
169 <segmentedlist>
170 <segtitle>Installed Programs</segtitle>
171 <segtitle>Installed Libraries</segtitle>
172 <segtitle>Installed Directories</segtitle>
173
174 <seglistitem>
175 <seg>
176 blocks,
177 checkers,
178 fltk-config,
179 fluid, and
180 sudoku
181 </seg>
182 <seg>
183 libfltk.{a,so},
184 libfltk_forms.{a,so},
185 libfltk_gl.{a,so}, and
186 libfltk_images.{a,so}
187 </seg>
188 <seg>
189 /usr/include/FL and
190 /usr/share/doc/fltk-&fltk-version;
191 </seg>
192 </seglistitem>
193 </segmentedlist>
194
195 <variablelist>
196 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
197 <?dbfo list-presentation="list"?>
198 <?dbhtml list-presentation="table"?>
199
200 <varlistentry id="blocks">
201 <term><command>blocks</command></term>
202 <listitem>
203 <para>
204 is a FLTK-based block elimination game
205 </para>
206 <indexterm zone="fltk blocks">
207 <primary sortas="b-blocks">blocks</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="checkers">
213 <term><command>checkers</command></term>
214 <listitem>
215 <para>
216 is a FLTK-based version of the game of checkers
217 </para>
218 <indexterm zone="fltk checkers">
219 <primary sortas="b-checkers">checkers</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="fltk-config">
225 <term><command>fltk-config</command></term>
226 <listitem>
227 <para>
228 is a utility script that can be used to get information about the
229 current version of FLTK that is installed on the system
230 </para>
231 <indexterm zone="fltk fltk-config">
232 <primary sortas="b-fltk-config">fltk-config</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="fluid">
238 <term><command>fluid</command></term>
239 <listitem>
240 <para>
241 is an interactive GUI designer for FLTK
242 </para>
243 <indexterm zone="fltk fluid">
244 <primary sortas="b-fluid">fluid</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="sudoku">
250 <term><command>sudoku</command></term>
251 <listitem>
252 <para>
253 is an implementation of the popular Sudoku game
254 </para>
255 <indexterm zone="fltk sudoku">
256 <primary sortas="b-sudoku">sudoku</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="libfltk">
262 <term><filename class="libraryfile">libfltk.so</filename></term>
263 <listitem>
264 <para>
265 contains functions that provide an API to implement graphical user
266 interfaces
267 </para>
268 <indexterm zone="fltk libfltk">
269 <primary sortas="c-libfltk">libfltk.so</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 </variablelist>
275
276 </sect2>
277
278</sect1>
Note: See TracBrowser for help on using the repository browser.