docs for pango done

[sdlgit/SDL-Site.git] / pages / blog-0019.html-inc

diff --git a/pages/blog-0019.html-inc b/pages/blog-0019.html-inc
index 298a7b6..06aca75 100644 (file)
--- a/pages/blog-0019.html-inc
+++ b/pages/blog-0019.html-inc
@@ -1,6 +1,40 @@
 <div class="blog">
 <h1 id="NAME">
-Code is not the only thing
+Design of SDL::Rect
 </h1>
 <div class="CONTENT">
-<div style="float: right;"><i><br />I did,<br />no one cared,<br />I spoke,<br />no one heard,<br />I wrote,<br />someone read.<br /></i><br /></div><br /><p style="clear: both;">After only several weeks of maintaining SDL perl, Today I have come to <a href="http://www.nntp.perl.org/group/perl.sdl.devel/2009/08/msg1405.html">noticed </a>how important it is to update README's, docs and so on. I will redouble my effort to do <a href="http://github.com/kthakore/SDL_perl/commit/e504c139e12e5592b5694292bb1882ee78b65b28">this</a>. </p><br /><p>However I am not sure where to start updating docs. Has anyone re-documented old modules before? Any advice? If anyone is interested in helping me to sort out documentation please contact me on sdl-devel@perl.org. For people wanting to learn the SDL base there is no better way.<br /></p><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-2082858297367668517?l=yapgh.blogspot.com'/></div></div></div>
\ No newline at end of file
+<div style="text-align: right;"><i><br />
+you say things,<br />
+I hear,<br />
+but don't listen,<br />
+<br />
+you show things,<br />
+I see,<br />
+but don't understand,<br />
+<br />
+you write things,<br />
+I read,<br />
+but don't know.<br />
+</i></div><br />
+Lately we have been working on cleaning up the XS name spaces of SDL perl. After some bumps and falls we came up with a separated Rect module. Rect is one of the most simple C struct as shown below. <br />
+<br />
+<script src="http://gist.github.com/185940.js">
+</script><br />
+<br />
+Using the awesome <a href="http://cpansearch.perl.org/src/DMR/CookBookB-19960430/perlobject.map">perlobject.map</a> as a reference I was able to create a <a href="http://github.com/kthakore/SDL_perl/blob/a1b835c168ec184abc01edbc01862ffa15624c26/lib/SDL/Rect.pm">blessed perl</a> object in <a href="http://github.com/kthakore/SDL_perl/blob/a1b835c168ec184abc01edbc01862ffa15624c26/src/Rect.xs">XS</a>. So now SDL::Rect-&gt;new(...) gave us a blessed reference ready to go. And as an icing it would destroy itself properly no matter where it was used. But once I brought it into our existing code base, garu pointed out the extending it was a little bit of a mess. So far to extend Rect we have to something like below. Any comment or advice would be much appreciated.<br />
+<br />
+<br />
+<script src="http://gist.github.com/185938.js">
+</script><br />
+<br />
+<br />
+Have at it I am a big boy. You can grab the code like this.<br />
+Only If you don't already have a local git repo:<br />
+<br />
+<blockquote>mkdir SDL<br />
+cd SDL<br />
+git init .</blockquote><br />
+Then do this or skip to this if you already have a local git repo<br />
+<blockquote>git pull git://github.com/kthakore/SDL_perl.git experimental</blockquote><div class="blogger-post-footer"><img width='1' height='1' src='https://blogger.googleusercontent.com/tracker/3102167581424744259-3340771783563950133?l=yapgh.blogspot.com' alt='' /></div>
+<p><a href="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/0/da"><img src="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/0/di" border="0" ismap="true"></img></a><br/>
+<a href="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/1/da"><img src="http://feedads.g.doubleclick.net/~a/KEhhydXQVOQIR77sDEUjV6-zh0M/1/di" border="0" ismap="true"></img></a></p><img src="http://feeds.feedburner.com/~r/YetAnotherPerlGameHackeryapgh/~4/6i-HmfODM5o" height="1" width="1"/></div></div>
\ No newline at end of file