Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Indexing preface chapter

  • Loading branch information...
commit c988b635d460a5c06fb75fbf3244b78595a31d67 1 parent 90590f3
@kthakore kthakore authored
View
22 dist/SDL_Manual.html
@@ -1,5 +1,7 @@
<h1>Preface</h1>
+<p><a name="libsdl"> </p>
+
<p><i>Simple DirectMedia Layer</i> (or <i>libsdl</i>) is a cross-platform C
library that provides access to several input and output devices. Its most
popular usage is to provide access to the video framebuffer and input
@@ -7,16 +9,22 @@
features such as text display, sound mixing, image handling, and graphics
effects.</p>
+<p> </p>
+
<p>SDL Perl binds several of these libraries together in the
<code>SDL::*</code> namespace. Moreover, SDL Perl provides several
high-level libraries in the <code>SDLx::*</code> namespace that encapsulate
valuable game-writing abstractions.</p>
+<p></p>
+
<h2><code>SDL</code> and <code>SDLx</code></h2>
<p>The main purpose of the <code>SDLx::*</code> layer is to smooth out the
drudgery of using the <code>SDL::*</code> layer directly.</p>
+<p></p>
+
<blockquote>
<p>Don't worry about understanding the details of this code right now.
@@ -98,17 +106,23 @@
<h2>Installing SDL Perl</h2>
+<p></p>
+
<p>We assume the presence of a recent version of the Perl language (at
least Perl 5.10) and supporting packages. We also assume that you can
install packages from the CPAN, including SDL Perl itself.</p>
<h3>Windows</h3>
+<p> </p>
+
<p><code>Alien::SDL</code> will install binaries for 32bit and 64bit so
there is no need to compile anything.</p>
<h3>Mac OS X</h3>
+<p> </p>
+
<p>Fink has packages for SDL Perl available. However, they do not support
Pango, a library which provides internalization support for text
handling.</p>
@@ -121,6 +135,8 @@
<h3>GNU/Linux</h3>
+<p> </p>
+
<p>Most current GNU/Linux distributions include all the parts needed for
this tutorial in the default install and in their package management
system. It is also always possible to install on GNU/Linux using the
@@ -144,6 +160,8 @@
<h3>CPAN install</h3>
+<p></p>
+
<p>Before installing SDL Perl, ensure that you have the most recent
versions of the modules necessary to build SDL:</p>
@@ -159,6 +177,8 @@
<h2>Contact</h2>
+<p></p>
+
<p>Hopefully this book answers most of your questions. For additional
assistance, contact the project via:</p>
@@ -177,6 +197,8 @@
<h2>Examples</h2>
+<p></p>
+
<p>The code examples in this book are available from
https://github.com/PerlGameDev/SDL_Manual/tree/master/code_listings.</p>
View
BIN  dist/SDL_Manual.pdf
Binary file not shown
View
28 src/00-preface.pod
@@ -1,20 +1,31 @@
=head0 Preface
+Z<libsdl>
+X<libsdl>
+
I<Simple DirectMedia Layer> (or I<libsdl>) is a cross-platform C library that
provides access to several input and output devices. Its most popular usage is
to provide access to the video framebuffer and input devices for games. SDL
also has several extension libraries to provide features such as text display,
sound mixing, image handling, and graphics effects.
+X<Description libsdl>
+X<libsdl Description>
+
SDL Perl binds several of these libraries together in the C<SDL::*> namespace.
Moreover, SDL Perl provides several high-level libraries in the C<SDLx::*>
namespace that encapsulate valuable game-writing abstractions.
+X< C<SDL::> and C<SDLx::> namespace>
+
+
=head1 C<SDL> and C<SDLx>
The main purpose of the C<SDLx::*> layer is to smooth out the drudgery of using
the C<SDL::*> layer directly.
+X< C<SDL::> and C<SDLx::> purpose>
+
=for sidebar
Don't worry about understanding the details of this code right now. Compare the
@@ -100,17 +111,25 @@ U<http://sdl.perl.org/>.
=head1 Installing SDL Perl
+X<Installing>
+
We assume the presence of a recent version of the Perl language (at least Perl
5.10) and supporting packages. We also assume that you can install packages
from the CPAN, including SDL Perl itself.
=head2 Windows
+X<Installing Windows>
+X<Windows: Install>
+
C<Alien::SDL> will install binaries for 32bit and 64bit so there is no need
to compile anything.
=head2 Mac OS X
+X<Installing Mac OS X>
+X<Mac OS X: Install>
+
Fink has packages for SDL Perl available. However, they do not support Pango, a
library which provides internalization support for text handling.
@@ -121,6 +140,9 @@ their headers.
=head2 GNU/Linux
+X<Installing Linux>
+X<Linux: Install>
+
Most current GNU/Linux distributions include all the parts needed for this
tutorial in the default install and in their package management system. It is
also always possible to install on GNU/Linux using the available open source
@@ -142,6 +164,8 @@ and some libraries are required.
=head2 CPAN install
+X<SDL install>
+
Before installing SDL Perl, ensure that you have the most recent versions of
the modules necessary to build SDL:
@@ -157,6 +181,8 @@ platforms are listed at U<http://pass.cpantesters.org/distro/S/SDL.html>.
=head1 Contact
+X<Contact>
+
Hopefully this book answers most of your questions. For additional assistance,
contact the project via:
@@ -174,6 +200,8 @@ active and helpful resource.
=head1 Examples
+X<Code Examples>
+
The code examples in this book are available from
U<https://github.com/PerlGameDev/SDL_Manual/tree/master/code_listings>.
Please sign in to comment.
Something went wrong with that request. Please try again.