source: multimedia/libdriv/sdl.xml@ d7ecaa6

10.0 10.1 11.0 11.1 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since d7ecaa6 was d7ecaa6, checked in by Randy McMurchy <randy@…>, 17 years ago

Removed spaces from blank lines and excess spaces from the end of XML data

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4472 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 5.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY sdl-download-http "http://www.libsdl.org/release/SDL-&sdl-version;.tar.gz">
8 <!ENTITY sdl-download-ftp " ">
9 <!ENTITY sdl-md5sum "37aaf9f069f9c2c18856022f35de9f8c">
10 <!ENTITY sdl-size "2.6 MB">
11 <!ENTITY sdl-buildsize "36 MB">
12 <!ENTITY sdl-time "0.8 SBU">
13]>
14
15<sect1 id="sdl" xreflabel="SDL-&sdl-version;">
16 <?dbhtml filename="sdl.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>SDL-&sdl-version;</title>
24
25 <indexterm zone="sdl">
26 <primary sortas="a-SDL">SDL</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to SDL</title>
31
32 <para>The Simple DirectMedia Layer (<application>SDL</application>
33 for short) is a cross-platform library designed to make it easy to write
34 multimedia software, such as games and emulators.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &sdl-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &sdl-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &sdl-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &sdl-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">SDL Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Optional</bridgehead>
61 <para><xref linkend="alsa"/>,
62 <xref linkend="esound"/>,
63 <xref linkend="arts"/>,
64 <xref linkend="nas"/>,
65 <xref linkend="NASM"/>,
66 X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
67 <xref linkend="aalib"/>,
68 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
69 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
70 <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>,
71 <ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink> and
72 <ulink url="http://picogui.org/">PicoGUI</ulink></para>
73
74 </sect2>
75
76 <sect2 role="installation">
77 <title>Installation of SDL</title>
78
79 <para>Install <application>SDL</application> by running the
80 following commands:</para>
81
82<screen><userinput>./configure --prefix=/usr --disable-debug &amp;&amp;
83make</userinput></screen>
84
85 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
86
87<screen role="root"><userinput>make install &amp;&amp;
88install -v -m755 -d /usr/share/doc/SDL-1.2.8/html &amp;&amp;
89install -v -m644 docs/html/*.html /usr/share/doc/SDL-1.2.8/html</userinput></screen>
90
91 </sect2>
92
93 <sect2 role="commands">
94 <title>Command Explanations</title>
95
96 <para><parameter>--disable-debug</parameter>: This switch configures
97 <application>SDL</application> to build with aggressive
98 optimizations.</para>
99
100 <para><option>--enable-video-aalib</option>: This switch
101 is required to build <application>SDL</application>
102 with AAlib video support.</para>
103
104 </sect2>
105
106 <sect2 role="testing">
107 <title>Testing SDL</title>
108
109 <para>It is advisable to test the installation of
110 <application>SDL</application> using the included
111 test programs. It is not required to install any of the resulting binaries
112 to validate the installation. Issue the following commands to build the
113 test programs:</para>
114
115<screen><userinput>cd test &amp;&amp;
116./configure &amp;&amp;
117make</userinput></screen>
118
119 <para>You'll need to manually run all the test programs.</para>
120
121 </sect2>
122
123 <sect2 role="configuration">
124 <title>Configuring SDL</title>
125
126 <sect3>
127 <title>Configuration Information</title>
128
129 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
130
131 </sect3>
132
133 </sect2>
134
135 <sect2 role="content">
136 <title>Contents</title>
137
138 <segmentedlist>
139 <segtitle>Installed Program</segtitle>
140 <segtitle>Installed Libraries</segtitle>
141 <segtitle>Installed Directories</segtitle>
142
143 <seglistitem>
144 <seg>sdl-config</seg>
145 <seg>libSDL*.[so,a]</seg>
146 <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
147 </seglistitem>
148 </segmentedlist>
149
150 <variablelist>
151 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
152 <?dbfo list-presentation="list"?>
153 <?dbhtml list-presentation="table"?>
154
155 <varlistentry id="sdl-config">
156 <term><command>sdl-config</command></term>
157 <listitem>
158 <para>determines the compile and linker flags that should be used to
159 compile and link programs that use
160 <filename class='libraryfile'>libSDL</filename>.</para>
161 <indexterm zone="sdl sdl-config">
162 <primary sortas="b-sdl-config">sdl-config</primary>
163 </indexterm>
164 </listitem>
165 </varlistentry>
166
167 <varlistentry id="libsdl">
168 <term><filename class='libraryfile'>libSDL*.[so,a]</filename></term>
169 <listitem>
170 <para> libraries provide low level access to audio, keyboard, mouse,
171 joystick, 3D hardware via OpenGL, and
172 2D frame buffer across multiple platforms.</para>
173 <indexterm zone="sdl libsdl">
174 <primary sortas="c-libsdl">libSDL*.[so,a]</primary>
175 </indexterm>
176 </listitem>
177 </varlistentry>
178
179 </variablelist>
180
181 </sect2>
182
183</sect1>
Note: See TracBrowser for help on using the repository browser.