commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From er...@apache.org
Subject [38/39] commons-rng git commit: Initial commit.
Date Sun, 07 Aug 2016 22:52:03 GMT
Initial commit.

Maven project setup.
Source code and unit tests (mostly copied from Commons Math "o.a.c.math4.rng" package).
Userguide (to be completed).


Project: http://git-wip-us.apache.org/repos/asf/commons-rng/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-rng/commit/c0495bf2
Tree: http://git-wip-us.apache.org/repos/asf/commons-rng/tree/c0495bf2
Diff: http://git-wip-us.apache.org/repos/asf/commons-rng/diff/c0495bf2

Branch: refs/heads/develop
Commit: c0495bf24168a6d5d06ede4d199c28bdd351ae86
Parents: 
Author: Gilles <erans@apache.org>
Authored: Sun Aug 7 23:44:22 2016 +0200
Committer: Gilles <erans@apache.org>
Committed: Sun Aug 7 23:44:22 2016 +0200

----------------------------------------------------------------------
 .gitignore                                      |   18 +
 CONTRIBUTING.md                                 |  102 +
 LICENSE.txt                                     |  457 +++
 NOTICE.txt                                      |    5 +
 README.md                                       |  103 +
 RELEASE-NOTES.txt                               |    0
 checkstyle.xml                                  |  202 +
 clirr-ignored.xml                               |   21 +
 doc/development/development.howto.txt           |   23 +
 doc/release/release.howto.txt                   |  540 +++
 doc/release/settings-security.xml               |   22 +
 doc/release/settings.xml                        |   62 +
 findbugs-exclude-filter.xml                     |   27 +
 license-header.txt                              |   16 +
 pmd-ruleset.xml                                 |   57 +
 pom.xml                                         |  520 +++
 siteMods/site.css                               |  126 +
 src/assembly/bin.xml                            |   48 +
 src/assembly/src.xml                            |   41 +
 src/changes/changes.xml                         |   67 +
 src/changes/release-notes.vm                    |  140 +
 .../org/apache/commons/rng/RandomSource.java    |  415 ++
 .../commons/rng/UniformRandomProvider.java      |  116 +
 .../commons/rng/internal/BaseProvider.java      |  186 +
 .../commons/rng/internal/ProviderBuilder.java   |  344 ++
 .../commons/rng/internal/StateSettable.java     |   47 +
 .../commons/rng/internal/package-info.java      |   51 +
 .../rng/internal/source32/AbstractWell.java     |  204 +
 .../rng/internal/source32/ISAACRandom.java      |  266 ++
 .../rng/internal/source32/IntProvider.java      |  130 +
 .../rng/internal/source32/JDKRandom.java        |   95 +
 .../rng/internal/source32/MersenneTwister.java  |  226 +
 .../rng/internal/source32/RandomIntSource.java  |   30 +
 .../rng/internal/source32/Well1024a.java        |   78 +
 .../rng/internal/source32/Well19937a.java       |   80 +
 .../rng/internal/source32/Well19937c.java       |   85 +
 .../rng/internal/source32/Well44497a.java       |   83 +
 .../rng/internal/source32/Well44497b.java       |   90 +
 .../commons/rng/internal/source32/Well512a.java |   78 +
 .../rng/internal/source32/package-info.java     |   52 +
 .../rng/internal/source64/LongProvider.java     |  134 +
 .../internal/source64/MersenneTwister64.java    |  197 +
 .../rng/internal/source64/RandomLongSource.java |   30 +
 .../rng/internal/source64/SplitMix64.java       |   75 +
 .../commons/rng/internal/source64/TwoCmres.java |  308 ++
 .../rng/internal/source64/XorShift1024Star.java |  105 +
 .../rng/internal/source64/package-info.java     |   52 +
 .../commons/rng/internal/util/Int2Long.java     |   37 +
 .../commons/rng/internal/util/IntArray2Int.java |   41 +
 .../rng/internal/util/IntArray2LongArray.java   |   44 +
 .../commons/rng/internal/util/Long2Int.java     |   36 +
 .../rng/internal/util/Long2IntArray.java        |   50 +
 .../rng/internal/util/Long2LongArray.java       |   56 +
 .../rng/internal/util/LongArray2IntArray.java   |   43 +
 .../rng/internal/util/LongArray2Long.java       |   41 +
 .../commons/rng/internal/util/LongMixInt.java   |   50 +
 .../commons/rng/internal/util/LongMixLong.java  |   56 +
 .../rng/internal/util/NoOpConverter.java        |   40 +
 .../rng/internal/util/NumberFactory.java        |  331 ++
 .../rng/internal/util/SeedConverter.java        |   35 +
 .../internal/util/SeedConverterComposer.java    |   56 +
 .../commons/rng/internal/util/SeedFactory.java  |  262 ++
 .../commons/rng/internal/util/package-info.java |   22 +
 .../org/apache/commons/rng/package-info.java    |   95 +
 src/site/apt/userguide/rng.apt                  |  244 ++
 src/site/resources/images/commons_rng.png       |  Bin 0 -> 79619 bytes
 src/site/resources/profile.jacoco               |   17 +
 src/site/resources/style/project.css            |   18 +
 .../txt/userguide/stress/dh/run_1/dh_1          |  146 +
 .../txt/userguide/stress/dh/run_1/dh_10         |  139 +
 .../txt/userguide/stress/dh/run_1/dh_11         |  148 +
 .../txt/userguide/stress/dh/run_1/dh_12         |  172 +
 .../txt/userguide/stress/dh/run_1/dh_13         |  168 +
 .../txt/userguide/stress/dh/run_1/dh_2          |  139 +
 .../txt/userguide/stress/dh/run_1/dh_3          |  173 +
 .../txt/userguide/stress/dh/run_1/dh_4          |  140 +
 .../txt/userguide/stress/dh/run_1/dh_5          |  140 +
 .../txt/userguide/stress/dh/run_1/dh_6          |  146 +
 .../txt/userguide/stress/dh/run_1/dh_7          |  204 +
 .../txt/userguide/stress/dh/run_1/dh_8          |  201 +
 .../txt/userguide/stress/dh/run_1/dh_9          |  143 +
 .../txt/userguide/stress/dh/run_2/dh_1          |  146 +
 .../txt/userguide/stress/dh/run_2/dh_10         |  172 +
 .../txt/userguide/stress/dh/run_2/dh_11         |  259 ++
 .../txt/userguide/stress/dh/run_2/dh_12         |  168 +
 .../txt/userguide/stress/dh/run_2/dh_13         |  261 ++
 .../txt/userguide/stress/dh/run_2/dh_2          |  140 +
 .../txt/userguide/stress/dh/run_2/dh_3          |  139 +
 .../txt/userguide/stress/dh/run_2/dh_4          |  171 +
 .../txt/userguide/stress/dh/run_2/dh_5          |  143 +
 .../txt/userguide/stress/dh/run_2/dh_6          |  260 ++
 .../txt/userguide/stress/dh/run_2/dh_7          |  143 +
 .../txt/userguide/stress/dh/run_2/dh_8          |  800 ++++
 .../txt/userguide/stress/dh/run_2/dh_9          |  175 +
 .../txt/userguide/stress/tu/run_1/tu_1          | 3882 ++++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_10         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_11         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_12         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_13         | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_2          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_3          | 3807 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_4          | 3806 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_5          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_6          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_7          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_8          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_9          | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_1          | 3879 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_10         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_11         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_12         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_13         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_2          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_3          | 3808 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_4          | 3805 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_5          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_6          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_7          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_8          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_9          | 3795 +++++++++++++++++
 src/site/site.xml                               |   54 +
 src/site/xdoc/developers.xml                    |  274 ++
 src/site/xdoc/download_rng.xml                  |  138 +
 src/site/xdoc/index.xml                         |   46 +
 src/site/xdoc/issue-tracking.xml                |  102 +
 src/site/xdoc/mail-lists.xml                    |  205 +
 src/site/xdoc/userguide/index.xml               |   61 +
 src/site/xdoc/userguide/xdoc.xsl                |   68 +
 .../commons/rng/Providers32ParametricTest.java  |   64 +
 .../commons/rng/Providers64ParametricTest.java  |   64 +
 .../rng/ProvidersCommonParametricTest.java      |  684 +++
 .../org/apache/commons/rng/ProvidersList.java   |  157 +
 .../rng/internal/source32/ISAACRandomTest.java  |  389 ++
 .../rng/internal/source32/JDKRandomTest.java    |   38 +
 .../internal/source32/MersenneTwisterTest.java  |  240 ++
 .../rng/internal/source32/Well1024aTest.java    |   71 +
 .../rng/internal/source32/Well19937aTest.java   |  109 +
 .../rng/internal/source32/Well19937cTest.java   |  109 +
 .../rng/internal/source32/Well44497aTest.java   |  109 +
 .../rng/internal/source32/Well44497bTest.java   |  109 +
 .../rng/internal/source32/Well512aTest.java     |   69 +
 .../source64/MersenneTwister64Test.java         |  239 ++
 .../rng/internal/source64/SplitMix64Test.java   |   45 +
 .../rng/internal/source64/TwoCmresTest.java     |   53 +
 .../internal/source64/XorShift1024StarTest.java |   55 +
 .../rng/internal/util/NumberFactoryTest.java    |  162 +
 .../rng/internal/util/SeedFactoryTest.java      |  111 +
 src/userguide/README                            |   21 +
 src/userguide/c/rng/stdin2testu01.c             |  127 +
 .../commons/rng/userguide/GeneratorsList.java   |   57 +
 .../RandomNumberGeneratorBenchmark.java         |  287 ++
 .../rng/userguide/RandomStressTester.java       |  280 ++
 .../rng/userguide/TwoCmresGeneratorsList.java   |   55 +
 src/userguide/pom.xml                           |  127 +
 154 files changed, 116552 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/.gitignore
