Release candidate.
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index ff6480f..695368f 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,68 +1,41 @@
-              Apache Commons RNG 1.1 RELEASE NOTES
 
-The Apache Commons RNG team is pleased to announce the Apache Commons RNG 1.1 release!
+              Apache Commons RNG 1.2 RELEASE NOTES
+
+The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.2
 
 The Apache Commons RNG project provides pure-Java implementation of pseudo-random generators.
 
-This is a minor release of Apache Commons RNG, containing a
-few new features and performance improvements.
-
-Apache Commons RNG 1.1 contains the following library modules:
-  commons-rng-client-api (requires Java 6)
-  commons-rng-core (requires Java 6)
-  commons-rng-simple (requires Java 6)
-  commons-rng-sampling (requires Java 6)
-
-The code in module 'commons-rng-core' should not be accessed
-directly by applications as a future release might make use of
-the JPMS modularization feature available in Java 9+.
-
+This is a minor release of Apache Commons RNG, containing a few new features and performance improvements. Apache Commons RNG 1.2 contains the following library modules:
+ commons-rng-client-api (requires Java 6)
+ commons-rng-core (requires Java 6)
+ commons-rng-simple (requires Java 6)
+ commons-rng-sampling (requires Java 6) The code in module 'commons-rng-core' should not be accessed directly by applications as a future release might make use of the JPMS modularization feature available in Java 9+.
 Additional code is provided in the following module:
-  commons-rng-examples (requires Java 9)
-It is however not part of the official API and no compatibility
-should be expected in subsequent releases.
-
-We would like to also note that unit tests in module 'commons-rng-sampling'
-are bound to fail with some probability; this is expected due to the nature
-of random number generation.  The 'maven-surefire-plugin' can be configured
-to re-run tests that fail and pass the build if they succeed (the test will
-be marked as 'flaky' in the report).
+ commons-rng-examples (requires Java 9) It is however not part of the official API and no compatibility should be expected in subsequent releases.
+It must be noted that, due to the nature of random number generation, some of unit tests are bound to fail with some probability.
+The 'maven-surefire-plugin' is configured to re-run tests that fail, and pass the build if they succeed within the allotted number of reruns (the test will be marked as 'flaky' in the report).
 
 Changes in this version include:
 
 New features:
-o RNG-37:  Implementation of the "Ziggurat" algorithm for Gaussian sampling.
-o RNG-47:  "DiscreteProbabilityCollectionSampler": Sampling from a collection of items
-        with user-defined probabilities (feature ported from "Commons Math").
-o RNG-43:  "LogNormalSampler" with user-defined underlying "NormalizedGaussianSampler".
-o RNG-39:  "UnitSphereSampler": generate random vectors isotropically located
-        on the surface of a sphere (feature ported from "Commons Math").
-o RNG-36:  "MarsagliaNormalizedGaussianSampler": Faster variation of the
-        Box-Muller algorithm.
-        This version is used within "AhrensDieterMarsagliaTsangGammaSampler"
-        "MarsagliaLogNormalSampler" and "PoissonSampler" (generated sequences
-        will thus differ from those generated by version 1.0 of the library).
-o RNG-35:  New generic "GaussianSampler" based on "NormalizedGaussianSampler"
-        marker interface.
-        Implementation of "BoxMullerNormalizedGaussianSampler" deprecates
-        "BoxMullerGaussianSampler".
+o RNG-62:  New "CombinationSampler" class. Thanks to Alex D. Herbert. 
 
 Fixed Bugs:
-o RNG-53:  Class "SamplerBase" has been deprecated.  It was meant for internal use
-        only but, through inheritance, it allows incorrect usage of the sampler
-        classes.
+o RNG-59:  Use JDK's "SecureRandom" to seed the "SeedFactory". 
+o RNG-56:  "ZigguratNormalizedGaussianSampler": Missing statements in least used branch. 
+o RNG-55:  "UnitSphereSampler": Prevent returning NaN components and forbid
+        negative dimension. Thanks to Alex D. Herbert. 
 
 Changes:
