diff options
author | Chris Fallin <cfallin@google.com> | 2015-03-03 10:55:55 -0800 |
---|---|---|
committer | Chris Fallin <cfallin@google.com> | 2015-03-03 10:56:23 -0800 |
commit | dfdec3b654cbf403197214f9354d9a2aff4d77d1 (patch) | |
tree | a5009a7be0edec5dd3ff67d98110c292e9dfc0bc /ruby/README.md | |
parent | 40f2df3c16b4a54f673108cad92f0da0be6efc21 (diff) | |
download | protobuf-dfdec3b654cbf403197214f9354d9a2aff4d77d1.tar.gz protobuf-dfdec3b654cbf403197214f9354d9a2aff4d77d1.tar.bz2 protobuf-dfdec3b654cbf403197214f9354d9a2aff4d77d1.zip |
Updated Ruby gem version and added note to ruby/README.md regarding version number scheme.
Change-Id: Idb29077c153530de78ce28c094442aa8f51ddd25
Diffstat (limited to 'ruby/README.md')
-rw-r--r-- | ruby/README.md | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/ruby/README.md b/ruby/README.md index 84f4a775..8331d286 100644 --- a/ruby/README.md +++ b/ruby/README.md @@ -72,3 +72,27 @@ Then build the Gem: This gem includes the upb parsing and serialization library as a single-file amalgamation. It is up-to-date with upb git commit `535bc2fe2f2b467f59347ffc9449e11e47791257`. + +Version Number Scheme +--------------------- + +We are using a version number scheme that is a hybrid of Protocol Buffers' +overall version number and some Ruby-specific rules. Gem does not allow +re-uploads of a gem with the same version number, so we add a sequence number +("upload version") to the version. We also format alphabetical tags (alpha, +pre, ...) slightly differently, and we avoid hyphens. In more detail: + +* First, we determine the prefix: a Protocol Buffers version "3.0.0-alpha-2" + becomes "3.0.0.alpha.2". When we release 3.0.0, this prefix will be simply + "3.0.0". +* We then append the upload version: "3.0.0.alpha.2.0" or "3.0.0.0". If we need + to upload a new version of the gem to fix an issue, the version becomes + "3.0.0.alpha.2.1" or "3.0.0.1". +* If we are working on a prerelease version, we append a prerelease tag: + "3.0.0.alpha.3.0.pre". The prerelease tag comes at the end so that when + version numbers are sorted, any prerelease builds are ordered between the + prior version and current version. + +These rules are designed to work with the sorting rules for +[Gem::Version](http://ruby-doc.org/stdlib-2.0/libdoc/rubygems/rdoc/Gem/Version.html): +release numbers should sort in actual release order. |