----------------------------------------------------------------------
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..46859ad
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,18 @@
+.classpath
+.project
+.settings
+.checkstyle
+bin
+target
+/build
+/lib
+/site-content
+.ekstazi
+*.class
+*.iml
+*.ipr
+*.iws
+.idea
+*~
+/.externalToolBuilders/
+/maven-eclipse.xml

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/CONTRIBUTING.md
----------------------------------------------------------------------
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..9b4bb5a
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,102 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!---
+ +======================================================================+
+ |****                                                              ****|
+ |****      THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN      ****|
+ |****                    DO NOT EDIT DIRECTLY                      ****|
+ |****                                                              ****|
+ +======================================================================+
+ | TEMPLATE FILE: contributing-md-template.md                           |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ |                                                                      |
+ | 1) Re-generate using: mvn commons:contributing-md                    |
+ |                                                                      |
+ | 2) Set the following properties in the component's pom:              |
+ |    - commons.jira.id  (required, alphabetic, upper case)             |
+ |                                                                      |
+ | 3) Example Properties                                                |
+ |                                                                      |
+ |  <properties>                                                        |
+ |    <commons.jira.id>RNG</commons.jira.id>                           |
+ |  </properties>                                                       |
+ |                                                                      |
+ +======================================================================+
+--->
+Contributing to Apache Commons Rng
+======================
+
+You have found a bug or you have an idea for a cool new feature? Contributing code is a great way to give something back to
+the open source community. Before you dig right into the code there are a few guidelines that we need contributors to
+follow so that we can have a chance of keeping on top of things.
+
+Getting Started
+---------------
+
++ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
++ Make sure you have a [GitHub account](https://github.com/signup/free).
++ If you're planning to implement a new feature it makes sense to discuss you're changes on the [dev list](https://commons.apache.org/mail-lists.html) first. This way you can make sure you're not wasting your time on something that isn't considered to be in Apache Commons Rng's scope.
++ Submit a ticket for your issue, assuming one does not already exist.
+  + Clearly describe the issue including steps to reproduce when it is a bug.
+  + Make sure you fill in the earliest version that you know has the issue.
++ Fork the repository on GitHub.
+
+Making Changes
+--------------
+
++ Create a topic branch from where you want to base your work (this is usually the develop/trunk branch).
++ Make commits of logical units.
++ Respect the original code style:
+  + Only use spaces for indentation.
+  + Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
+  + Check for unnecessary whitespace with git diff --check before committing.
++ Topic branch names should directly correspond to the JIRA issues they are intended to resolve. For example branch names should look like:
+  + `improvement-RNG-852`
+  + `bug-RNG-1329`
+  + `feature-RNG-621`
++ Make sure your commit messages are in the proper format. Your commit message should contain the key of the JIRA issue.
+  + For example, a commit message might look like `RNG-852: Adding documentation for development`
++ Make sure you have added the necessary tests for your changes.
++ Run all the tests with `mvn clean verify` to assure nothing else was accidentally broken.
+
+Making Trivial Changes
+----------------------
+
+For changes of a trivial nature to comments and documentation, it is not always necessary to create a new ticket in JIRA.
+In this case, it is appropriate to start the first line of a commit with '(doc)' instead of a ticket number.
+
+Submitting Changes
+------------------
+
++ Sign the [Contributor License Agreement][cla] if you haven't already.
++ Push your changes to a topic branch in your fork of the repository.
++ Submit a pull request to the repository in the apache organization.
++ Update your JIRA ticket and include a link to the pull request in the ticket.
+
+Additional Resources
+--------------------
+
++ [Contributing patches](https://commons.apache.org/patches.html)
++ [Apache Commons Rng JIRA project page](https://issues.apache.org/jira/browse/RNG)
++ [Contributor License Agreement][cla]
++ [General GitHub documentation](https://help.github.com/)
++ [GitHub pull request documentation](https://help.github.com/send-pull-requests/)
++ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
++ #apachecommons IRC channel on freenode.org
+
+[cla]:https://www.apache.org/licenses/#clas

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/LICENSE.txt
----------------------------------------------------------------------
diff --git a/LICENSE.txt b/LICENSE.txt
new file mode 100644
index 0000000..d97b49a
--- /dev/null
+++ b/LICENSE.txt
@@ -0,0 +1,457 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+
+Apache Commons Math includes the following code provided to the ASF under the
+Apache License 2.0:
+
+ - The inverse error function implementation in the Erf class is based on CUDA
+   code developed by Mike Giles, Oxford-Man Institute of Quantitative Finance,
+   and published in GPU Computing Gems, volume 2, 2010 (grant received on
+   March 23th 2013)
+ - The LinearConstraint, LinearObjectiveFunction, LinearOptimizer,
+   RelationShip, SimplexSolver and SimplexTableau classes in package
+   org.apache.commons.math3.optimization.linear include software developed by
+   Benjamin McCann (http://www.benmccann.com) and distributed with
+   the following copyright: Copyright 2009 Google Inc. (grant received on
+   March 16th 2009)
+ - The class "org.apache.commons.math3.exception.util.LocalizedFormatsTest" which
+   is an adapted version of "OrekitMessagesTest" test class for the Orekit library
+ - The "org.apache.commons.math3.analysis.interpolation.HermiteInterpolator"
+   has been imported from the Orekit space flight dynamics library.
+
+===============================================================================
+ 
+
+
+APACHE COMMONS MATH DERIVATIVE WORKS: 
+
+The Apache commons-math library includes a number of subcomponents
+whose implementation is derived from original sources written
+in C or Fortran.  License terms of the original sources
+are reproduced below.
+
+===============================================================================
+For the lmder, lmpar and qrsolv Fortran routine from minpack and translated in
+the LevenbergMarquardtOptimizer class in package
+org.apache.commons.math3.optimization.general 
+Original source copyright and license statement:
+
+Minpack Copyright Notice (1999) University of Chicago.  All rights reserved
+
+Redistribution and use in source and binary forms, with or
+without modification, are permitted provided that the
+following conditions are met:
+
+1. Redistributions of source code must retain the above
+copyright notice, this list of conditions and the following
+disclaimer.
+
+2. Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following
+disclaimer in the documentation and/or other materials
+provided with the distribution.
+
+3. The end-user documentation included with the
+redistribution, if any, must include the following
+acknowledgment:
+
+   "This product includes software developed by the
+   University of Chicago, as Operator of Argonne National
+   Laboratory.
+
+Alternately, this acknowledgment may appear in the software
+itself, if and wherever such third-party acknowledgments
+normally appear.
+
+4. WARRANTY DISCLAIMER. THE SOFTWARE IS SUPPLIED "AS IS"
+WITHOUT WARRANTY OF ANY KIND. THE COPYRIGHT HOLDER, THE
+UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, AND
+THEIR EMPLOYEES: (1) DISCLAIM ANY WARRANTIES, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE
+OR NON-INFRINGEMENT, (2) DO NOT ASSUME ANY LEGAL LIABILITY
+OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS, OR
+USEFULNESS OF THE SOFTWARE, (3) DO NOT REPRESENT THAT USE OF
+THE SOFTWARE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS, (4)
+DO NOT WARRANT THAT THE SOFTWARE WILL FUNCTION
+UNINTERRUPTED, THAT IT IS ERROR-FREE OR THAT ANY ERRORS WILL
+BE CORRECTED.
+
+5. LIMITATION OF LIABILITY. IN NO EVENT WILL THE COPYRIGHT
+HOLDER, THE UNITED STATES, THE UNITED STATES DEPARTMENT OF
+ENERGY, OR THEIR EMPLOYEES: BE LIABLE FOR ANY INDIRECT,
+INCIDENTAL, CONSEQUENTIAL, SPECIAL OR PUNITIVE DAMAGES OF
+ANY KIND OR NATURE, INCLUDING BUT NOT LIMITED TO LOSS OF
+PROFITS OR LOSS OF DATA, FOR ANY REASON WHATSOEVER, WHETHER
+SUCH LIABILITY IS ASSERTED ON THE BASIS OF CONTRACT, TORT
+(INCLUDING NEGLIGENCE OR STRICT LIABILITY), OR OTHERWISE,
+EVEN IF ANY OF SAID PARTIES HAS BEEN WARNED OF THE
+POSSIBILITY OF SUCH LOSS OR DAMAGES.
+===============================================================================
+
+Copyright and license statement for the odex Fortran routine developed by
+E. Hairer and G. Wanner and translated in GraggBulirschStoerIntegrator class
+in package org.apache.commons.math3.ode.nonstiff:
+
+
+Copyright (c) 2004, Ernst Hairer
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are 
+met:
+
+- Redistributions of source code must retain the above copyright 
+notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in the 
+documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR 
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+===============================================================================
+
+Copyright and license statement for the original Mersenne twister C
+routines translated in MersenneTwister class in package 
+org.apache.commons.math3.random:
+
+   Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura,
+   All rights reserved.                          
+
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+     1. Redistributions of source code must retain the above copyright
+        notice, this list of conditions and the following disclaimer.
+
+     2. Redistributions in binary form must reproduce the above copyright
+        notice, this list of conditions and the following disclaimer in the
+        documentation and/or other materials provided with the distribution.
+
+     3. The names of its contributors may not be used to endorse or promote 
+        products derived from this software without specific prior written 
+        permission.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+===============================================================================
+
+The initial code for shuffling an array (originally in class
+"org.apache.commons.math3.random.RandomDataGenerator", now replaced by
+a method in class "org.apache.commons.math3.util.MathArrays") was
+inspired from the algorithm description provided in
+"Algorithms", by Ian Craw and John Pulham (University of Aberdeen 1999).
+The textbook (containing a proof that the shuffle is uniformly random) is
+available here:
+  http://citeseerx.ist.psu.edu/viewdoc/download;?doi=10.1.1.173.1898&rep=rep1&type=pdf
+
+===============================================================================
+License statement for the direction numbers in the resource files for Sobol sequences.
+
+-----------------------------------------------------------------------------
+Licence pertaining to sobol.cc and the accompanying sets of direction numbers
+
+-----------------------------------------------------------------------------
+Copyright (c) 2008, Frances Y. Kuo and Stephen Joe
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the names of the copyright holders nor the names of the
+      University of New South Wales and the University of Waikato
+      and its contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+===============================================================================
+
+The initial commit of package "org.apache.commons.math3.ml.neuralnet" is
+an adapted version of code developed in the context of the Data Processing
+and Analysis Consortium (DPAC) of the "Gaia" project of the European Space
+Agency (ESA).
+===============================================================================
+
+The initial commit of the class "org.apache.commons.math3.special.BesselJ" is
+an adapted version of code translated from the netlib Fortran program, rjbesl
+http://www.netlib.org/specfun/rjbesl by R.J. Cody at Argonne National
+Laboratory (USA).  There is no license or copyright statement included with the
+original Fortran sources.
+===============================================================================
+
+
+The BracketFinder (package org.apache.commons.math3.optimization.univariate)
+and PowellOptimizer (package org.apache.commons.math3.optimization.general)
+classes are based on the Python code in module "optimize.py" (version 0.5)
+developed by Travis E. Oliphant for the SciPy library (http://www.scipy.org/)
+Copyright © 2003-2009 SciPy Developers.
+
+SciPy license
+Copyright © 2001, 2002 Enthought, Inc.
+All rights reserved.
+
+Copyright © 2003-2013 SciPy Developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the name of Enthought nor the names of the SciPy Developers may
+      be used to endorse or promote products derived from this software without
+      specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+===============================================================================
+

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/NOTICE.txt
----------------------------------------------------------------------
diff --git a/NOTICE.txt b/NOTICE.txt
new file mode 100644
index 0000000..993aa60
--- /dev/null
+++ b/NOTICE.txt
@@ -0,0 +1,5 @@
+Apache Commons Rng
+Copyright 2001-2016 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1134024
--- /dev/null
+++ b/README.md
@@ -0,0 +1,103 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!---
+ +======================================================================+
+ |****                                                              ****|
+ |****      THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN      ****|
+ |****                    DO NOT EDIT DIRECTLY                      ****|
+ |****                                                              ****|
+ +======================================================================+
+ | TEMPLATE FILE: readme-md-template.md                                 |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ |                                                                      |
+ | 1) Re-generate using: mvn commons:readme-md                          |
+ |                                                                      |
+ | 2) Set the following properties in the component's pom:              |
+ |    - commons.componentid (required, alphabetic, lower case)          |
+ |    - commons.release.version (required)                              |
+ |                                                                      |
+ | 3) Example Properties                                                |
+ |                                                                      |
+ |  <properties>                                                        |
+ |    <commons.componentid>rng</commons.componentid>                    |
+ |    <commons.release.version>1.0</commons.release.version>            |
+ |  </properties>                                                       |
+ |                                                                      |
+ +======================================================================+
+--->
+Apache Commons Rng
+===================
+
+[![Build Status](https://travis-ci.org/apache/commons-rng.svg?branch=master)](https://travis-ci.org/apache/commons-rng)
+[![Coverage Status](https://coveralls.io/repos/apache/commons-rng/badge.svg?branch=master&service=github)](https://coveralls.io/github/apache/commons-rng?branch=master)
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-rng/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-rng/)
+[![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+The Apache Commons Rng project provides Java implementations of pseudo-random numbers generators.
+
+Documentation
+-------------
+
+More information can be found on the [homepage](https://commons.apache.org/proper/commons-rng).
+The [JavaDoc](https://commons.apache.org/proper/commons-rng/apidocs) can be browsed.
+Questions related to the usage of Apache Commons Rng should be posted to the [user mailing list][ml].
+
+Where can I get the latest release?
+-----------------------------------
+You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-rng/download_rng.cgi).
+
+Alternatively you can pull it from the central Maven repositories:
+
+```xml
+<dependency>
+  <groupId>org.apache.commons</groupId>
+  <artifactId>commons-rng</artifactId>
+  <version>1.0</version>
+</dependency>
+```
+
+Contributing
+------------
+
+We accept PRs via github. The [developer mailing list][ml] is the main channel of communication for contributors.
+There are some guidelines which will make applying PRs easier for us:
++ No tabs! Please use spaces for indentation.
++ Respect the code style.
++ Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
++ Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running ```mvn clean test```.
+
+If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).
+You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).
+
+License
+-------
+Code is under the [Apache Licence v2](https://www.apache.org/licenses/LICENSE-2.0.txt).
+
+Donations
+---------
+You like Apache Commons Rng? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support the development.
+
+Additional Resources
+--------------------
+
++ [Apache Commons Homepage](https://commons.apache.org/)
++ [Apache Bugtracker (JIRA)](https://issues.apache.org/jira/)
++ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
++ #apachecommons IRC channel on freenode.org
+
+[ml]:https://commons.apache.org/mail-lists.html

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/RELEASE-NOTES.txt
----------------------------------------------------------------------
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
new file mode 100644
index 0000000..e69de29

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/checkstyle.xml
----------------------------------------------------------------------
diff --git a/checkstyle.xml b/checkstyle.xml
new file mode 100644
index 0000000..6582428
--- /dev/null
+++ b/checkstyle.xml
@@ -0,0 +1,202 @@
+<?xml version="1.0"?>
+
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+  -->
+
+<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.1//EN" "http://www.puppycrawl.com/dtds/configuration_1_1.dtd">
+
+<!-- Commons Rng customization of default Checkstyle behavior -->
+<module name="Checker">
+  <property name="localeLanguage" value="en"/>
+
+  <module name="TreeWalker">
+
+    <!-- Operator must be at end of wrapped line -->
+    <module name="OperatorWrap">
+      <property name="option" value="eol"/>
+    </module>
+
+    <!-- No if/else/do/for/while without braces -->
+    <module name="NeedBraces"/>
+
+    <!-- Interfaces must be types (not just constants) -->
+    <module name="InterfaceIsType"/>
+
+    <!-- Must have class / interface header comments -->
+    <module name="JavadocType"/>
+        
+     <!-- Require method javadocs, allow undeclared RTE -->
+    <module name="JavadocMethod">
+      <property name="allowUndeclaredRTE" value="true"/>
+      <property name="allowThrowsTagsForSubclasses" value="true"/>
+      <property name="validateThrows" value="false"/>
+    </module>
+
+    <!-- Require field javadoc -->
+    <module name="JavadocVariable"/>
+        
+    <!-- No public fields -->
+    <module name="VisibilityModifier">
+       <property name="protectedAllowed" value="true"/>
+    </module>
+
+    <!-- Require hash code override when equals is -->
+    <module name="EqualsHashCode"/>
+    
+    <!-- Disallow unnecessary instantiation of Boolean, String -->
+    <module name="IllegalInstantiation">
+      <property name="classes" value="java.lang.Boolean, java.lang.String"/>
+    </module>
+
+    <!-- Required for SuppressionCommentFilter below -->
+    <module name="FileContentsHolder"/>
+ 
+    <!--  Import should be explicit, really needed and only from pure java packages -->
+    <module name="AvoidStarImport" />
+    <module name="UnusedImports" />
+    <module name="IllegalImport" />
+
+    <!-- Utility class should not be instantiated, they must have a private constructor -->
+    <module name="HideUtilityClassConstructor" />
+
+    <!-- Switch statements should be complete and with independent cases -->
+    <module name="FallThrough" />
+    <module name="MissingSwitchDefault" />
+
+    <!-- Constant names should obey the traditional all uppercase naming convention -->
+    <module name="ConstantName" />
+
+    <!-- Method parameters and local variables should not hide fields, except in constructors and setters -->
+    <module name="HiddenField">
+        <property name="ignoreConstructorParameter" value="true" />
+        <property name="ignoreSetter" value="true" />
+    </module>
+    
+    <!-- No trailing whitespace -->
+    <module name="Regexp">
+      <property name="format" value="[ \t]+$"/>
+      <property name="illegalPattern" value="true"/>
+      <property name="message" value="Trailing whitespace"/>
+    </module>
+    
+    <!-- No System.out.println() statements -->
+    <module name="Regexp">
+      <!-- no sysouts -->
+      <property name="format" value="System\.out\.println"/>
+      <property name="illegalPattern" value="true"/>
+    </module>
+
+    <!-- Authors should be in pom.xml file -->
+    <module name="Regexp">
+      <property name="format" value="@author"/>
+      <property name="illegalPattern" value="true"/>
+      <property name="message" value="developers names should be in pom file"/>
+    </module>
+
+    <!-- Use a consistent way to put modifiers -->
+    <module name="RedundantModifier" />
+    <module name="ModifierOrder" />
+
+    <!-- Use a consistent way to put declarations -->
+    <module name="DeclarationOrder" />
+
+    <!-- Don't add up parentheses when they are not required -->
+    <module name="UnnecessaryParentheses" />
+
+    <!--  Don't use too widespread catch (Exception, Throwable, RuntimeException)  -->
+    <module name="IllegalCatch" />
+
+    <!-- Don't use = or != for string comparisons -->
+    <module name="StringLiteralEquality" />
+ 
+   <!-- Don't declare multiple variables in the same statement -->
+    <module name="MultipleVariableDeclarations" />
+
+    <!-- String literals more than one character long should not be repeated several times -->
+    <!-- the "unchecked" string is also accepted to allow @SuppressWarnings("unchecked") -->
+    <module name="MultipleStringLiterals" >
+      <property name="ignoreStringsRegexp" value='^(("")|(".")|("unchecked"))$'/>
+    </module>
+
+    <!-- Check if @Override tags are present  -->
+    <module name="MissingOverride" />
+
+    <!-- <module name="TodoComment" /> -->
+
+  </module>
+
+  <!-- Verify that EVERY source file has the appropriate license -->
+  <module name="Header">
+    <property name="headerFile" value="${checkstyle.header.file}"/>
+  </module>
+
+  <!-- No tabs allowed! -->
+  <module name="FileTabCharacter"/>
+
+  <!-- Require files to end with newline characters -->
+  <module name="NewlineAtEndOfFile"/>
+  
+  <!-- Require package javadoc -->
+  <module name="JavadocPackage"/>
+
+  <!-- Setup special comments to suppress specific checks from source files -->
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop JavadocVariable"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume JavadocVariable"/>
+    <property name="checkFormat"      value="JavadocVariable"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop JavadocMethodCheck"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume JavadocMethodCheck"/>
+    <property name="checkFormat"      value="JavadocMethodCheck"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop ConstantName"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume ConstantName"/>
+    <property name="checkFormat"      value="ConstantName"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop HideUtilityClassConstructor"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume HideUtilityClassConstructor"/>
+    <property name="checkFormat"      value="HideUtilityClassConstructor"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop MultipleVariableDeclarations"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume MultipleVariableDeclarations"/>
+    <property name="checkFormat"      value="MultipleVariableDeclarations"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop IllegalCatch"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume IllegalCatch"/>
+    <property name="checkFormat"      value="IllegalCatch"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop DeclarationOrder"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume DeclarationOrder"/>
+    <property name="checkFormat"      value="DeclarationOrder"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop RedundantModifier"/>
+    <property name="onCommentFormat"  value="CHECKSTYLE\: resume RedundantModifier"/>
+    <property name="checkFormat"      value="RedundantModifier"/>
+  </module>
+  <module name="SuppressionCommentFilter">
+    <property name="offCommentFormat" value="CHECKSTYLE\: stop all"/>
+    <property name="onCommentFormat" value="CHECKSTYLE\: resume all"/>
+  </module>
+</module>
+

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/clirr-ignored.xml
----------------------------------------------------------------------
diff --git a/clirr-ignored.xml b/clirr-ignored.xml
new file mode 100644
index 0000000..ed97259
--- /dev/null
+++ b/clirr-ignored.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<differences>
+
+</differences>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/doc/development/development.howto.txt
----------------------------------------------------------------------
diff --git a/doc/development/development.howto.txt b/doc/development/development.howto.txt
new file mode 100644
index 0000000..6fcdfe3
--- /dev/null
+++ b/doc/development/development.howto.txt
@@ -0,0 +1,23 @@
+This document summarizes a discussion that took place on the "dev" ML:
+  http://markmail.org/message/7lnus64entdwj4vo
+
+The conclusions reported here are based on ideas presented in this blog post:
+  http://nvie.com/posts/a-successful-git-branching-model/
+
+1. The "master" branch can only contain released code; i.e. the only
+   accepted commits are the result of a merge from the "release" branch
+   (from a release candidate that passed a vote).
+2. Contents that is candidate for being released must be merged into the
+   "release" branch, from the "develop" branch.
+3. The "develop" branch collects all modifications that will be part
+   of the next release.
+   Usually, changes should not be committed directly to the "develop"
+   branch; they should be merged from a branch specifically created for
+   that purpose (see next point).
+4. Work on an identified issue (bug fix or new feature) must be done in a
+   new branch named after its corresponding report in the bug-tracking
+   system (JIRA), e.g. "feature-RNG-123".
+   After completion, and in the absence of technical objections, the feature
+   branch is merged into the "develop" branch, using the "--no-ff" git
+   option.
+   That feature branch is then deleted.

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/doc/release/release.howto.txt
----------------------------------------------------------------------
diff --git a/doc/release/release.howto.txt b/doc/release/release.howto.txt
new file mode 100644
index 0000000..fcc314b
--- /dev/null
+++ b/doc/release/release.howto.txt
@@ -0,0 +1,540 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+This document is meant as a step-by-step recipe to achieve the release of
+the Commons Rng component. Note that more general instructions valid
+for all components, including [rng], are available on the Apache Commons
+main site: at "http://commons.apache.org/releases/prepare.html" and
+"http://commons.apache.org/releases/release.html".
+
+The files "settings-security.xml" and "settings.xml" are minimal examples
+of files used by maven to pick up authentication credentials needed to
+connect to remote servers and to cryptographically sign the artifacts.
+
+Since [rng] has switched to git as its version control system, release preparation
+can be done easily on the release manager local host in a branch. As branches deletion
+is now forbidden at Apache, we will use a specific release branch for every version.
+The branch will be simply named X.Y-release, with X.Y being the version number.
+The branch will be used to store the release specific parts (i.e. the pom changes with
+the version number, the release date in the site and so on). Everything else and in
+particular code change that will remain in the component after the release must be
+committed to the master branch (or version branch). The release candidate branch will
+be created from master or version branch at the start of each new candidate for
+this particular release. Once the release is done, the branch will be merged back to
+master, but it will never be deleted so release history will be preserved.
+
+The example below show a typical workflow. Just after commit A in the master branch, the
+X.Y-release branch is created starting from master. This is shown by the 'b' in the
+second line. Then release specific commits are made on the pom and a few other
+files, leading to a commit which will be tagged as RC1. This release candidate fails, and
+a few corrections need to be made on master, corresponding to commits B and C. Then the
+X.Y-release branch is synchronized by running a 'git merge' command on the branch.
+This is shown by the 'm' in the second line. A new commit is tagged as RC2. This second
+release candidate also fails, and a new correction is made on master branch, a new merge
+is done on the X.Y-release branch, a new commit is tagged and a third release candidate is
+create, which succeeds. Then a final tag will be added on the final commit of this branch
+showing the status as released. Then the files are cleaned to prepare for next version
+(pom getting again a SNAPSHOT suffix, changes.xml getting a new placeholder for changes)
+and the cleaned branch is merged back to master. Once the X.Y-release branch has been merged,
+it is kept for history. The release for next version will use another specific branch.
+
+
+ ----A-------> B --> C----------> D--------------------------------------m---->    <- master branch
+      \               \            \                                    /
+       b---> RC1 ------m---> RC2 ---m---> RC3/final release --> cleaning --X       <- X.Y-release branch
+
+This process allows:
+
+ - to never commit release candidate specific changes to the master
+   branch (so the pom on master always holds a SNAPSHOT version),
+ - to preserve future reference to the release
+ - to allow parallel work on master during the release
+ - if necessary to have multiple release managers or help on the
+   release as the X.Y-release branch is shared
+
+
+(0)
+Preliminary checks:
+ * All Java files must contain a license header. The "RAT" maven plugin will
+   generate a report indicating for which files the license is missing.
+ * For a "minor" release, the library must be backward-compatible. Check all
+   the errors reported by the "Clirr" plugin.
+ * Clear all "CheckStyle" warnings.
+ * Make sure that the construct reported by "FindBugs" are intentional.
+ * Mark all fixed issues as such in the bug-tracking system, and add a
+   corresponding entry in "src/changes/changes.xml".
+
+
+(1)
+As a first optional step, you can test that everything works locally, i.e.
+that the build process can create all the necessary artifacts. The command
+
+  $ mvn clean deploy -Prelease -Ptest-deploy
+
+should create the artifacts in the "target/deploy".
+
+
+(2)
+At this point, you will work mainly on the X.Y-release branch.
+
+If the X.Y-release branch does not exist because it is the first release
+candidate, create it locally starting from the master branch or the version
+branch and push it to Apache repository (assuming it is called origin),
+remembering the binding between the local and remote origin branches:
+
+  $ git branch X.Y-release
+  $ git push -u origin X.Y-release
+
+(3)
+Switch to the release branch:
+
+  $ git checkout X.Y-release
+
+
+(4)
+If there have been changes committed in the master branch or the version
+branch since the creation of the release branch, there are two cases:
+
+  (4a)
+  if all these changes must be included in the X.Y-release
+  merge master branch or version branch into X.Y-release branch:
+
+  $ git merge master
+  or, if the version branch is called RNG_3_X
+  $ git merge RNG_3_X
+
+  (4b)
+  if only part of these changes must be included in the X.Y-release,
+  cherry-pick the required commits into X.Y-release branch:
+
+  $ git cherry-pick commit-SHA
+
+(5)
+Update the release specific files, checking you are really working on the
+X.Y-release branch and *not* on the master branch.
+
+In particular:
+ * Update and commit the "src/site/site.xml" file to contain the information
+   about the API docs of the new release.
+ * Estimate a release date (taking into account the release vote delay) and
+   insert it in the "src/changes/changes.xml" file.
+ * Update the "pom.xml" to contain the final version number and not a SNAPSHOT:
+   Assuming that the release version will be "1.0", modify the "<version>" tag to
+   read:
+
+    <version>1.0</version>
+
+   Modify the section of "<properties>" that also refers to version numbers.
+   You should uncomment the "<commons.rc.version>" line and indicate the
+   appropriate numbering of the release candidate: This refers to how many
+   times you will need to repeat this whole release process until it is
+   accepted (by a vote):
+
+  <properties>
+    <!-- ... -->
+    <commons.release.version>1.0</commons.release.version>
+    <commons.rc.version>RC1</commons.rc.version>
+    <!-- ... -->
+  </properties>
+
+
+(6)
+The "download" page template is located at "src/site/xdoc/download_rng.xml".
+This file is updated automatically by running the command:
+
+  $ mvn commons:download-page
+
+
+(7)
+The "release notes" file will be created by gathering all the changes
+collected during development in the file "src/changes/changes.xml".
+Create it by running:
+
+  $ mvn -Prelease-notes changes:announcement-generate
+
+Check the file for weird line breaks, and commit the updated file to git:
+
+  $ git add src/site/site.xml \
+            src/changes/changes.xml \
+            pom.xml \
+            src/site/xdoc/download_rng.xml \
+            RELEASE-NOTES.txt
+
+Check you did not forget any file:
+
+  $ git status
+
+Commit the changes:
+  $ git commit -m "creating release candidate"
+
+
+(8)
+Create a GPG signed tag that will contain the whole source of this release candidate.
+First, make sure once again that the workspace is up-to-date:
+
+  $ git status
+
+Then, assuming the first candidate, the suffix will be "RC1" (this should
+be the  same as in the "<properties>" in the "pom.xml"), and the command
+will be:
+
+  $ git tag -s -m "Creating Apache Commons Rng v1.0 RC1 tag." RNG_3_4_RC1
+
+If you have several GPG keys, you may prefer to use "-u keyId" to select a specific
+key for signing the tag instead of "-s" which select automatically one key
+from the configured e-mail address.
+
+Check the tag GPG signature:
+
+  $ git tag -v RNG_3_4_RC1
+
+You will get something like:
+
+  object cf4a9d70c9ac24dd7196995390171150e4e56451
+  type commit
+  tag RNG_3_4_RC1
+  tagger Luc Maisonobe <luc@apache.org> 1418934614 +0100
+
+  Creating Apache Commons Rng v1.0 RC1 tag.
+  gpg: Signature made Thu Dec 18 21:30:14 2014 CET using RSA key ID 02E9F65B
+  gpg: Good signature from "Luc Maisonobe (CODE SIGNING KEY) <luc@apache.org>"
+  gpg:                 aka "Luc Maisonobe <Luc.Maisonobe@c-s.fr>"
+  gpg:                 aka "Luc Maisonobe <Luc.Maisonobe@free.fr>"
+  gpg:                 aka "Luc Maisonobe <luc@orekit.org>"
+
+Remember the commit ID listed in the object line (here cf4a9d70c9ac24dd7196995390171150e4e56451),
+as it is the most stable reference for traceability.
+
+Push everything (including the tag!) on the Apache repository:
+
+  $ git push --tags
+
+(9)
+Switch to a new directory out of your regular workspace, and retrieve
+the official tag from the Apache repository:
+
+  $ cd /tmp
+  $ git clone https://git-wip-us.apache.org/repos/asf/commons-rng.git --branch RNG_3_4_RC1
+
+In the command above, the --branch option accepts both branch names and tags names,
+so we specify directly the tag here. Git will warn that the resulting workspace
+is in 'detached HEAD' state and 'git status' commands will warn that you are not
+currently on any branch. This is expected is this situation.
+
+Check that the last commit has the id you noted in the previous step:
+
+  $ git log -1
+
+(10)
+If this is your first release, you might need to add your GPG encryption
+key to the KEYS file. [If you have already done so, skip this section.]
+
+Retrieve the files from the SVN repository:
+
+  $ svn co --depth=immediates \
+    https://__Your_apache_login__@svn.apache.org/repos/asf/commons/trunks-proper
+
+and follow the instructions at the top of the "KEYS" file.
+
+
+(11)
+Create and transfer the artifacts to the Nexus server (a.k.a. "deploy").
+
+Because the artifacts must be cryptographically signed, this step requires that
+a profile named "release" exists in the maven "settings.xml" configuration file
+which will contain the identifier of your GPG key (cf. sample "settings.xml" 
+file). You will also have to follow the instructions at
+https://maven.apache.org/guides/mini/guide-encryption.html to set your password
+in the settings.xml file.
+
+You can then run
+
+  $ mvn clean deploy -Prelease
+
+which will transfer the artifacts to the Nexus repository located at
+  https://repository.apache.org/index.html#stagingRepositories
+
+This process transfers more files than really needed in the the "staging" (i.e.
+non official) maven repository. The files expected in the repository are
+commons-rng-1.0.pom, commons-rng-1.0.jar, commons-rng-1.0.javadoc,
+commons-rng-1.0.sources, commons-rng-1.0.test-sources commons-rng-1.0.tests,
+the associated fingerprints (<file-name>.md5 and <file-name>.sha1) and the signatures
+<file-name>.asc. Note that Nexus automatically adds "md5" and "sha1" checksums files
+to the "asc" files (cryptographic signature). These fingerprints on signatures are
+spurious and have to be manually removed from Nexus staging area. The process also
+transfers the complete source and binaries distributions files
+commons-rng-1.0.-bin.tar.gz, commons-rng-1.0.-bin.zip, commons-rng-1.0.-src.tar.gz,
+commons-rng-1.0.-src.zip as well as the associated .md5 and .sha1 fingerprints and the
+.asc signatures. These are not really maven artifacts but rather distribution archives,
+and they belong elsewhere, so they must also been removed from the Nexus staging
+repository.
+
+As a measure of sanity check,  repository must be manually "closed" before other
+people review the deliverables just created.
+How to "close" the staging repository is explained at this page:
+  http://books.sonatype.com/nexus-book/reference/staging-repositories.html#staging-sect-closing
+
+(12)
+Upload the other distribution files to the Apache servers.
+
+The archive files have been created during the previous step. They have been put
+in the .m2 local repository. The RELEASE_NOTES.txt file hase been created earlier
+and is still in the checkout directory of the release candidate. The README.html
+file can be copied from the release area of the Apache dist server.
+All these files can be uploaded to the development area of the Apache dist server
+using the following commands:
+
+ $ cd /tmp
+ $ svn cp https://dist.apache.org/repos/dist/release/commons/rng/README.html \
+          https://dist.apache.org/repos/dist/dev/commons/rng/README.html
+ $ svn checkout https://dist.apache.org/repos/dist/dev/commons/rng
+ $ cd rng
+
+edit README.html with released version number
+
+ $ cp ~/.m2/repository/org/apache/commons/commons-rng3/1.0/*-bin.* binaries
+ $ cp ~/.m2/repository/org/apache/commons/commons-rng3/1.0/*-src.* source
+ $ cp <path-to-the-RC-workspace>/RELEASE-NOTES.txt .
+ $ svn add README.html RELEASE-NOTES.txt binaries/* source/*
+ $ svn commit -m "Creating distribution files for 1.0 RC1"
+
+
+(13)
+As the web site staging area is shared among all commons components and therefore
+can be published before vote ends, it is not recommended to use the standard staging
+area for the release candidate. So you will just archive the transfer the site it on
+your apache personal area for review. Here is how to do this using lftp to initiate
+the sftp transfer (lftp supports a mirror command for recursive transfers, don't
+forget the -R flag for uploading instead of downloading the site). If you
+haven't setup your login on home.apache.org you will need to go to
+https://id.apache.org/, login and copy the contents of your ~/.ssh/id_rsa.pub
+file to "SSH Key (authorized_keys line)". Then run these commands:
+
+  $ mvn site
+  $ cd target
+  $ mv site commons-rng-1.0-RC1-site
+  $ lftp sftp://__Your_apache_login__@home.apache.org/
+     lftp you@home.apache.org:~> cd public_html
+     lftp you@home.apache.org:~/public_html> mirror -R commons-rng-1.0-RC1-site
+     lftp you@home.apache.org:~/public_html> bye
+
+
+(14)
+Call to vote by sending a message to the "dev" ML with subject
+"[VOTE][RC1] Release Commons Rng 1.0". You can use the following example as
+a starting point, replacing the URLs with the appropriate ones:
+----------
+This is a [VOTE] for releasing Apache Commons Rng 1.0 from release candidate 1.
+
+Tag name:
+  RNG_3_4_RC1 (signature can be checked from git using 'git tag -v')
+
+Tag URL:
+  <https://git-wip-us.apache.org/repos/asf?p=commons-rng.git;a=commit;h=cf4a9d70c9ac24dd7196995390171150e4e56451>
+
+Commit ID the tag points at:
+  cf4a9d70c9ac24dd7196995390171150e4e56451
+
+Site:
+  <http://home.apache.org/~__Your_apache_login__/commons-rng-1.0-RC1-site>
+
+Distribution files:
+  https://dist.apache.org/repos/dist/dev/commons/rng/
+
+Distribution files hashes (SHA1):
+  e02c981d49c1f12b1fc237e69cb551a5620e57b4 commons-rng-1.0-bin.tar.gz
+  11965eb97033d4d6ef0aeb902f1450641f40d3c5 commons-rng-1.0-bin.zip
+  ce3efda70ac8f850f15154b38438bc337adc027a commons-rng-1.0-src.tar.gz
+  d343c885a9d6eea611403f7f92ff580911363681 commons-rng-1.0-src.zip
+
+KEYS file to check signatures:
+  http://www.apache.org/dist/commons/KEYS
+
+Maven artifacts:
+  https://repository.apache.org/content/repositories/orgapachecommons-051/org/apache/commons/commons-rng3/1.0/
+
+[ ] +1 Release it.
+[ ] +0 Go ahead; I don't care.
+[ ] -0 There are a few minor glitches: ...
+[ ] -1 No, do not release it because ...
+
+This vote will close in 72 hours, at YYYY-MM-DDThh:mm:ssZ (this is UTC
+time).
+----------
+
+
+(15)
+If some blocking problems have been found in the release deliverables, cancel
+the vote by sending a "[CANCEL][VOTE]" message to the "dev" ML.
+After correcting the problems, you'll likely have to start again from step 3,
+4 or 5.
+
+
+(16)
+After at least 72 hours have elapsed, send a "[VOTE][RESULT]" mail to
+summarize the outcome of the vote. This should tally the votes cast,
+and state which are binding (PMC members). The vote needs at least three +1's
+from PMC members to pass.
+
+
+(17)
+The distribution files must be moved from the development area to the release
+area of the Apache dist server:
+
+$ svnmucc -U https://dist.apache.org/repos/dist \
+          rm release/commons/rng/README.html \
+          mv dev/commons/rng/README.html release/commons/rng/README.html \
+          rm release/commons/rng/RELEASE-NOTES.txt \
+          mv dev/commons/rng/RELEASE-NOTES.txt release/commons/rng/RELEASE-NOTES.txt \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.tar.gz release/commons/rng/binaries/commons-rng-1.0-bin.tar.gz \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.asc release/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.asc \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.md5 release/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.md5 \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.sha1 release/commons/rng/binaries/commons-rng-1.0-bin.tar.gz.sha1 \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.zip release/commons/rng/binaries/commons-rng-1.0-bin.zip \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.zip.asc release/commons/rng/binaries/commons-rng-1.0-bin.zip.asc \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.zip.md5 release/commons/rng/binaries/commons-rng-1.0-bin.zip.md5 \
+          mv dev/commons/rng/binaries/commons-rng-1.0-bin.zip.sha1 release/commons/rng/binaries/commons-rng-1.0-bin.zip.sha1 \
+          mv dev/commons/rng/source/commons-rng-1.0-src.tar.gz release/commons/rng/source/commons-rng-1.0-src.tar.gz \
+          mv dev/commons/rng/source/commons-rng-1.0-src.tar.gz.asc release/commons/rng/source/commons-rng-1.0-src.tar.gz.asc \
+          mv dev/commons/rng/source/commons-rng-1.0-src.tar.gz.md5 release/commons/rng/source/commons-rng-1.0-src.tar.gz.md5 \
+          mv dev/commons/rng/source/commons-rng-1.0-src.tar.gz.sha1 release/commons/rng/source/commons-rng-1.0-src.tar.gz.sha1 \
+          mv dev/commons/rng/source/commons-rng-1.0-src.zip release/commons/rng/source/commons-rng-1.0-src.zip \
+          mv dev/commons/rng/source/commons-rng-1.0-src.zip.asc release/commons/rng/source/commons-rng-1.0-src.zip.asc \
+          mv dev/commons/rng/source/commons-rng-1.0-src.zip.md5 release/commons/rng/source/commons-rng-1.0-src.zip.md5 \
+          mv dev/commons/rng/source/commons-rng-1.0-src.zip.sha1 release/commons/rng/source/commons-rng-1.0-src.zip.sha1 \
+          -m "Publish commons-rng 1.0 Release"
+
+
+(18)
+Release (a.k.a. "promote") the artifacts on the Nexus server, as shown here:
+  http://books.sonatype.com/nexus-book/reference/staging-repositories.html#staging-sect-releasing
+
+
+(19)
+Publish the web site. This is done by first committing the web site to the staging area, and then
+by publishing the staging area (which is shared among all commons components.
+
+In order to commit the web site to the staging area, look at the subversion
+workspace that was automatically checked out during the 'mvn site' command in
+folder site-content. Note that svn commits in the site-content directory are
+immediately synced with the live site and so your changes shoule show up in a
+few minutes once you commit the new site. You can also check out the site
+directly by yourself elsewhere:
+
+  svn checkout https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-rng site-content
+
+Remove all files there (except .svn folder) and move all the files from the site.
+
+ $ cd site-content
+ $ rm -fr *
+ $ cp -pR ../target/commons-rng-1.0-RC1-site/* .
+
+Check for possibly new files:
+ $ svn status
+and "svn add" them if necessary.
+
+Commit the new contents of the web site:
+ $ svn commit -m "updating site after official release of version 1.0"
+
+Beware the commit command may be very long (several hours ...).
+
+(20)
+The javadocs for several version is kept available on the website under the javadocs directory.
+This corresponds to a huge number of files which never changes, so they are not retrieved by
+default in the working copy when running 'svn checkout'. These javadocs must therefore be
+copied manually using server side copy from the apidocs directory after release, in order for
+the links to former versions to work. This is done as follows:
+
+  $ svn cp -m "copying 1.0 apidocs to versioned directory for the long-term links" \
+        https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-rng/apidocs \
+        https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-rng/javadocs/api-1.0
+
+Now wait a few minutes for the live site to fully sync and then check
+http://commons.apache.org/proper/commons-rng/ to make sure everything looks
+correct.
+
+(21)
+Put the official final tag to point at the same commit as the last release candidate tag:
+
+  $ git tag -s -m "RC1 becomes the 1.0 official version." RNG_3_4 cf4a9d70c9ac24dd7196995390171150e4e56451
+  $ git push --tags
+
+
+(22)
+Clean up files and prepare for next version (here we assume it will be 1.1):
+
+edit "doap_rng.rdf" to add the just released version date.
+
+edit "pom.xml" so it contains
+ 
+       <version>1.1-SNAPSHOT</version>
+
+edit "src/changes/changes.xml" to add a new section for the next release, setting
+the release date to "TBD" and the description to the empty string.
+
+Double-check "pom.xml" *really* has a -SNAPSHOT version and commit everything:
+
+  $ git add doap_rng.rdf pom.xml src/changes/changes.xml
+  $ git commit -m "Preparing next version (1.1)"
+  $ git push
+
+
+(23)
+Switch back to master and merge the X.Y-release branch
+
+  $ git checkout master
+  $ get merge X.Y-release
+  $ git push
+
+
+(24)
+Allow for the web site mirrors to be updated (possibly several hours); then
+send (from your apache account) a release announcement to the following ML:
+  announce@apache.org
+  dev@commons.apache.org
+  user@commons.apache.org
+
+If you don't have it setup already you can follow these instructions to send
+email from your apache account :
+
+https://reference.apache.org/committer/email#sendingemailfromyourapacheorgemailaddress
+
+You can use the following message as a template:
+
+----------
+The Apache Commons Team is pleased to announce the availability of:
+
+Apache Commons Rng 1.0
+
+Apache Commons Rng provides Java implementations of pseudo-random
+numbers generators.
+
+The release notes can be reviewed at:
+http://www.apache.org/dist/commons/rng/RELEASE-NOTES.txt
+
+Distribution packages can be downloaded from:
+https://commons.apache.org/proper/commons-rng/download_rng.cgi
+
+When downloading, please verify signatures using the KEYS file available at:
+http://www.apache.org/dist/commons
+
+Maven artifacts are also available in the central Maven repository:
+
+http://repo1.maven.org/maven2/org/apache/commons/
+
+The Apache Commons Team
+----------
+

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/doc/release/settings-security.xml
----------------------------------------------------------------------
diff --git a/doc/release/settings-security.xml b/doc/release/settings-security.xml
new file mode 100644
index 0000000..8111ca4
--- /dev/null
+++ b/doc/release/settings-security.xml
@@ -0,0 +1,22 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+  -->
+
+<settingsSecurity>
+  <master>
+    {YBj6__Your_encrypted_master_password__3iR4=}
+  </master>
+</settingsSecurity>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/doc/release/settings.xml
----------------------------------------------------------------------
diff --git a/doc/release/settings.xml b/doc/release/settings.xml
new file mode 100644
index 0000000..ff0adf6
--- /dev/null
+++ b/doc/release/settings.xml
@@ -0,0 +1,62 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+  -->
+
+<settings>
+
+  <servers>
+    <!-- To publish a snapshot -->
+    <server>
+      <id>apache.snapshots.https</id>
+      <username>__Your_apache_login__</username>
+      <password>{0Lbb__Your_encrypted_password__O4sQ=}</password>
+    </server>
+
+    <!-- To publish a release -->
+    <server>
+      <id>apache.releases.https</id>
+      <username>__Your_apache_login__</username>
+      <password>{0Lbb__Your_encrypted_password__O4sQ=}</password>
+    </server>
+
+    <!-- To stage the web site -->
+    <server>
+      <id>stagingSite</id>
+      <username>__Your_apache_login__</username>
+      <!-- This will use the default ssh key pair, whose public part must be
+           copied to the ~/.ssh/authorized_keys file on the server. -->
+    </server>
+
+    <!-- To publish the web site -->
+    <server>
+      <id>people.apache.org</id>
+      <username>__Your_apache_login__</username>
+      <!-- This will use the default ssh key pair, whose public part must be
+           copied to the ~/.ssh/authorized_keys file on the server. -->
+    </server>
+
+  </servers>
+
+  <profiles>
+    <profile>
+      <id>release</id>
+      <properties>
+        <gpg.keyname>__Your_key_identifier__</gpg.keyname>
+      </properties>
+    </profile>
+  </profiles>
+
+</settings>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/c0495bf2/findbugs-exclude-filter.xml
----------------------------------------------------------------------
diff --git a/findbugs-exclude-filter.xml b/findbugs-exclude-filter.xml
new file mode 100644
index 0000000..99b2e8a
--- /dev/null
+++ b/findbugs-exclude-filter.xml
@@ -0,0 +1,27 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<!--
+  This file contains some false positive bugs detected by findbugs. Their
+  false positive nature has been analyzed individually and they have been
+  put here to instruct findbugs it must ignore them.
+-->
+<FindBugsFilter>
+
+
+</FindBugsFilter>


Mime
View raw message