-o RNG-50: "PoissonSampler": Algorithms for small mean and large mean have
-	    been separated into dedicated classes.  Cache precomputation has
-	    been disabled as it is only marginally used and is a performance
-	    hit for small sampling sets.Thanks to Alex D. Herbert.
-o RNG-42:  Use "ZigguratNormalizedGaussianSampler" within the library.
-o RNG-46:  Following RNG-43, "BoxMullerLogNormalSampler" has been deprecated.
-        Furthermore, its base class has been removed; although it is a binary
-        incompatibility, it cannot cause any problem that were not already
-        present in code using v1.0 of the library: Calls to the base class
-        would have raised a NPE.
+o RNG-63:  "NumberFactory": Some methods have become obsolete following RNG-57. 
+o RNG-64:  "PermutationSampler" and "CombinationSampler" shared code moved to a utility class. Thanks to Alex D. Herbert. 
+o RNG-61:  "PermutationSampler": Performance improvement. Thanks to Alex D. Herbert. 
+o RNG-57:  Cache for using up all the bits provided by the underlying source of randomness. Thanks to Alex D. Herbert. 
+o RNG-60:  Use random seeds for unit testing. 
+o RNG-52:  Set conservative upper bound in "LargePoissonSampler" to avoid truncation. 
+o RNG-58:  Allow part of RNG state to be contained in base classes, e.g. to enable
+        caching in common code (see RNG-57). 
+o RNG-51:  "PoissonSampler": Performance improvement. Thanks to Alex D. Herbert. 
 
 
 For complete information on Apache Commons RNG, including instructions on how to submit bug reports,
@@ -70,30 +43,4 @@
 
 http://commons.apache.org/proper/commons-rng/
 
------------------------------------------------------------------------------
 
-              Apache Commons RNG 1.0 RELEASE NOTES
-
-The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.0
-
-The Apache Commons RNG project provides pure-Java implementation of pseudo-random generators.
-
-This is the first release of Apache Commons RNG.
-Apache Commons RNG 1.0 contains the following modules:
- commons-rng-client-api (requires Java 6)
- commons-rng-core (requires Java 6)
- commons-rng-simple (requires Java 6)
- commons-rng-sampling (requires Java 6)
- commons-rng-jmh (requires Java 6)
- commons-rng-examples (requires Java 7)
-
-No changes defined in this version.
-
-For complete information on Apache Commons RNG, including instructions on how to submit bug reports,
-patches, or suggestions for improvement, see the Apache Commons RNG website:
-
-http://commons.apache.org/proper/commons-rng/
-
-
-Have fun!
--Apache Commons RNG team
\ No newline at end of file
diff --git a/commons-rng-client-api/src/site/site.xml b/commons-rng-client-api/src/site/site.xml
index 780bfef..ceb6307 100644
--- a/commons-rng-client-api/src/site/site.xml
+++ b/commons-rng-client-api/src/site/site.xml
@@ -27,6 +27,8 @@
       <item name="Overview" href="index.html"/>
       <item name="Latest API docs (development)"
             href="apidocs/index.html"/>
+      <item name="Javadoc (1.2 release)"
+            href="http://commons.apache.org/rng/commons-rng-client-api/javadocs/api-1.2/index.html"/>
       <item name="Javadoc (1.1 release)"
             href="http://commons.apache.org/rng/commons-rng-client-api/javadocs/api-1.1/index.html"/>
       <item name="Javadoc (1.0 release)"
diff --git a/commons-rng-core/src/site/site.xml b/commons-rng-core/src/site/site.xml
index 2585a37..9a05373 100644
--- a/commons-rng-core/src/site/site.xml
+++ b/commons-rng-core/src/site/site.xml
@@ -27,6 +27,8 @@
       <item name="Overview" href="index.html"/>
       <item name="Latest API docs (development)"
             href="apidocs/index.html"/>
+      <item name="Javadoc (1.2 release)"
+            href="http://commons.apache.org/rng/commons-rng-core/javadocs/api-1.2/index.html"/>
       <item name="Javadoc (1.1 release)"
             href="http://commons.apache.org/rng/commons-rng-core/javadocs/api-1.1/index.html"/>
       <item name="Javadoc (1.0 release)"
diff --git a/commons-rng-sampling/src/site/site.xml b/commons-rng-sampling/src/site/site.xml
index 16589a8..2d5321b 100644
--- a/commons-rng-sampling/src/site/site.xml
+++ b/commons-rng-sampling/src/site/site.xml
@@ -27,6 +27,8 @@
       <item name="Overview" href="index.html"/>
       <item name="Latest API docs (development)"
             href="apidocs/index.html"/>
+      <item name="Javadoc (1.2 release)"
+            href="http://commons.apache.org/rng/commons-rng-sampling/javadocs/api-1.2/index.html"/>
       <item name="Javadoc (1.1 release)"
             href="http://commons.apache.org/rng/commons-rng-sampling/javadocs/api-1.1/index.html"/>
       <item name="Javadoc (1.0 release)"
diff --git a/commons-rng-simple/src/site/site.xml b/commons-rng-simple/src/site/site.xml
index bce8bfd..c841d71 100644
--- a/commons-rng-simple/src/site/site.xml
+++ b/commons-rng-simple/src/site/site.xml
@@ -27,6 +27,8 @@
       <item name="Overview" href="index.html"/>
       <item name="Latest API docs (development)"
             href="apidocs/index.html"/>
+      <item name="Javadoc (1.2 release)"
+            href="http://commons.apache.org/rng/commons-rng-simple/javadocs/api-1.2/index.html"/>
       <item name="Javadoc (1.1 release)"
             href="http://commons.apache.org/rng/commons-rng-simple/javadocs/api-1.1/index.html"/>
       <item name="Javadoc (1.0 release)"
