source: multimedia/libdriv/sdl.xml@ 9f12e36

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9f12e36 was 9f12e36, checked in by Randy McMurchy <randy@…>, 15 years ago

Removed 'keywordset' blocks and extra spaces from the XML files (note this was by accident as I meant to do just in the gnome directory but I was in the root of BOOK when I ran the script, but this was going to happen anyway so I don't think it is a big deal)

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

  • Property mode set to 100644
File size: 6.8 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 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
19 <!ENTITY sdl-download-http "http://www.libsdl.org/release/SDL-&sdl-version;.tar.gz">
20 <!ENTITY sdl-download-ftp " ">
21 <!ENTITY sdl-md5sum "80919ef556425ff82a8555ff40a579a0">
22 <!ENTITY sdl-size "2.6 MB">
23 <!ENTITY sdl-buildsize "36 MB">
24 <!ENTITY sdl-time "0.8 SBU">
25]>
26
27<sect1 id="sdl" xreflabel="SDL-&sdl-version;">
28 <?dbhtml filename="sdl.html"?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 </sect1info>
34
35 <title>SDL-&sdl-version;</title>
36
37 <indexterm zone="sdl">
38 <primary sortas="a-SDL">SDL</primary>
39 </indexterm>
40
41 <sect2 role="package">
42 <title>Introduction to SDL</title>
43
44 <para>The Simple DirectMedia Layer (<application>SDL</application>
45 for short) is a cross-platform library designed to make it easy to write
46 multimedia software, such as games and emulators.</para>
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
52 </listitem>
53 <listitem>
54 <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
55 </listitem>
56 <listitem>
57 <para>Download MD5 sum: &sdl-md5sum;</para>
58 </listitem>
59 <listitem>
60 <para>Download size: &sdl-size;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated disk space required: &sdl-buildsize;</para>
64 </listitem>
65 <listitem>
66 <para>Estimated build time: &sdl-time;</para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
71 <itemizedlist spacing="compact">
72 <listitem>
73 <para>Required patch: <ulink
74 url="&patch-root;/SDL-&sdl-version;-gcc4-1.patch"/></para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">SDL Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Optional</bridgehead>
81 <para role="optional"><xref linkend="alsa"/>,
82 <xref linkend="esound"/>,
83 <xref linkend="arts"/>,
84 <xref linkend="nas"/>,
85 <xref linkend="NASM"/>,
86 <xref linkend="x-window-system"/>,
87 <xref linkend="aalib"/>,
88 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
89 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
90 <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>, and
91 <!-- Dead link,
92 <ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink>
93 -->
94 <ulink url="http://picogui.org/">PicoGUI</ulink></para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/sdl"/></para>
98
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of SDL</title>
103
104 <para>Install <application>SDL</application> by running the
105 following commands:</para>
106
107<screen><userinput>patch -Np1 -i ../SDL-&sdl-version;-gcc4-1.patch &amp;&amp;
108./configure --prefix=/usr --disable-debug &amp;&amp;
109make</userinput></screen>
110
111 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
112
113<screen role="root"><userinput>make install &amp;&amp;
114install -v -m755 -d /usr/share/doc/SDL-&sdl-version;/html &amp;&amp;
115install -v -m644 docs/html/*.html /usr/share/doc/SDL-&sdl-version;/html</userinput></screen>
116
117 </sect2>
118
119 <sect2 role="commands">
120 <title>Command Explanations</title>
121
122 <para><parameter>--disable-debug</parameter>: This switch configures
123 <application>SDL</application> to build with aggressive
124 optimizations.</para>
125
126 <para><option>--enable-video-aalib</option>: This switch
127 is required to build <application>SDL</application>
128 with AAlib video support.</para>
129
130 </sect2>
131
132 <sect2 role="testing">
133 <title>Testing SDL</title>
134
135 <para>It is advisable to test the installation of
136 <application>SDL</application> using the included
137 test programs. It is not required to install any of the resulting binaries
138 to validate the installation. Issue the following commands to build the
139 test programs:</para>
140
141<screen><userinput>cd test &amp;&amp;
142./configure &amp;&amp;
143make</userinput></screen>
144
145 <para>You'll need to manually run all the test programs.</para>
146
147 </sect2>
148
149 <sect2 role="configuration">
150 <title>Configuring SDL</title>
151
152 <sect3>
153 <title>Configuration Information</title>
154
155 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
156
157 </sect3>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Program</segtitle>
166 <segtitle>Installed Libraries</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <seg>sdl-config</seg>
171 <seg>libSDL*.{so,a}</seg>
172 <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="sdl-config">
182 <term><command>sdl-config</command></term>
183 <listitem>
184 <para>determines the compile and linker flags that should be used to
185 compile and link programs that use
186 <filename class='libraryfile'>libSDL</filename>.</para>
187 <indexterm zone="sdl sdl-config">
188 <primary sortas="b-sdl-config">sdl-config</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="libsdl">
194 <term><filename class='libraryfile'>libSDL*.{so,a}</filename></term>
195 <listitem>
196 <para> libraries provide low level access to audio, keyboard, mouse,
197 joystick, 3D hardware via OpenGL, and
198 2D frame buffer across multiple platforms.</para>
199 <indexterm zone="sdl libsdl">
200 <primary sortas="c-libsdl">libSDL*.{so,a}</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 </variablelist>
206
207 </sect2>
208
209</sect1>
Note: See TracBrowser for help on using the repository browser.