{"id":17,"date":"2005-08-16T23:13:54","date_gmt":"2005-08-17T03:13:54","guid":{"rendered":"http:\/\/www.rakkar.org\/blog\/?p=13"},"modified":"2005-08-16T23:13:54","modified_gmt":"2005-08-17T03:13:54","slug":"documentation-who-needs-it","status":"publish","type":"post","link":"https:\/\/rakkar.org\/blog\/index.php\/2005\/08\/16\/documentation-who-needs-it\/","title":{"rendered":"Documentation?  Who needs it?"},"content":{"rendered":"<p>\t\t\t\tSo here I am, doing what I usually do on my game.  You get two guesses:<br \/>\n1. Adding features<br \/>\n2. Screwing around with compiler settings, trying to get third party libraries to work<\/p>\n<p>If you guessed 1, you haven&#8217;t read any other posts on this blog.<\/p>\n<p>So this time it&#8217;s Open AL.  Back with version 1.0 I got it working quickly and with a minimum of hassle.  I updated to 1.1 it&#8217;s like they purposely made it hard to compile.  ONE API has FIVE projects, two of which are DLLs and 3 of which are static libraries.  There&#8217;s no documentation on why there are 5 projects or what they do but who needs it when you have such descriptive names as &#8220;ALc&#8221;, &#8220;ALu&#8221;, and &#8220;ALut&#8221;?<\/p>\n<p>After like an hour I got the damn thing compiling to a library, only to find out that it crashes every time I run it somewhere in assembly code.  So I give up on libraries and just try to compile the source.  Burn past about 100 warnings, get it compiling, and still crash in the same spot.<\/p>\n<p>I&#8217;m still working on it.  I&#8217;m just happy there is only one more third party library to deal with: Newton Physics.  Hopefully that won&#8217;t be too bad.  I wish more people took a lesson from the Irrlicht author and actually designed libraries in a meaningful robust fashion and include documentation.\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"<p>So here I am, doing what I usually do on my game. You get two guesses: 1. Adding features 2. Screwing around with compiler settings, trying to get third party libraries to work If you guessed 1, you haven&#8217;t read any other posts on this blog. So this time it&#8217;s Open AL. Back with version [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[2],"tags":[],"_links":{"self":[{"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/posts\/17"}],"collection":[{"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/comments?post=17"}],"version-history":[{"count":0,"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/posts\/17\/revisions"}],"wp:attachment":[{"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/media?parent=17"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/categories?post=17"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rakkar.org\/blog\/index.php\/wp-json\/wp\/v2\/tags?post=17"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}