diff --git a/doc/release/release.howto.txt b/doc/release/release.howto.txt
index 8c7b9a6..177a9b4 100644
--- a/doc/release/release.howto.txt
+++ b/doc/release/release.howto.txt
@@ -189,7 +189,7 @@
 The "download" page template is located at "src/site/xdoc/download_rng.xml".
 This file is updated automatically by running the command:
 
-  $ mvn -Pcommons-rng-examples commons:download-page
+  $ mvn -Pcommons-rng-examples commons-build:download-page
 
 
 (7)
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 8ab64e3..3897949 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -51,7 +51,7 @@
   </properties>
   <body>
 
-    <release version="1.2" date="TBD" description="
+    <release version="1.2" date="2018-12-07" description="
 This is a minor release of Apache Commons RNG, containing a
 few new features and performance improvements.
 Apache Commons RNG 1.2 contains the following library modules:
diff --git a/src/site/xdoc/download_rng.xml b/src/site/xdoc/download_rng.xml
index 32e52bc..0c07721 100644
--- a/src/site/xdoc/download_rng.xml
+++ b/src/site/xdoc/download_rng.xml
@@ -102,7 +102,7 @@
         It is essential that you
         <a href="https://www.apache.org/info/verification.html">verify the integrity</a>
         of downloaded files, preferably using the <code>PGP</code> signature (<code>*.asc</code> files);
-        failing that using the <code>SHA256</code> hash (<code>*.SHA256</code> checksum files).
+        failing that using the <code>SHA1</code> hash (<code>*.sha1</code> checksum files).
       </p>
       <p>
         The <a href="https://www.apache.org/dist/commons/KEYS">KEYS</a>
@@ -111,32 +111,32 @@
       </p>
     </subsection>
     </section>
-    <section name="Apache Commons RNG 1.1 (requires Java 6+)">
+    <section name="Apache Commons RNG 1.2 (requires Java 6+)">
       <subsection name="Binaries">
         <table>
           <tr>
-              <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.1-bin.tar.gz">commons-rng-1.1-bin.tar.gz</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.1-bin.tar.gz.sha256">sha256</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.1-bin.tar.gz.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.2-bin.tar.gz">commons-rng-1.2-bin.tar.gz</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.2-bin.tar.gz.sha1">sha1</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.2-bin.tar.gz.asc">pgp</a></td>
           </tr>
           <tr>
-              <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.1-bin.zip">commons-rng-1.1-bin.zip</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.1-bin.zip.sha256">sha256</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.1-bin.zip.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.2-bin.zip">commons-rng-1.2-bin.zip</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.2-bin.zip.sha1">sha1</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.2-bin.zip.asc">pgp</a></td>
           </tr>
         </table>
       </subsection>
       <subsection name="Source">
         <table>
           <tr>
-              <td><a href="[preferred]/commons/rng/source/commons-rng-1.1-src.tar.gz">commons-rng-1.1-src.tar.gz</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.1-src.tar.gz.sha256">sha256</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.1-src.tar.gz.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/rng/source/commons-rng-1.2-src.tar.gz">commons-rng-1.2-src.tar.gz</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.2-src.tar.gz.sha1">sha1</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.2-src.tar.gz.asc">pgp</a></td>
           </tr>
           <tr>
-              <td><a href="[preferred]/commons/rng/source/commons-rng-1.1-src.zip">commons-rng-1.1-src.zip</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.1-src.zip.sha256">sha256</a></td>
-              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.1-src.zip.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/rng/source/commons-rng-1.2-src.zip">commons-rng-1.2-src.zip</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.2-src.zip.sha1">sha1</a></td>
+              <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.2-src.zip.asc">pgp</a></td>
           </tr>
         </table>
       </subsection>
diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml
index 0306cac..6a797ec 100644
--- a/src/site/xdoc/release-history.xml
+++ b/src/site/xdoc/release-history.xml
@@ -25,6 +25,9 @@
       <table>
         <tr><th>Version</th><th>Release date (YYYY-MM-DD)</th><th>Required Java Version</th><th>Release notes</th></tr>
         <tr>
+          <td>1.2</td><td>2018-12-07</td><td>6+</td><td><a href="release-notes/RELEASE-NOTES-1.2.txt">release notes for 1.2</a></td>
+        </tr>
+        <tr>
           <td>1.1</td><td>2018-08-14</td><td>6+</td><td><a href="release-notes/RELEASE-NOTES-1.1.txt">release notes for 1.1</a></td>
         </tr>
         <tr>
@@ -35,4 +38,4 @@
     </section>
     <!-- ================================================== -->
   </body>
-</document>
\ No newline at end of file
+</document>