Clarify that latest distributable is 1.3

tumbarumba · tumbarumba · commit 6ee75af56d60 · 2018-11-08T07:47:13.000Z
diff --git a/docs/distributables.md b/docs/distributables.md
@@ -8,21 +8,61 @@ layout: default
 
 ## Introduction
 
-Hamcrest consists of a single jar, called `java-hamcrest-<version>.jar` (where `<version>` refers to the specific version of Hamcrest).
+Hamcrest consists of different jars matching the different needs of
+applications. This document describes these distributables and the
+functionality contained in each of them.
+
+## The Java Hamcrest Jars
+
+### `hamcrest-core.jar`
+
+This is the core API to be used by third-party framework providers.
+This includes a foundation set of matcher implementations for common
+operations. This API is stable and will rarely change. You will
+need this library as a minimum.
+
+### `hamcrest-library.jar`
+
+The library of Matcher implementations which are based on the core 
+functionality in hamcrest-core.jar.
+
+### `hamcrest-integration.jar`
+
+Provides integration between Hamcrest and other testing tools, such as jMock
+and EasyMock. Uses hamcrest-core.jar and hamcrest-library.jar.
+
+### `hamcrest-generator.jar`
+
+A tool to allow many Matcher implementations to be combined into
+a single class with static methods returning the different matchers 
+so users don't have to remember many classes/packages to import. 
+Generates code. This library is only used internally at compile time.
+It is not necessary for the use of any of the other hamcrest libraries 
+at runtime.
+
+### `hamcrest-all.jar`
+
+One jar containing all classes of all the other jars.
 
-Currently, the latest version of Java Hamcrest is `2.0.0.0`, and so the binary distributable is called `java-hamcrest-2.0.0.0.jar`.
 
 ## Adding Hamcrest to your Project
 
+The dependencies of the jars (`hamcrest-integration` uses `hamcrest-library`
+which uses `hamcrest-core`) is represented by the Maven dependency mechanism.
+There is no `hamcrest-all` library in the Maven repo prior to version 1.3. Just
+use hamcrest-integration which references all the other hamcrest libraries.
+ 
+
 ### Gradle
 
-Add `"org.hamcrest:java-hamcrest:$hamcrestVersion"` to the dependencies section of your `build.gradle`, for example:
+Add `"org.hamcrest:hamcrest-library:1.3"` to the dependencies section of your
+`build.gradle`, for example:
 
 ```gradle
 apply plugin: 'java'
 
 dependencies {
-    testImplementation 'org.hamcrest:java-hamcrest:2.0.0.0'
+    testImplementation 'org.hamcrest:hamcrest-library:1.3'
 }
 ```
 
@@ -36,69 +76,23 @@ Add the following dependency declaration to your `pom.xml`:
 ```xml
 <dependency>
     <groupId>org.hamcrest</groupId>
-    <artifactId>java-hamcrest</artifactId>
-    <version>2.0.0.0</version>
+    <artifactId>hamcrest-library</artifactId>
+    <version>1.3</version>
     <scope>test</scope>
 </dependency>
 ```
 
 ### Download
 
-You can download the jar directly from Maven Central. Hamcrest does
-not have any transitive dependencies, so you only need to download
-a single jar.
-
-You can find the jar by searching Maven Central for groupId `org.hamcrest`
-and artifactId `java-hamcrest` using the following link:
+You can download the jars directly from Maven Central. At a minimum, you will
+need `hamcrest-core-1.3.jar`, though most people will also use
+`hamcrest-library-1.3.jar` too. If you want to integrate Hamcrest Matchers with
+other 
 
-> [https://search.maven.org/search?q=g:org.hamcrest%20AND%20a:java-hamcrest](https://search.maven.org/search?q=g:org.hamcrest%20AND%20a:java-hamcrest) 
-
-## Previous Versions 
-
-Prior to version 2.0.0.0, Java Hamcrest was distributed as different
-jars matching the different needs of applications. This document
-describes these distributables and the functionality contained in
-each of them.
-
-### `hamcrest-core-1.3.jar`
-
-This is the core API to be used by third-party framework providers.
-This includes a foundation set of matcher implementations for common
-operations. This API is stable and will rarely change. You will
-need this library as a minimum. From version 2.0.0.0, this is
-included in `java-hamcrest.jar`.
-
-### `hamcrest-library-1.3.jar`
-
-The library of Matcher implementations which are based on the core 
-functionality in hamcrest-core.jar. From version 2.0.0.0, this is
-included in `java-hamcrest.jar`.
-
-### `hamcrest-generator-1.3.jar`
-
-A tool to allow many Matcher implementations to be combined into
-a single class with static methods returning the different matchers 
-so users don't have to remember many classes/packages to import. 
-Generates code. This library is only used internally at compile time.
-It is not necessary for the use of any of the other hamcrest libraries 
-at runtime.
-
-### `hamcrest-integration-1.3.jar`
-
-Provides integration between Hamcrest and other testing tools, 
-including JUnit (3 and 4), TestNG, jMock and EasyMock. Uses 
-hamcrest-core.jar and hamcrest-library.jar.
-
-### `hamcrest-all.jar`
-
-One jar containing all classes of all the other jars.
+You can find the jars by searching Maven Central for groupId `org.hamcrest` using the following link:
 
-### Previous Maven Versions
+> [https://search.maven.org/search?q=g:org.hamcrest](https://search.maven.org/search?q=g:org.hamcrest) 
 
-The description above also applies to the hamcrest Maven
-artifacts. The dependencies of the jars (`hamcrest-integration`
-uses `hamcrest-library` which uses `hamcrest-core`) is represented
-by the Maven dependency mechanism. There is no `hamcrest-all`
-library in the Maven repo prior to version 2.0.0.0. Just use hamcrest-integration which
-references all the other hamcrest libraries. After version 2.0.0.0,
-all the specified jars have been replaced by `java-hamcrest`.
+Maven central has some extra artifacts called `java-hamcrest` and `hamcrest-java`,
+with a version of `2.0.0.0`. Please do not use these, as they are an aborted effort
+at repackaging the different jars.
