From 81822f6cf91fed1951bebff76fc5dd445d27223c Mon Sep 17 00:00:00 2001 From: Michael Bayne Date: Wed, 6 Apr 2011 22:53:40 +0000 Subject: [PATCH] Markdownified, updated README. git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@1150 ed5b42cb-e716-0410-a449-f6a68f950b19 --- README | 63 ------------------------------------------ README.md | 82 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 82 insertions(+), 63 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 6d2c46e2..00000000 --- a/README +++ /dev/null @@ -1,63 +0,0 @@ -The Nenya library ------------------ - -The Nenya library provides various facilities for making networked multiplayer -games. Its various packages include: - - * geom, util - basic tools for doing data structure manipulation and some - geometry math - * resource - tools for bundling, deploying and managing media (images, - sounds, etc.) with a game - * media - a framework for doing "active" rendering in Java - * media.image - tools for loading, caching, manipulating and displaying images - * media.sound - tools for loading, caching, and playing audio - * media.animation, media.sprite - works in concert with the active - rendering system and provides tools for defining and manipulating - sprites (graphical entities that follow paths) and animations - (graphical entities that affect the display in other ways) - * miso - a framework for defining and displaying isometrically rendered scenes - * cast - a framework for defining and using recolorable, composited - characters with different poses and actions - -Documentation is somewhat sparse at the moment, but inspection of the code in -the tests/ directory shows examples of use of many features of the library. - -Building --------- - -Building the library is very simple. First ensure that the necessary third -party jar files are available in the lib/ directory. See lib/README for a list -of the necessary third party jar files and how to get them. - -The library is built using Ant, a modern build tool written in and for Java. If -you aren't already using Ant for other projects, it can be found here: - - http://ant.apache.org/ - -Invoke ant with any of the following targets: - - all: builds the distribution files and javadoc documentation - compile: builds only the class files (dist/classes) - javadoc: builds only the javadoc documentation (dist/docs) - dist: builds the distribution jar files (dist/*.jar) - -Distribution ------------- - -The Nenya library is released under the LGPL. The most recent version of the -library is available here: - - http://code.google.com/p/nenya/ - -Contributions and Contact Information -------------------------------------- - -Nerya is actively developed by the scurvy dogs at Three Rings Design, Inc. -Contributions are welcome. - -Questions, comments, contributions, and other worldly endeavors can be -handled in the Google Group for Three Rings libraries: - - http://groups.google.com/group/ooo-libs - -$Id$ diff --git a/README.md b/README.md new file mode 100644 index 00000000..48ef180f --- /dev/null +++ b/README.md @@ -0,0 +1,82 @@ +The Nenya library +================= + +The Nenya library provides various facilities for making networked multiplayer +games. Its various packages include: + +* geom, util - basic tools for doing data structure manipulation and some + geometry math +* resource - tools for bundling, deploying and managing media (images, + sounds, etc.) with a game +* media - a framework for doing "active" rendering in Java +* media.image - tools for loading, caching, manipulating and displaying images +* media.sound - tools for loading, caching, and playing audio +* media.animation, media.sprite - works in concert with the active + rendering system and provides tools for defining and manipulating + sprites (graphical entities that follow paths) and animations + (graphical entities that affect the display in other ways) +* miso - a framework for defining and displaying isometrically rendered scenes +* cast - a framework for defining and using recolorable, composited + characters with different poses and actions + +[Javadoc documentation](http://threerings.github.com/nenya/apidocs/) is provided. + +Tutorial style documentation is somewhat sparse at the moment, but inspection +of the code in the `src/test/java` directory shows examples of use of many +features of the library. + +Building +-------- + +The library is built using [Ant](http://ant.apache.org/). + +Invoke ant with any of the following targets: + + all: builds the distribution files and javadoc documentation + compile: builds only the class files (dist/classes) + javadoc: builds only the javadoc documentation (dist/docs) + dist: builds the distribution jar files (dist/*.jar) + +Artifacts +--------- + +A Maven repository containing released versions of the Nenya Java and +ActionScript artifacts are maintained here. To add a Nenya dependency to a +Maven project, add the following to your `pom.xml`: + + + + ooo-repo + http://threerings.github.com/maven-repo + + + + + com.threerings + nenya + 1.2 + + + +To add it to an Ivy, SBT, or other Maven repository using project, simply +remove the vast majority of the boilerplate above. + +If you prefer to download pre-built binaries, those can be had here: + +* [nenya-1.2.jar](http://threerings.github.com/nenya/maven/com/threerings/nenya/1.2/nenya-1.2.jar) +* [nenyalib-1.2.swc](http://threerings.github.com/nenya/maven/com/threerings/nenyalib/1.2/nenyalib-1.2.swc) + +Distribution +------------ + +The Nenya library is released under the LGPL. The most recent version of the +library is available at http://github.com/threerings/nenya/. + +Contact +------- + +Questions, comments, and other worldly endeavors can be handled via the [Three +Rings Libraries](http://groups.google.com/group/ooo-libs) Google Group. + +Nenya is actively developed by the scurvy dogs at +[Three Rings](http://www.threerings.net) Contributions are welcome.