-package com.threerings.util {
+package com.threerings.util
+{
 
-// A simple psuedo random number generator that allows seeding.
+/**
+ * A seedable pseudorandom generator of the Mersenne Twister variety, with an extremely
+ * long period. Note that this is not a cryptographically sound generator.
+ * This implementation is based on one found at --
+ *    http://onegame.bona.jp/tips/mersennetwister.html
+ * An explanation of the algorithm can be found at --
+ *    http://en.wikipedia.org/wiki/Mersenne_twister
+ */
 public class Random
 {
     /**

     */
    public function setSeed (seed :uint) :void
    {
        seed = uint(seed ^ multiplier);
    }

    /**

        if (seed == 0) {
            seed = uint(seedUniquifier++ + uint(Math.random() * 4294967295));
        }
        x = new Array();
        setSeed(seed);
    }

