X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fyoink;a=blobdiff_plain;f=README;h=698d3c84f93070b6f8301039427a09b65077c0b2;hp=3f99fc6cd9839d2414e9f4170ff2fb049fc96f7a;hb=HEAD;hpb=31d52677b38d935297d132bdbd956c655cd3feee diff --git a/README b/README index 3f99fc6..698d3c8 100644 --- a/README +++ b/README @@ -1,49 +1,101 @@ +YOINK_README(7) Miscellaneous Information Manual YOINK_README(7) -Yoink is a game originally developed by Neil Carter for Mac OS. You play the -part of a flying alien heroine who must defend her home on Earth from other -airborne alien invaders. +NAME + yoink_readme -- general information about yoink -This version of the game uses all new code and modern frameworks to bring -this simple, fast-moving action game to a wider audience. +DESCRIPTION + Yoink is a game created by Neil Carter for Mac OS. You play the part of + a flying alien heroine who must defend her home on Earth from other + airborne alien invaders. -The new code is released under the BSD-2 license. The old code and original -resources are provided under the zlib/libpng License. See COPYING for complete -details. + This version of the game uses all new code and modern frameworks to bring + this simple, fast-moving action game to a wider audience. -Dependencies: + INSTALLATION + Installing Yoink is simple. You can typically use commands such as + these: -boost headers -freealut -libvorbis -Lua -OpenAL -OpenGL -SDL -SDL_image (with libpng support) + cd /path/to/yoink + ./configure + make && make install + This will install Yoink into the /usr/local directory. To run Yoink, + issue the command: -Notes regarding the code: + /usr/local/bin/yoink -The code is a complete rewrite, containing none of the original code. I've made -some effort to put the more generic or reusable code into a separate library -called Moof. I've also made an effort to incorporate 3rd-party code that -happened to fit well into what I needed. So, generally, the source code is -separated into these three categories: + or just yoink if /usr/local/bin is already in your PATH. See + yoink_install(7) for a more detailed discussion about the build system + and a list of required packages. -1. Yoink-specific code. + LICENSE + The new code is released under the 2-clause BSD license. The old code + and original resources are provided under the zlib/libpng license. See + the file COPYING for complete details. Other parts are distributed under + different licenses. See yoink_license(7) for the full texts of the + relevant licenses. -This is the code directly in src/. These classes reside in no namespace. + ABOUT THE CODE + The code is a complete rewrite, containing none of the original code. + I've made some effort to put the more generic or reusable code into a + separate library called libmoof. I've also made an effort to incorporate + 3rd-party code that happened to fit well into what I needed. So, + generally, the source code is separated into these three categories: -2. Reusable code. + 1. Yoink-specific code. This is the code in the src directory. These + classes reside in no explicit namespace. -Currently, the code is in src/Moof/, and it is compiled as a convenience -library. These classes and other helper functions reside in the Mf namespace. -Since I wrote this code alongside the Yoink-specific stuff, there is somewhat of -a blurry line between the two categories. + 2. Reusable code. The code is in src/moof, and it is compiled as a + convenience library. These classes and helper functions reside in + the moof namespace. Since I wrote this code alongside the Yoink- + specific stuff, there is somewhat of a blurry line between the two + categories, unfortunately. -3. 3rd-party code. + 3. Third-party code. This is made up of free code from other projects + or libraries, the licenses of which are also noted in the COPYING + file. This code resides in various namespaces and in various + subdirectories of src. -This is made up of free code from other projects or libraries (aside from the -explicit dependencies above), the licenses of which are also in the COPYING -file. This code resides in various namespaces and in various subdirectories. + PACKAGING + Here are some tips to help packagers: + o The build scripts are written in Lua, so make sure the Lua + interpreter is installed. That shouldn't be a problem since Yoink + depends on the Lua library anyway. + + o The Makefile will only work well with GNU make. On some systems, + this is installed as gmake. + + o The configure script supports most of the useful options that an + Autoconf-generated script would have, and the Makefile supports + DESTDIR. + + See yoink_install(7) for a more detailed discussion about the build + system. + + SENDING PATCHES + I'll gladly entertain patches if you want to help out. Just email me + your stuff or tell me where to pull if you use git. If you're interested + in that, please observe the following: + + o Stick to the coding style of the source code files you edit. Follow + the general style of method and variable naming, as well as white + space formatting. In particular, use literal tabs with an assumed + tabstop of 8 characters. Also, try to limit line lengths to 78 + characters. + + o For legal reasons, don't include other peoples' code with your patch. + You must also agree to license your changes according to the same + terms and conditions as the files you edit, usually the 2-clause BSD + license. + + o If you want your name and contact information in the AUTHORS file, + please make it so in the patch you provide. + +SEE ALSO + yoinkrc(5), yoink(6) + +AUTHORS + Charles McGarvey chaz@dogcows.com + +NetBSD 5.1.0_PATCH June 14, 2011 NetBSD 5.1.0_PATCH