Changeset 576a230


Ignore:
Timestamp:
05/11/2005 07:42:41 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
fee89d1
Parents:
62d4da77
Message:

Tagged sdl.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • multimedia/libdriv/sdl.xml

    r62d4da77 r576a230  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     
    1314
    1415<sect1 id="sdl" xreflabel="SDL-&sdl-version;">
    15 <sect1info>
    16 <othername>$LastChangedBy$</othername>
    17 <date>$Date$</date>
    18 </sect1info>
    19 <?dbhtml filename="sdl.html"?>
    20 <title>SDL-&sdl-version;</title>
    21 <indexterm zone="sdl">
    22 <primary sortas="a-SDL">SDL</primary>
    23 </indexterm>
     16  <?dbhtml filename="sdl.html"?>
    2417
    25 <sect2>
    26 <title>Introduction to <application><acronym>SDL</acronym></application></title>
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
    2722
    28 <para>The Simple DirectMedia Layer
    29 (<application><acronym>SDL</acronym></application> for short) is a
    30 cross-platform library designed to make it easy to write multimedia software,
    31 such as games and emulators.</para>
     23  <title>SDL-&sdl-version;</title>
    3224
    33 <sect3><title>Package information</title>
    34 <itemizedlist spacing='compact'>
    35 <listitem><para>Download (HTTP):
    36 <ulink url="&sdl-download-http;"/></para></listitem>
    37 <listitem><para>Download (FTP):
    38 <ulink url="&sdl-download-ftp;"/></para></listitem>
    39 <listitem><para>Download MD5 sum: &sdl-md5sum;</para></listitem>
    40 <listitem><para>Download size: &sdl-size;</para></listitem>
    41 <listitem><para>Estimated disk space required:
    42 &sdl-buildsize;</para></listitem>
    43 <listitem><para>Estimated build time:
    44 &sdl-time;</para></listitem></itemizedlist>
    45 </sect3>
     25  <indexterm zone="sdl">
     26    <primary sortas="a-SDL">SDL</primary>
     27  </indexterm>
    4628
    47 <sect3><title><application><acronym>SDL</acronym></application>
    48 dependencies</title>
    49 <sect4><title>Optional</title>
    50 <para><xref linkend="alsa"/>,
    51 <xref linkend="esound"/>,
    52 <xref linkend="arts"/>,
    53 <xref linkend="nas"/>,
    54 <xref linkend="NASM"/>,
    55 X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
    56 <xref linkend="aalib"/>,
    57 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
    58 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
    59 <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>,
    60 <ulink url="http://www.trolltech.com/download/qtopia/">Qtopia</ulink> and
    61 <ulink url="http://picogui.org/">PicoGUI</ulink></para>
    62 </sect4>
    63 </sect3>
     29  <sect2 role="package">
     30    <title>Introduction to SDL</title>
    6431
    65 </sect2>
     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>
    6635
    67 <sect2>
    68 <title>Installation of <application><acronym>SDL</acronym></application></title>
     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>
    6957
    70 <para>Install <application><acronym>SDL</acronym></application> by running the
    71 following commands:</para>
     58    <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead>
    7259
    73 <screen><userinput><command>./configure --prefix=/usr --disable-debug &amp;&amp;
    74 make</command></userinput></screen>
     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>
    7573
    76 <para>Now, as the root user:</para>
     74  </sect2>
    7775
    78 <screen><userinput role='root'><command>make install &amp;&amp;
     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;
    7988install -v -m755 -d /usr/share/doc/SDL-1.2.8/html &amp;&amp;
    80 install -v -m644 docs/html/*.html /usr/share/doc/SDL-1.2.8/html</command></userinput></screen>
     89install -v -m644 docs/html/*.html /usr/share/doc/SDL-1.2.8/html</userinput></screen>
    8190
    82 </sect2>
     91  </sect2>
    8392
    84 <sect2>
    85 <title>Command explanations</title>
     93  <sect2 role="commands">
     94    <title>Command Explanations</title>
    8695
    87 <para><parameter>--disable-debug</parameter>: This switch configures
    88 <application><acronym>SDL</acronym></application> to build with aggressive
    89 optimizations.</para>
     96    <para><parameter>--disable-debug</parameter>: This switch configures
     97    <application>SDL</application> to build with aggressive
     98    optimizations.</para>
    9099
    91 <para><option>--enable-video-aalib</option>: This switch
    92 is required to build <application><acronym>SDL</acronym></application>
    93 with <acronym>AA</acronym>lib video support.</para>
     100    <para><option>--enable-video-aalib</option>: This switch
     101    is required to build <application>SDL</application>
     102    with AAlib video support.</para>
    94103
    95 </sect2>
     104    <sect3>
     105      <title>Testing SDL</title>
    96106
    97 <sect2>
    98 <title>Testing <application><acronym>SDL</acronym></application></title>
     107      <para>It is advisable to test the installation of
     108      <application>SDL</application> using the included
     109      test programs. It is not required to install any of the resulting binaries
     110      to validate the installation. Issue the following commands to build the
     111      test programs:</para>
    99112
    100 <para>It is advisable to test the installation of
    101 <application><acronym>SDL</acronym></application> using the included
    102 test programs. It is not required to install any of the resulting binaries
    103 to validate the installation. Issue the following commands to build the
    104 test programs:</para>
     113<screen><userinput>cd test &amp;&amp;
     114./configure &amp;&amp;
     115make</userinput></screen>
    105116
    106 <screen><userinput><command>cd test &amp;&amp;
    107 ./configure &amp;&amp;
    108 make</command></userinput></screen>
     117      <para>You'll need to manually run all the test programs.</para>
    109118
    110 <para>You'll need to manually run all the test programs.</para>
     119    </sect3>
     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>
    111149   
    112 </sect2>
     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>
    113166
    114 <sect2>
    115 <title>Configuring <application><acronym>SDL</acronym></application></title>
     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>
    116180
    117 <sect3><title>Configuration Information</title>
    118 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
    119 </sect3>
    120 
    121 </sect2>
    122 
    123 <sect2>
    124 <title>Contents</title>
    125 
    126 <segmentedlist>
    127 <segtitle>Installed Program</segtitle>
    128 <segtitle>Installed Libraries</segtitle>
    129 <segtitle>Installed Directories</segtitle>
    130    
    131 <seglistitem>
    132 <seg>sdl-config</seg>
    133 <seg>libSDL*.[so,a]</seg>
    134 <seg>/usr/include/SDL and /usr/share/doc/SDL-&sdl-version;</seg>
    135 </seglistitem>
    136 </segmentedlist>
    137    
    138 <variablelist>
    139 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    140 <?dbfo list-presentation="list"?>
    141 <?dbhtml list-presentation="table"?>
    142      
    143 <varlistentry id="sdl-config">
    144 <term><command>sdl-config</command></term>
    145 <listitem>
    146 <para>determines the compile and linker flags that should be used to
    147 compile and link programs that use
    148 <filename class='libraryfile'>libSDL</filename>.</para>
    149 <indexterm zone="sdl sdl-config">
    150 <primary sortas="b-sdl-config">sdl-config</primary>
    151 </indexterm>
    152 </listitem>
    153 </varlistentry>
    154 
    155 <varlistentry id="libsdl">
    156 <term><filename class='libraryfile'>libSDL*.[so,a]</filename></term>
    157 <listitem>
    158 <para> libraries provide low level access to audio, keyboard, mouse,
    159 joystick, <acronym>3D</acronym> hardware via OpenGL, and
    160 <acronym>2D</acronym> frame buffer across multiple platforms.</para>
    161 <indexterm zone="sdl libsdl">
    162 <primary sortas="c-libsdl">libSDL*.[so,a]</primary>
    163 </indexterm>
    164 </listitem>
    165 </varlistentry>
    166  
    167 </variablelist>
    168 
    169 </sect2>
     181  </sect2>
    170182
    171183</sect1>
Note: See TracChangeset for help on using the changeset viewer.