Ignore:
Timestamp:
03/09/2020 03:02:12 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
2aff70f
Parents:
22618785
Message:

Format multimedia chapter

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • multimedia/libdriv/sdl.xml

    r22618785 r2eeb8695  
    3030    <title>Introduction to SDL</title>
    3131
    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>
     32    <para>
     33      The Simple DirectMedia Layer (<application>SDL</application>
     34      for short) is a cross-platform library designed to make it easy to write
     35      multimedia software, such as games and emulators.
     36    </para>
    3537
    3638    &lfs91_checked;
     
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&sdl-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&sdl-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &sdl-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &sdl-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &sdl-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &sdl-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&sdl-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&sdl-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &sdl-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &sdl-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &sdl-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &sdl-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
     
    8498    <title>Installation of SDL</title>
    8599
    86     <para>Install <application>SDL</application> by running the
    87     following commands:</para>
     100    <para>
     101      Install <application>SDL</application> by running the
     102      following commands:
     103    </para>
    88104
    89105<screen><userinput>sed -e '/_XData32/s:register long:register _Xconst long:' \
     
    94110make</userinput></screen>
    95111
    96     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     112    <para>
     113      Now, as the <systemitem class="username">root</systemitem> user:
     114    </para>
    97115
    98116<screen role="root"><userinput>make install &amp;&amp;
     
    107125    <title>Testing SDL</title>
    108126
    109     <para>If you wish 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>
     127    <para>
     128      If you wish to, test the installation of <application>SDL</application>
     129      using the included test programs. It is not required to install any of
     130      the resulting binaries to validate the installation. Issue the following
     131      commands to build the test programs:
     132    </para>
    114133
    115134<screen remap="test"><userinput>cd test &amp;&amp;
     
    117136make</userinput></screen>
    118137
    119     <para>You'll need to manually run all the test programs (they are listed in
    120     the <filename>README</filename> file in this directory).  Many of them will
    121     need to be manually killed, and you'll need to turn your speakers on with
    122     the volume at a suitable level.</para>
     138    <para>
     139      You'll need to manually run all the test programs (they are listed in
     140      the <filename>README</filename> file in this directory).  Many of them
     141      will need to be manually killed, and you'll need to turn your speakers
     142      on with the volume at a suitable level.
     143    </para>
    123144
    124145  </sect2>
     
    127148    <title>Command Explanations</title>
    128149
    129     <para><command>sed -e ...</command>: This command fixes compilation with
    130     libX11-1.6.0 and later.</para>
     150    <para>
     151      <command>sed -e ...</command>: This command fixes compilation with
     152      libX11-1.6.0 and later.
     153    </para>
    131154
    132155    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    133156      href="../../xincludes/static-libraries.xml"/>
    134157
    135     <para><option>--disable-alsa-shared</option>: This switch disables
    136     dynamically loading ALSA shared libraries.</para>
    137 
    138     <para><option>--disable-sdl-dlopen</option>: This switch disables using
    139     dlopen for shared object loading. Loading image backend libraries like
    140     libpng dynamically on the fly does not work.</para>
    141 
    142     <para><option>--disable-x11-shared</option>: This switch disables
    143     dynamically loading X11 shared libraries.</para>
     158    <para>
     159      <option>--disable-alsa-shared</option>: This switch disables
     160      dynamically loading ALSA shared libraries.
     161    </para>
     162
     163    <para>
     164      <option>--disable-sdl-dlopen</option>: This switch disables using
     165      dlopen for shared object loading. Loading image backend libraries like
     166      libpng dynamically on the fly does not work.
     167    </para>
     168
     169    <para>
     170      <option>--disable-x11-shared</option>: This switch disables
     171      dynamically loading X11 shared libraries.
     172    </para>
    144173
    145174  </sect2>
     
    181210        <term><command>sdl-config</command></term>
    182211        <listitem>
    183           <para>determines the compile and linker flags that should be used to
    184           compile and link programs that use
    185           <filename class='libraryfile'>libSDL</filename>.</para>
     212          <para>
     213            determines the compile and linker flags that should be used to
     214            compile and link programs that use
     215            <filename class='libraryfile'>libSDL</filename>.
     216          </para>
    186217          <indexterm zone="sdl sdl-config">
    187218            <primary sortas="b-sdl-config">sdl-config</primary>
     
    193224        <term><filename class='libraryfile'>libSDL.so</filename></term>
    194225        <listitem>
    195           <para> library provides low level access to audio, keyboard, mouse,
    196           joystick, 3D hardware via OpenGL, and
    197           2D frame buffer across multiple platforms.</para>
     226          <para>
     227            contains functions that provide low level access to audio,
     228            keyboard, mouse, joystick, 3D hardware via OpenGL, and
     229            2D frame buffer across multiple platforms.
     230          </para>
    198231          <indexterm zone="sdl libsdl">
    199232            <primary sortas="c-libsdl">libSDL.so</primary>
Note: See TracChangeset for help on using the changeset viewer.