[jsemver] 25/95: Update README, format & change Issues section
Alexandre Viau
reazem-guest at moszumanska.debian.org
Mon Feb 16 14:58:26 UTC 2015
This is an automated email from the git hooks/post-receive script.
reazem-guest pushed a commit to branch master
in repository jsemver.
commit 223fcf97d00213b21dc44efb904aa6920a45ab4f
Author: Zafar Khaja <zafarkhaja at gmail.com>
Date: Sat Mar 9 16:39:41 2013 +0400
Update README, format & change Issues section
---
README.md | 35 ++++++++++++++++++++++++++---------
1 file changed, 26 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index a8e10d2..2ddeee0 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,13 @@
Java SemVer v0.5.0 [](https://travis-ci.org/zafarkhaja/java-semver)
==================
+
Java SemVer is a Java implementation of the Semantic Versioning Specification
(http://semver.org/).
**NOTE**: The current version of the Java SemVer corresponds to the Semantic
Versioning 2.0.0-rc.1.
+
Versioning
----------
Java SemVer is versioned according to the SemVer Specification.
@@ -14,6 +16,7 @@ Java SemVer is versioned according to the SemVer Specification.
zero which according to the SemVer p.4 means that the library is under initial
development and its public API should not be considered stable.
+
Usage
-----
Below are some common use cases for the Java SemVer library.
@@ -75,26 +78,40 @@ import com.github.zafarkhaja.semver.Version;
Version v1 = Version.valueOf("1.0.0-rc.1+build.1");
Version v2 = Version.valueOf("1.3.7+build.2.b8f12d7");
-int result = v1.compareTo(v2); // (result < 0)
-
-boolean result = v1.equals(v2); // (result == false)
+int result = v1.compareTo(v2); // < 0
+boolean result = v1.equals(v2); // false
-boolean result = v1.greaterThan(v2); // (result == false)
-boolean result = v1.greaterThanOrEqualsTo(v2); // (result == false)
-boolean result = v1.lessThan(v2); // (result == true)
-boolean result = v1.lessThanOrEqualsTo(v2); // (result == true)
+boolean result = v1.greaterThan(v2); // false
+boolean result = v1.greaterThanOrEqualsTo(v2); // false
+boolean result = v1.lessThan(v2); // true
+boolean result = v1.lessThanOrEqualsTo(v2); // true
```
+
Issues
------
-As of the moment, there is an ambiguity, at least for me, on what should be the
+As of the moment, the Specification is not clear about what should be the
behavior of pre-release and build versions when the normal version numbers are
-incremented. See the discussion page https://github.com/mojombo/semver/issues/60.
+incremented. Below is an example of what I mean:
+
+```java
+import com.github.zafarkhaja.semver.Version;
+
+Version v1 = Version.valueOf("1.2.3-alpha+build");
+Version v2 = v1.incrementMajorVersion();
+
+String normal = v2.getNormalVersion(); // "2.0.0"
+String preRelease = v2.getPreReleaseVersion(); // "" OR "alpha" OR "alpha1" OR "alpha2" ?
+String build = v2.getBuildVersion(); // "" OR "build" OR "build1" OR "build2" ?
+```
+Also, see the discussion page https://github.com/mojombo/semver/issues/60.
+
TODO
----
* implement ranges
+
License
-------
Java SemVer is licensed under the MIT License - see the `LICENSE` file for details.
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/jsemver.git
More information about the pkg-java-commits
mailing list