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/sdl2.xml

    r22618785 r2eeb8695  
    3030    <title>Introduction to SDL2</title>
    3131
    32     <para>The Simple DirectMedia Layer Version 2
    33     (<application>SDL2</application> for short) is a cross-platform library
    34     designed to make it easy to write multimedia software, such as games and
    35     emulators.</para>
     32    <para>
     33      The Simple DirectMedia Layer Version 2 (<application>SDL2</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>
    3637
    3738    &lfs91_checked;
    … …  
    4041    <itemizedlist spacing="compact">
    4142      <listitem>
    42         <para>Download (HTTP): <ulink url="&sdl2-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&sdl2-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &sdl2-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &sdl2-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &sdl2-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &sdl2-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&sdl2-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&sdl2-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &sdl2-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &sdl2-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &sdl2-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &sdl2-time;
     70        </para>
    5871      </listitem>
    5972    </itemizedlist>
    … …  
    92105    <title>Installation of SDL2</title>
    93106
    94     <para>First, if you are building on a 32-bit i686 system, apply a patch
    95     containing a fix for the OpenGL headers and their data types:</para>
     107    <para>
     108      First, if you are building on a 32-bit i686 system, apply a patch
     109      containing a fix for the OpenGL headers and their data types:
     110    </para>
    96111
    97112<screen><userinput remap="pre">case $(uname -m) in
    … …  
    99114esac</userinput></screen>
    100115
    101     <para>Install <application>SDL2</application> by running the
    102     following commands:</para>
     116    <para>
     117      Install <application>SDL2</application> by running the
     118      following commands:
     119    </para>
    103120
    104121<screen><userinput>./configure --prefix=/usr &amp;&amp;
    … …  
    115132
    116133    <note>
    117       <para>If you wish to build and run the package regression
    118       tests, do not delete the static libraries below until after
    119       the tests are built.</para>
     134      <para>
     135        If you wish to build and run the package regression
     136        tests, do not delete the static libraries below until after
     137        the tests are built.
     138      </para>
    120139    </note>
    121140
    122     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     141    <para>
     142      Now, as the <systemitem class="username">root</systemitem> user:
     143    </para>
    123144
    124145<screen role="root"><userinput>make install              &amp;&amp;
    125146rm -v /usr/lib/libSDL2*.a</userinput></screen>
    126147
    127     <para>If you built the documentation, install it as the <systemitem
    128     class="username">root</systemitem> user:</para>
     148    <para>
     149      If you built the documentation, install it as the <systemitem
     150      class="username">root</systemitem> user:
     151    </para>
    129152
    130153<screen role="root"
    … …  
    139162    <title>Testing SDL2</title>
    140163
    141     <para>If you wish to, test the installation of
    142     <application>SDL2</application> using the included
    143     test programs.
    144     None of the resulting binaries need to be installed.
    145     Issue the following commands to build the
    146     test programs:</para>
     164    <para>
     165      If you wish to, test the installation of <application>SDL2</application>
     166      using the included test programs.  None of the resulting binaries need
     167      to be installed.  Issue the following commands to build the test
     168      programs:
     169    </para>
    147170
    148171<screen><userinput>cd test &amp;&amp;
    … …  
    150173make</userinput></screen>
    151174
    152     <para>Each of the test programs (they are listed in the
    153     <filename>README</filename> file in this directory) will need to be run
    154     individually.  Many of them will need to be manually killed. Additionally,
    155     speakers need to be on with the volume at a suitable level.</para>
     175    <para>
     176      Each of the test programs (they are listed in the
     177      <filename>README</filename> file in this directory) will need to be run
     178      individually.  Many of them will need to be manually killed. Additionally,
     179      speakers need to be on with the volume at a suitable level.
     180    </para>
    156181
    157182  </sect2>
    … …  
    160185    <title>Command Explanations</title>
    161186
    162     <para><command>rm -v /usr/lib/libSDL2*.a</command>: Normally
    163     static libraries can be disabled with a <option>--disable-static</option>
    164     option to configure, but that breaks the build in this package.</para>
    165 
    166     <para><option>--disable-alsa-shared</option>: This switch disables
    167     dynamically loading ALSA shared libraries.</para>
    168 
    169     <para><option>--disable-sdl-dlopen</option>: This switch disables using
    170     dlopen for shared object loading. Loading image backend libraries like
    171     libpng dynamically on the fly does not work.</para>
    172 
    173     <para><option>--disable-x11-shared</option>: This switch disables
    174     dynamically loading X11 shared libraries.</para>
     187    <para>
     188      <command>rm -v /usr/lib/libSDL2*.a</command>: Normally
     189      static libraries can be disabled with a <option>--disable-static</option>
     190      option to configure, but that breaks the build in this package.
     191    </para>
     192
     193    <para>
     194      <option>--disable-alsa-shared</option>: This switch disables
     195      dynamically loading ALSA shared libraries.
     196    </para>
     197
     198    <para>
     199      <option>--disable-sdl-dlopen</option>: This switch disables using
     200      dlopen for shared object loading. Loading image backend libraries like
     201      libpng dynamically on the fly does not work.
     202    </para>
     203
     204    <para>
     205      <option>--disable-x11-shared</option>: This switch disables
     206      dynamically loading X11 shared libraries.
     207    </para>
    175208
    176209  </sect2>
    … …  
    213246        <term><command>sdl2-config</command></term>
    214247        <listitem>
    215           <para>determines the compile and linker flags that should be used to
    216           compile and link programs that use
    217           <filename class='libraryfile'>libSDL2</filename>.</para>
     248          <para>
     249            determines the compile and linker flags that should be used to
     250            compile and link programs that use
     251            <filename class='libraryfile'>libSDL2</filename>.
     252          </para>
    218253          <indexterm zone="sdl2 sdl2-config">
    219254            <primary sortas="b-sdl2-config">sdl2-config</primary>
    … …  
    225260        <term><filename class='libraryfile'>libSDL2.so</filename></term>
    226261        <listitem>
    227           <para> library provides low level access to audio, keyboard, mouse,
    228           joystick, 3D hardware via OpenGL, and
    229           2D frame buffer across multiple platforms.</para>
     262          <para>
     263            contains functions that provide low level access to audio,
     264            keyboard, mouse, joystick, 3D hardware via OpenGL, and
     265            2D frame buffer across multiple platforms.
     266          </para>
    230267          <indexterm zone="sdl2 libsdl2">
    231268            <primary sortas="c-libsdl2">libSDL2.so</primary>
Note: See TracChangeset for help on using the changeset viewer.