<div class="blog">
<h1 id="NAME">
-The Build Process of SDL Perl
+Grant Progess Reports 1-3: Sept - Nov
</h1>
<div class="CONTENT">
-<p>A while ago I had a long chat with mst on why SDL uses Module::Build rather then Make. I told him it is a simple matter of code inertia. The existing Module::Build system has worked well for us so far. Never the less, he convinced me that switching to Make will improve debugging the Build system. But to be able to switch we will need to completely replace the Build system. I am not prepared to do that so I will just present the requirements so mst or someone else can at least attempt to switch.</p><br />
+As you know I have received a TPF grant to write a SDL Perl Manual.<br />
+<a href="http://www.blogger.com/goog_716654272"><br />
+</a><br />
+<a href="http://news.perlfoundation.org/2010/08/2010q3-grant-proposal-manual-f.html">http://news.perlfoundation.org/2010/08/2010q3-grant-proposal-manual-f.html</a><br />
<br />
-<h3>The Build Process </h3><br />
-<b> Alien::SDL </b><br />
+<a href="http://news.perlfoundation.org/2010/08/accepted-grants-for-2010q3.html">http://news.perlfoundation.org/2010/08/accepted-grants-for-2010q3.html</a><br />
<br />
-<p>SDL Perl depends on a few C libraries for a complete install. This is handled by Alien::SDL. First we look for existing SDL libraries and dependencies by doing a <a href="http://github.com/kthakore/Alien_SDL/blob/master/inc/My/Utility.pm#L581">File::Find</a> for headers. If these headers are found we present and option for the user to use those. We then store these locations in Alien::SDL->config options 'cflags', 'prefix' and 'libs'. If we do not have libraries available even for a minimum SDL installed ( SDL.h is not found). We provide several platform specific options. </p><br />
-<p>For windows we have a simpler process. We download<a href="http://github.com/kthakore/Alien_SDL/blob/master/inc/My/Utility.pm#L7"> prebuilt </a>binaries ( and checksum ) based on the user's selection and just copy them in to the right location. Again the 'prefix', 'cflags', and 'libs' is saved in Alien::SDL->config. </p><br />
-<p>For *nix/MacOSX we download sources and attempt to compile them. To be able to do this we download several other dependencies like libpng, jpeg and pango. You can see how we do this using hashes <a href="http://github.com/kthakore/Alien_SDL/blob/master/inc/My/Utility.pm#L404">here</a>. During the compile process we also apply patches as needed for the <a href="http://github.com/kthakore/Alien_SDL/blob/master/inc/My/Utility.pm#L430">sources</a>. Once this is done we can head to SDL Build.PL </p><br />
-<b> SDL Perl dependency resolution </b><br />
+I have been a bit busy with that and not been able to update my blog. Anyway here are some of the back dated Grant Updates. These updates where also posted on <a href="http://news.perlfoundation.org/">http://news.perlfoundation.org/</a><br />
<br />
-SDL's Build is responsible for linking the right libraries to the correct XS. If libraries are missing it will disable the component (not put it in SDL->config). <br />
<br />
-<p>For example to build <a href="http://github.com/kthakore/SDL_perl/blob/master/Build.PL#L342">Image.xs</a> we require libsdl, libsdl_image and lib[jpg|png|tiff]. So we would check for these headers in the prefix provided by Alien::SDL->config. If they are not provided we will disable the SDL::Image module. </p><br />
-<p>More over the availability of each library is specified as a -DMACRO to the gcc compiler. This way we can prevent XS failures due to missing libraries using #DEFINES. Here the SDL_image macro is <a href="http://github.com/kthakore/SDL_perl/blob/master/Build.PL#L422">defined</a> and <a href="http://github.com/kthakore/SDL_perl/blob/master/src/Image.xs#L13">used</a>. The availability of the module is then available from <a href="http://github.com/kthakore/SDL_perl/blob/master/t/image.t#L20">SDL::Config->has()</a> <br />
+<a name='more'></a><br />
<br />
+<div style="text-align: center;">REPORT 1: Sept 2010</div><br />
+<ul><li>1st drafts <ul><li>Preface </li>
+<li>Chapter 2: First SDL Application</li>
+</ul></li>
+<li>Started work on Chapter 3: Drawing</li>
+<li>Outlines for the first 7 chapters have been completed</li>
+<li>Book build framework has been setup</li>
+<li>Released SDL 2.514 (2.515 will be released on 16th of September) <ul><li>This code is the one that will be used in the book for chapter 02</li>
+</ul></li>
+<li>Got more of the Drawing chapter done (It will be done by the end of the week) </li>
+<li>Added several more code examples for other chapters</li>
+</ul>Progress: 2.75 chapters / 11 chapters = approx 25%<br />
+Kartik's work can be followed at:<br />
+<ul><li><a href="http://github.com/PerlGameDev/SDL_Manual">http://github.com/PerlGameDev/SDL_Manual</a></li>
+<li><a href="http://sdlperl.ath.cx/releases/SDL_Manual.pdf">http://sdlperl.ath.cx/releases/SDL_Manual.pdf</a></li>
+</ul><br />
<br />
-<b> Conclusion </b> <br />
-<p>This is a high level overview of our Build process, because frankly I hate traumatizing my brain with this again. Credits have to go to FROGGS and kmx for helping with this Build scheme. Hopefully my post have helped people at the very least appreciate the problem scope of this Build system. That said I believe a fresh written build system, with these requirements in mind, will be more then welcome.<br />
-</p><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-4514794130108689562?l=yapgh.blogspot.com' alt='' /></div>
-<p><a href="http://feedads.g.doubleclick.net/~a/SHI8waMCUMOT4LmhUSkV3-Y1cK8/0/da"><img src="http://feedads.g.doubleclick.net/~a/SHI8waMCUMOT4LmhUSkV3-Y1cK8/0/di" border="0" ismap="true"></img></a><br/>
-<a href="http://feedads.g.doubleclick.net/~a/SHI8waMCUMOT4LmhUSkV3-Y1cK8/1/da"><img src="http://feedads.g.doubleclick.net/~a/SHI8waMCUMOT4LmhUSkV3-Y1cK8/1/di" border="0" ismap="true"></img></a></p><img src="http://feeds.feedburner.com/~r/YetAnotherPerlGameHackeryapgh/~4/fTwVmM222rA" height="1" width="1"/></div></div>
\ No newline at end of file
+<div style="text-align: center;">REPORT 2: October 2010</div><div style="text-align: center;"><br />
+</div><div style="text-align: left;">Since last time:<br />
+<ul><li>We have released SDL 2.518 <ul><li>Game Loop support completed</li>
+</ul></li>
+</ul>Chapters:<br />
+<ul><li>2nd Drafts for: <ul><li>Preface to Game Loop ( Chapter 0 - Chapter 04)</li>
+</ul></li>
+<li>Chapters completed: 5/11 => 45%</li>
+</ul>Extra:<br />
+<ul><li>cfedde has made a script to extract code listings for readers to try examples with out having to retype them.</li>
+</ul>Coments:<br />
+<ul><li>I am receiving a lot more help from the community, most notable from cfedde for proofreading.</li>
+<li>I will be fleshing out the next 6 chapters shortly and work will begin on them soon</li>
+<li>I am pleased with the progress so far, and I feel the quality is improving due to the pacing.</li>
+</ul>Our work can be seen at:<br />
+<ul><li><a href="http://sdlperl.ath.cx/releases/SDL_Manual.pdf">http://sdlperl.ath.cx/releases/SDL_Manual.pdf</a></li>
+<li><a href="http://sdlperl.ath.cx/releases/SDL_Manual.html">http://sdlperl.ath.cx/releases/SDL_Manual.html</a></li>
+<li><a href="http://github.com/PerlGameDev/SDL_Manual">http://github.com/PerlGameDev/SDL_Manual</a></li>
+</ul></div><br />
+<div style="text-align: center;">REPORT 3: November 2010</div><div style="text-align: left;"><br />
+This is the progress so far:<br />
+<br />
+- SDL 2.523 Releases:<br />
+ - Adds stability and better memory management for the game loop<br />
+<br />
+- 2 chapters have been completed <br />
+ - Pong Chapter (Contributed by garu)<br />
+ - Additional Modules<br />
+- 1 extra chapter has been added<br />
+ - Puzz(le) Chapter (Contributed by Blaizer)<br />
+<br />
+- 2 Chapters are in the Works<br />
+ - Tetris Code has been mostly done (contributed by FROGGS)<br />
+ - Needs to be fixed <br />
+ - Needs write up<br />
+ - Sound and Music Effects code is done<br />
+ - Needs to be fixed<br />
+ - Needs write up<br />
+<br />
+Our work can be seen at:</div><div style="text-align: left;"><a href="http://sdlperl.ath.cx/releases/SDL_Manual.pdf">http://sdlperl.ath.cx/releases/SDL_Manual.pdf</a></div><div style="text-align: left;"><a href="http://sdlperl.ath.cx/releases/SDL_Manual.html">http://sdlperl.ath.cx/releases/SDL_Manual.html</a></div><div style="text-align: left;"><a href="http://github.com/PerlGameDev/SDL_Manual">http://github.com/PerlGameDev/SDL_Manual</a></div><div style="text-align: left;"></div><div style="text-align: left;"></div><div style="text-align: left;"><br />
+Regards,<br />
+YAPGH</div><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-4413645254021668635?l=yapgh.blogspot.com' alt='' /></div>
+<p><a href="http://feedads.g.doubleclick.net/~a/rCHqQ4GfQzQ_w9cl8yTT7oNQNJ8/0/da"><img src="http://feedads.g.doubleclick.net/~a/rCHqQ4GfQzQ_w9cl8yTT7oNQNJ8/0/di" border="0" ismap="true"></img></a><br/>
+<a href="http://feedads.g.doubleclick.net/~a/rCHqQ4GfQzQ_w9cl8yTT7oNQNJ8/1/da"><img src="http://feedads.g.doubleclick.net/~a/rCHqQ4GfQzQ_w9cl8yTT7oNQNJ8/1/di" border="0" ismap="true"></img></a></p><img src="http://feeds.feedburner.com/~r/YetAnotherPerlGameHackeryapgh/~4/XruRd8WgjyQ" height="1" width="1"/></div></div>
\ No newline at end of file
projects / sdlgit/SDL-Site.git / blobdiff