rubygems-update 3.1.6 → 3.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf1897c1f4290a7c09ac7fc031441915d225aaa7ffab473229a244310eaa39ac
-  data.tar.gz: d6aef4fc02c767b99957e4dfaff7818399b9fb59de550d23bee19256b618a5f6
+  metadata.gz: 6c18e3412218b88b1351a2dcd3096240a1b5fa833aa26c58efee7a70e72601d4
+  data.tar.gz: 9f8fff96b275641a2fd60220cbfa98343af11c177c8797261f1d99089f4345c0
 SHA512:
-  metadata.gz: 2421931e30162b92a93891c80eb17bd3d78a135da9019f49a18ce701bf4ca1fa7731260f4cc6de1342a74accceb8df21024ccd5042cbefa9a89cf67c69528a54
-  data.tar.gz: 131eb583b3864dec611fab7574a8ebf75cc796288ed2a4c43e96d6b53d24509f282e83fa36b2851ad5e5c21b6d8f78fc3fadc3da974575428b3489d3d28d3a88
+  metadata.gz: cb78b68b419a3ffa8e70a9688c563510c93982c0d3c26969594639bcf41ba6345b3a48cf1c4f756689a202d1b8d9be416d19715d18acea2640dd6dcb53cee2d1
+  data.tar.gz: 98fb817e049053336bd47a5525a4247096558eef13efd10e5a7c38ea407569ef62fe29d135142854759874424c624bf51ed292606257a9539e60d991f891abd2

data/{History.txt → CHANGELOG.md}

@@ -1,25 +1,290 @@
-# coding: UTF-8
+# 3.2.7 / 2021-01-26
 
-=== 3.1.6 / 2021-01-26
+## Bug fixes:
 
-Minor enhancements:
+* Generate plugin wrappers with relative requires. Pull request #4317 by
+  deivid-rodriguez
 
-* Improve require. Pull request #3133 by David Rodríguez.
-* Simplify nested gem activation exceptions. Pull request #3450 by David
+# 3.2.6 / 2021-01-18
+
+## Enhancements:
+
+* Fix `Gem::Platform#inspect` showing duplicate information. Pull request
+  #4276 by deivid-rodriguez
+
+## Bug fixes:
+
+* Swallow any system call error in `ensure_gem_subdirs` to support jruby
+  embedded paths. Pull request #4291 by kares
+* Restore accepting custom make command with extra options as the `make`
+  env variable. Pull request #4271 by terceiro
+
+# 3.2.5 / 2021-01-11
+
+## Bug fixes:
+
+* Don't load more specs after the whole set of specs has been setup. Pull
+  request #4262 by deivid-rodriguez
+* Fix broken `bundler` executable after `gem update --system`. Pull
+  request #4221 by deivid-rodriguez
+
+# 3.2.4 / 2020-12-31
+
+## Enhancements:
+
+* Use a CHANGELOG in markdown for rubygems. Pull request #4168 by
+  deivid-rodriguez
+* Never spawn subshells when building extensions. Pull request #4190 by
+  deivid-rodriguez
+
+## Bug fixes:
+
+* Fix fallback to the old index and installation from it not working. Pull
+  request #4213 by deivid-rodriguez
+* Fix installing from source on truffleruby. Pull request #4201 by
+  deivid-rodriguez
+
+# 3.2.3 / 2020-12-22
+
+## Enhancements:
+
+* Fix misspellings in default API key name. Pull request #4177 by hsbt
+
+## Bug fixes:
+
+* Respect `required_ruby_version` and `required_rubygems_version`
+  constraints when looking for `gem install` candidates. Pull request #4110
+  by deivid-rodriguez
+
+# 3.2.2 / 2020-12-17
+
+## Bug fixes:
+
+* Fix issue where CLI commands making more than one request to
+  rubygems.org needing an OTP code would crash or ask for the code twice.
+  Pull request #4162 by sonalkr132
+* Fix building rake extensions that require openssl. Pull request #4165 by
+  deivid-rodriguez
+* Fix `gem update --system` displaying too many changelog entries. Pull
+  request #4145 by deivid-rodriguez
+
+# 3.2.1 / 2020-12-14
+
+## Enhancements:
+
+* Added help message for gem i webrick in gem server command. Pull request
+  #4117 by hsbt
+
+## Bug fixes:
+
+* Added the missing loading of fileutils same as load_specs. Pull request
+  #4124 by hsbt
+* Fix Resolver::APISet to always include prereleases when necessary. Pull
+  request #4113 by deivid-rodriguez
+
+# 3.2.0 / 2020-12-07
+
+## Enhancements:
+
+* Do not override Kernel#warn when there is no need. Pull request #4075 by
+  eregon
+* Update endpoint of gem signin command. Pull request #3840 by sonalkr132
+* Omit deprecated commands from command help output. Pull request #4023 by
+  landongrindheim
+* Suggest alternatives in `gem query` deprecation. Pull request #4021 by
+  landongrindheim
+* Lazily load `time`, `cgi`, and `zlib`. Pull request #4010 by
+  deivid-rodriguez
+* Don't hit the network when installing dependencyless local gemspec. Pull
+  request #3968 by deivid-rodriguez
+* Add `--force` option to `gem sources` command. Pull request #3956 by
+  andy-smith-msm
+* Lazily load `openssl`. Pull request #3850 by deivid-rodriguez
+* Pass more information when comparing platforms. Pull request #3817 by
+  eregon
+
+## Bug fixes:
+
+* Use better owner & group for files in rubygems package. Pull request
+  #4065 by deivid-rodriguez
+* Improve gem build -C flag. Pull request #3983 by bronzdoc
+* Handle unexpected behavior with URI#merge and subpaths missing trailing
+  slashes. Pull request #3123 by drcapulet
+* Add missing `fileutils` require in rubygems installer. Pull request
+  #4036 by deivid-rodriguez
+* Fix `--platform` option to `gem specification` being ignored. Pull
+  request #4043 by deivid-rodriguez
+* Expose `--no-minimal-deps` flag to install the latest version of
+  dependencies. Pull request #4030 by deivid-rodriguez
+* Fix "stack level too deep" error when overriding `Warning.warn`. Pull
+  request #3987 by eregon
+* Append '.gemspec' extension only when it is not present. Pull request
+  #3988 by voxik
+* Install to correct plugins dir when using `--build-root`. Pull request
+  #3972 by deivid-rodriguez
+* Fix `--build-root` flag under Windows. Pull request #3975 by
+  deivid-rodriguez
+* Fix `typo_squatting?` false positive for `rubygems.org` itself. Pull
+  request #3951 by andy-smith-msm
+* Make `--default` and `--install-dir` options to `gem install` play nice
+  together. Pull request #3906 by deivid-rodriguez
+
+## Deprecations:
+
+* Deprecate server command. Pull request #3868 by bronzdoc
+
+## Performance:
+
+* Don't change ruby process CWD when building extensions. Pull request
+  #3498 by deivid-rodriguez
+
+# 3.2.0.rc.2 / 2020-10-08
+
+## Enhancements:
+
+* Make --dry-run flag consistent across rubygems commands. Pull request
+  #3867 by bronzdoc
+* Disallow downgrades to too old versions. Pull request #3566 by
+  deivid-rodriguez
+* Added `--platform` option to `build` command. Pull request #3079 by nobu
+* Have "gem update --system" pass through the `--silent` flag. Pull
+  request #3789 by duckinator
+* Add writable check for cache dir. Pull request #3876 by xndcn
+* Warn on duplicate dependency in a specification. Pull request #3864 by
+  bronzdoc
+* Fix indentation in `gem env`. Pull request #3861 by colby-swandale
+* Let more exceptions flow. Pull request #3819 by deivid-rodriguez
+* Ignore internal frames in RubyGems' Kernel#warn. Pull request #3810 by
+  eregon
+
+## Bug fixes:
+
+* Add missing fileutils require. Pull request #3911 by deivid-rodriguez
+* Fix false positive warning on Windows when PATH has
+  `File::ALT_SEPARATOR`. Pull request #3829 by deivid-rodriguez
+* Fix Kernel#warn override to handle backtrace location with nil path.
+  Pull request #3852 by jeremyevans
+* Don't format executables on `gem update --system`. Pull request #3811 by
+  deivid-rodriguez
+* `gem install --user` fails with `Gem::FilePermissionError` on the system
+  plugins directory. Pull request #3804 by nobu
+
+## Performance:
+
+* Avoid duplicated generation of APISpecification objects. Pull request
+  #3940 by mame
+* Eval defaults with frozen_string_literal: true. Pull request #3847 by
+  casperisfine
+* Deduplicate the requirement operators in memory. Pull request #3846 by
+  casperisfine
+* Optimize Gem.already_loaded?. Pull request #3793 by casperisfine
+
+# 3.2.0.rc.1 / 2020-07-04
+
+## Enhancements:
+
+* Test TruffleRuby in CI. Pull request #2797 by Benoit Daloze.
+* Rework plugins system and speed up rubygems. Pull request #3108 by David
+  Rodríguez.
+* Specify explicit separator not to be affected by $;. Pull request #3424
+  by Nobuyoshi Nakada.
+* Enable `Layout/ExtraSpacing` cop. Pull request #3449 by David Rodríguez.
+* Rollback gem deprecate. Pull request #3530 by Luis Sagastume.
+* Normalize heredoc delimiters. Pull request #3533 by David Rodríguez.
+* Log messages to stdout in `rake package`. Pull request #3632 by David
+  Rodríguez.
+* Remove explicit `psych` activation. Pull request #3636 by David
+  Rodríguez.
+* Delay `fileutils` loading to fix some warnings. Pull request #3637 by
+  David Rodríguez.
+* Make sure rubygems/package can be directly required reliably. Pull
+  request #3670 by Luis Sagastume.
+* Make sure `tmp` folder exists before calling `Dir.tmpdir`. Pull request
+  #3711 by David Rodríguez.
+* Add Gem.disable_system_update_message to disable gem update --system if
+  needed. Pull request #3720 by Josef Šimánek.
+* Tweaks to play nice with ruby-core setup. Pull request #3733 by David
+  Rodríguez.
+* Remove explicit require for auto-loaded constant. Pull request #3751 by
+  Karol Bucek.
+* Test files should not be included in spec.files. Pull request #3758 by
+  Marc-André Lafortune.
+* Remove TODO comment about warning on setting instead of pushing. Pull
+  request #2823 by Luis Sagastume.
+* Add deprecate command method. Pull request #2935 by Luis Sagastume.
+* Simplify deprecate command method. Pull request #2974 by Luis Sagastume.
+* Fix Gem::LOADED_SPECS_MUTEX handling for recursive locking. Pull request
+  #2985 by MSP-Greg.
+* Add `funding_uri ` metadata field to gemspec. Pull request #3060 by
+  Colby Swandale.
+* Updates to some old gem-signing docs. Pull request #3063 by Tieg
+  Zaharia.
+* Update the gem method for Gem::Installer. Pull request #3137 by Daniel
+  Berger.
+* Simplify initial gem help output. Pull request #3148 by Olivier Lacan.
+* Resolve latest version via `gem contents`. Pull request #3149 by Dan
+  Rice.
+* Install suggestions. Pull request #3151 by Sophia Castellarin.
+* Only rescue the errors we actually want to rescue. Pull request #3156 by
+  David Rodríguez.
+
+## Bug fixes:
+
+* Accept not only /usr/bin/env but also /bin/env in some tests. Pull
+  request #3422 by Yusuke Endoh.
+* Skip a test that attempts to remove the current directory on Solaris.
+  Pull request #3423 by Yusuke Endoh.
+* Fix race condition on bundler's parallel installer. Pull request #3440
+  by David Rodríguez.
+* Fix platform comparison check in #contains_requirable_file?. Pull
+  request #3495 by Benoit Daloze.
+* Improve missing spec error. Pull request #3559 by Luis Sagastume.
+* Fix hidden bundler template installation from rubygems updater. Pull
+  request #3674 by David Rodríguez.
+* Fix gem update --user-install. Pull request #2901 by Luis Sagastume.
+* Correct conflict list when uninstallation is prevented. Pull request
+  #2973 by David Rodríguez.
+* Fix error when trying to find bundler with a deleted "working directo….
+  Pull request #3090 by Luis Sagastume.
+* Fix -I require priority. Pull request #3124 by David Rodríguez.
+* Fix `ruby setup.rb` for new plugins layout. Pull request #3144 by David
   Rodríguez.
-* Fix correctness and performance regression in `require`. Pull request
-  #3639 by David Rodríguez.
 
-=== 3.1.5 / 2020-12-09
+## Deprecations:
 
-Minor enhancements:
+* Set deprecation warning on query command. Pull request #2967 by Luis
+  Sagastume.
 
-* Add GlobalSign Root CA - R3 cert and remove outdated certs. Pull request #4100
-  by Aditya Prakash.
+## Breaking changes:
+
+* Remove ruby 1.8 leftovers. Pull request #3442 by David Rodríguez.
+* Minitest cleanup. Pull request #3445 by David Rodríguez.
+* Remove `builder` gem requirement for `gem regenerate_index`. Pull
+  request #3552 by David Rodríguez.
+* Remove modelines for consistency. Pull request #3714 by David Rodríguez.
+* Stop using deprecated OpenSSL::Digest constants. Pull request #3763 by
+  Bart de Water.
+* Remove Gem module deprecated methods. Pull request #3101 by Luis
+  Sagastume.
+* Remove ubygems.rb. Pull request #3102 by Luis Sagastume.
+* Remove Gem::Commands::QueryCommand. Pull request #3104 by Luis
+  Sagastume.
+* Remove dependency installer deprecated methods. Pull request #3106 by
+  Luis Sagastume.
+* Remove Gem::UserInteraction#debug method. Pull request #3107 by Luis
+  Sagastume.
+* Remove options from Gem::GemRunner.new. Pull request #3110 by Luis
+  Sagastume.
+* Remove deprecated Gem::RemoteFetcher#fetch_size. Pull request #3111 by
+  Luis Sagastume.
+* Remove source_exception from Gem::Exception. Pull request #3112 by Luis
+  Sagastume.
+* Requiring rubygems/source_specific_file is deprecated, remove it. Pull
+  request #3114 by Luis Sagastume.
 
-=== 3.1.4 / 2020-06-03
+# 3.1.4 / 2020-06-03
 
-Minor enhancements:
+## Enhancements:
 
 * Deprecate rubyforge_project attribute only during build
   time. Pull request #3609 by Josef Šimánek.
@@ -28,9 +293,9 @@ Minor enhancements:
 * Remove failing ubuntu-rvm CI flow. Pull request #3611 by
   Josef Šimánek.
 
-=== 3.1.3 / 2020-05-05
+# 3.1.3 / 2020-05-05
 
-Minor enhancements:
+## Enhancements:
 
 * Resolver: require NameTuple before use. Pull request #3171 by Olle
   Jonsson.
@@ -41,7 +306,7 @@ Minor enhancements:
 * Add tests to check if Gem.ruby_version works with ruby git master.
   Pull request #3049 by Yusuke Endoh.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix platform comparison check in #contains_requirable_file?. Pull
   request #3495 by Benoit Daloze.
@@ -53,9 +318,9 @@ Bug fixes:
 * Fix gem install from a gemdeps file with complex dependencies.
   Pull request #3054 by Luis Sagastume.
 
-=== 3.1.2 / 2019-12-20
+# 3.1.2 / 2019-12-20
 
-Minor enhancements:
+## Enhancements:
 
 * Restore non prompting `gem update --system` behavior. Pull request #3040
   by David Rodríguez.
@@ -65,29 +330,26 @@ Minor enhancements:
   Pull request #3042 by David Rodríguez.
 * Use Bundler 2.1.2. Pull request #3043 by SHIBATA Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Require `uri` in source.rb. Pull request #3034 by mihaibuzgau.
 * Fix `gem update --system --force`. Pull request #3035 by David
   Rodríguez.
 * Move `require uri` to source_list. Pull request #3038 by mihaibuzgau.
 
-=== 3.1.1 / 2019-12-16
+# 3.1.1 / 2019-12-16
 
-Bug fixes:
+## Bug fixes:
 
 * Vendor Bundler 2.1.0 again. The version of Bundler with
   RubyGems 3.1.0 was Bundler 2.1.0.pre.3. Pull request #3029 by
   SHIBATA Hiroshi.
 
-=== 3.1.0 / 2019-12-16
+# 3.1.0 / 2019-12-16
 
-Major enhancements:
+## Enhancements:
 
 * Vendor bundler 2.1. Pull request #3028 by David Rodríguez.
-
-Minor enhancements:
-
 * Check for rubygems.org typo squatting sources. Pull request #2999 by
   Luis Sagastume.
 * Refactor remote fetcher. Pull request #3017 by David Rodríguez.
@@ -99,22 +361,25 @@ Minor enhancements:
 * Use bundler to manage development dependencies. Pull request #3012 by
   David Rodríguez.
 
-Bug fixes:
+## Bug fixes:
 
 * Remove unnecessary executable flags. Pull request #2982 by David
   Rodríguez.
 * Remove configuration that contained a typo. Pull request #2989 by David
   Rodríguez.
 
-Compatibility changes:
+## Deprecations:
 
-* Remove 1.8.7 leftovers. Pull request #2972 by David Rodríguez.
 * Deprecate `gem generate_index --modern` and `gem generate_index
   --no-modern`. Pull request #2992 by David Rodríguez.
 
-=== 3.1.0.pre3 / 2019-11-11
+## Breaking changes:
 
-Minor enhancements:
+* Remove 1.8.7 leftovers. Pull request #2972 by David Rodríguez.
+
+# 3.1.0.pre3 / 2019-11-11
+
+## Enhancements:
 
 * Fix gem pristine not accounting for user installed gems. Pull request
   #2914 by Luis Sagastume.
@@ -133,18 +398,18 @@ Minor enhancements:
 * Fix Gem::LOADED_SPECS_MUTEX handling for recursive locking. Pull request
   #2985 by MSP-Greg.
 
-=== 3.1.0.pre2 / 2019-10-15
+# 3.1.0.pre2 / 2019-10-15
 
-Minor enhancements:
+## Enhancements:
 
 * Optimize Gem::Package::TarReader#each. Pull request #2941 by Jean byroot
   Boussier.
 * Time comparison around date boundary. Pull request #2944 by Nobuyoshi
   Nakada.
 
-=== 3.1.0.pre1 / 2019-10-08
+# 3.1.0.pre1 / 2019-10-08
 
-Major enhancements:
+## Enhancements:
 
 * Try to use bundler-2.1.0.pre.2. Pull request #2923 by SHIBATA Hiroshi.
 * [Require] Ensure -I beats a default gem. Pull request #1868 by Samuel
@@ -155,9 +420,6 @@ Major enhancements:
   Chaofan.
 * Autoswitch to exact bundler version if present. Pull request #2583 by
   David Rodríguez.
-
-Minor enhancements:
-
 * Fix Gem::Requirement equality comparison when ~> operator is used. Pull
   request #2554 by Grey Baker.
 * Don't use a proxy if https_proxy env var is empty. Pull request #2567 by
@@ -277,7 +539,7 @@ Minor enhancements:
   Berger.
 * Remove useless TODO comment. Pull request #2818 by Luis Sagastume.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix typos in History.txt. Pull request #2565 by Igor Zubkov.
 * Remove unused empty sources array. Pull request #2598 by Aaron
@@ -310,29 +572,33 @@ Bug fixes:
 * Fix cryptic error on local and ignore-dependencies combination. Pull
   request #2650 by David Rodríguez.
 
-Compatibility changes:
+## Deprecations:
 
-* Remove commented code from command.rb. Pull request #2620 by Luis
+* Make deprecate Gem::RubyGemsVersion and Gem::ConfigMap. Pull request
+  #2857 by SHIBATA Hiroshi.
+* Deprecate Gem::RemoteFetcher#fetch_size. Pull request #2833 by Luis
+  Sagastume.
+* Explicitly deprecate `rubyforge_project`. Pull request #2798 by David
+  Rodríguez.
+* Deprecate unused Gem::Installer#unpack method. Pull request #2715 by Vít
+  Ondruch.
+* Deprecate a few unused methods. Pull request #2674 by David Rodríguez.
+* Add deprecation warnings for cli options. Pull request #2607 by Luis
   Sagastume.
+
+## Breaking changes:
+
 * Suppress keywords warning. Pull request #2934 by Nobuyoshi Nakada.
 * Suppress Ruby 2.7's real kwargs warning. Pull request #2912 by Koichi
   ITO.
 * Fix Kernel#warn override. Pull request #2911 by Jeremy Evans.
-* Make deprecate Gem::RubyGemsVersion and Gem::ConfigMap. Pull request
-  #2857 by SHIBATA Hiroshi.
-* Deprecate Gem::RemoteFetcher#fetch_size. Pull request #2833 by Luis
-  Sagastume.
 * Remove conflict.rb code that was supposed to be removed in Rubygems 3.
   Pull request #2802 by Luis Sagastume.
-* Explicitly deprecate `rubyforge_project`. Pull request #2798 by David
-  Rodríguez.
 * Compatibility cleanups. Pull request #2754 by David Rodríguez.
 * Remove `others_possible` activation request param. Pull request #2747 by
   David Rodríguez.
 * Remove dependency installer deprecated code. Pull request #2740 by Luis
   Sagastume.
-* Deprecate unused Gem::Installer#unpack method. Pull request #2715 by Vít
-  Ondruch.
 * Removed guard condition with USE_BUNDLER_FOR_GEMDEPS. Pull request #2716
   by SHIBATA Hiroshi.
 * Skip deprecation warning during specs. Pull request #2718 by David
@@ -341,34 +607,36 @@ Compatibility changes:
 * Removed circular require. Pull request #2679 by Nobuyoshi Nakada.
 * Removed needless environmental variable for Travis CI. Pull request
   #2685 by SHIBATA Hiroshi.
-* Deprecate a few unused methods. Pull request #2674 by David Rodríguez.
 * Removing yaml require. Pull request #2538 by Luciano Sousa.
-* Add deprecation warnings for cli options. Pull request #2607 by Luis
-  Sagastume.
 
-Style changes:
+# 3.0.8 / 2020-02-19
 
-* Enable `Layout/SpaceInsideParens` rubocop cop. Pull request #2630 by
-  David Rodríguez.
-* Remove some extra empty lines from the repo. Pull request #2669 by David
-  Rodríguez.
-* Enable Style/EmptyLinesAroundClassBody rubocop cop. Pull request #2636
-  by David Rodríguez.
-* Enable Style/BlockDelimiters rubocop cop. Pull request #2640 by David
-  Rodríguez.
-* Enable Layout/SpaceAroundOperators rubocop cop. Pull request #2642 by
-  David Rodríguez.
-* Rubocop 0.71. Pull request #2785 by David Rodríguez.
+## Bug fixes:
+
+* Gem::Specification#to_ruby needs OpenSSL. Pull request #2937 by
+  Nobuyoshi Nakada.
+
+# 3.0.7 / 2020-02-18
+
+## Bug fixes:
+
+* Fix underscore version selection for bundler #2908 by David Rodríguez.
+* Add missing wrapper. Pull request #2690 by David Rodríguez.
+* Make Gem::Specification#ruby_code handle OpenSSL::PKey::RSA objects.
+  Pull request #2782 by Luis Sagastume.
+* Installer.rb - fix #windows_stub_script. Pull request #2876 by MSP-Greg.
+* Use IAM role to extract security-credentials for EC2 instance. Pull
+  request #2894 by Alexander Pakulov.
 
-=== 3.0.6 / 2019-08-17
+# 3.0.6 / 2019-08-17
 
-Bug fixes:
+## Bug fixes:
 
 * Revert #2813. It broke the compatibility with 3.0.x versions.
 
-=== 3.0.5 / 2019-08-16
+# 3.0.5 / 2019-08-16
 
-Minor enhancements:
+## Enhancements:
 
 * Use env var to configure api key on push. Pull request #2559 by Luis
   Sagastume.
@@ -403,7 +671,7 @@ Minor enhancements:
   by Alexander Pakulov.
 * Fixup #2844. Pull request #2878 by SHIBATA Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix intermittent test error on Appveyor & Travis. Pull request #2568 by
   MSP-Greg.
@@ -419,9 +687,9 @@ Bug fixes:
 * Ignore GEMRC variable for test suite. Pull request #2837 by SHIBATA
   Hiroshi.
 
-=== 3.0.4 / 2019-06-14
+# 3.0.4 / 2019-06-14
 
-Minor enhancements:
+## Enhancements:
 
 * Add support for TruffleRuby #2612 by Benoit Daloze
 * Serve a more descriptive error when --no-ri or --no-rdoc are used #2572
@@ -458,7 +726,7 @@ Minor enhancements:
   request #2777 by Yusuke Endoh.
 * Backport ruby core changes. Pull request #2778 by SHIBATA Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Test_gem.rb - intermittent failure fix. Pull request #2613 by MSP-Greg.
 * Fix sporadic CI failures. Pull request #2617 by David Rodríguez.
@@ -474,11 +742,10 @@ Bug fixes:
   #2732 by Alex Junger.
 * Fix TODOs. Pull request #2748 by David Rodríguez.
 
-=== 3.0.3 / 2019-03-05
+# 3.0.3 / 2019-03-05
 
 Security fixes:
 
-* Fixed following vulnerabilities:
   * CVE-2019-8320: Delete directory using symlink when decompressing tar
   * CVE-2019-8321: Escape sequence injection vulnerability in `verbose`
   * CVE-2019-8322: Escape sequence injection vulnerability in `gem owner`
@@ -486,14 +753,14 @@ Security fixes:
   * CVE-2019-8324: Installing a malicious gem may lead to arbitrary code execution
   * CVE-2019-8325: Escape sequence injection vulnerability in errors
 
-=== 3.0.2 / 2019-01-01
+# 3.0.2 / 2019-01-01
 
-Minor enhancements:
+## Enhancements:
 
 * Use Bundler-1.17.3. Pull request #2556 by SHIBATA Hiroshi.
 * Fix document flag description. Pull request #2555 by Luis Sagastume.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix tests when ruby --program-suffix is used without rubygems
   --format-executable. Pull request #2549 by Jeremy Evans.
@@ -503,9 +770,9 @@ Bug fixes:
   Fukumori.
 * Restore SOURCE_DATE_EPOCH. Pull request #2560 by SHIBATA Hiroshi.
 
-=== 3.0.1 / 2018-12-23
+# 3.0.1 / 2018-12-23
 
-Bug fixes:
+## Bug fixes:
 
 * Ensure globbed files paths are expanded. Pull request #2536 by Tony Ta.
 * Dup the Dir.home string before passing it on. Pull request #2545 by
@@ -514,9 +781,9 @@ Bug fixes:
   by SHIBATA Hiroshi.
 * Restore release task without hoe. Pull request #2547 by SHIBATA Hiroshi.
 
-=== 3.0.0 / 2018-12-19
+# 3.0.0 / 2018-12-19
 
-Major enhancements:
+## Enhancements:
 
 * S3 source. Pull request #1690 by Aditya Prakash.
 * Download gems with threads. Pull request #1898 by André Arko.
@@ -524,9 +791,6 @@ Major enhancements:
 * [GSoC] Multi-factor feature for RubyGems. Pull request #2369 by Qiu
   Chaofan.
 * Use bundler 1.17.2. Pull request #2521 by SHIBATA Hiroshi.
-
-Minor enhancements:
-
 * Don't treat inaccessible working directories as build failures. Pull
   request #1135 by Pete.
 * Remove useless directory parameter from builders .build methods.
@@ -553,7 +817,7 @@ Minor enhancements:
   Swandale.
 * Add Gem.operating_system_defaults to allow packagers to override
   defaults. Pull request #2116 by Vít Ondruch.
-* Update for compatibilty with new minitest. Pull request #2118 by
+* Update for compatibility with new minitest. Pull request #2118 by
   MSP-Greg.
 * Make Windows bin stubs portable. Pull request #2119 by MSP-Greg.
 * Avoid to warnings about gemspec loadings in rubygems tests. Pull request
@@ -585,11 +849,11 @@ Minor enhancements:
   SHIBATA Hiroshi.
 * Add Rake task to install dev dependencies. Pull request #2173 by Ellen
   Marie Dash.
-* Add new sections to the README and explaination of what RubyGems is.
+* Add new sections to the README and explanation of what RubyGems is.
   Pull request #2174 by Colby Swandale.
 * Prefer to use `Numeric#zero?` instead of `== 0`. Pull request #2176 by
   SHIBATA Hiroshi.
-* Ignore perfomance test of version regexp pattern. Pull request #2179 by
+* Ignore performance test of version regexp pattern. Pull request #2179 by
   SHIBATA Hiroshi.
 * Ignore .DS_Store files in the update_manifest task. Pull request #2199
   by Colby Swandale.
@@ -684,7 +948,7 @@ Minor enhancements:
 * Support the environment without OpenSSL. Pull request #2528 by SHIBATA
   Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix undefined method error when printing alert. Pull request #1884 by
   Robert Ross.
@@ -737,7 +1001,7 @@ Bug fixes:
 * Fix tests when --program-suffix and similar ruby configure options are
   used. Pull request #2529 by Jeremy Evans.
 
-Compatibility changes:
+## Breaking changes:
 
 * IO.binread is not provided at Ruby 1.8. Pull request #2093 by SHIBATA
   Hiroshi.
@@ -790,44 +1054,20 @@ Compatibility changes:
 * [BudlerVersionFinder] set .filter! and .compatible? to match only on
   major versions. Pull request #2515 by Colby Swandale.
 
-Style changes:
-
-* Add Rubocop. Pull request #2250 by Colby Swandale.
-* Removed explicitly declaration of thread library. Pull request #2324 by
-  SHIBATA Hiroshi.
-* Remove Trailing whitespace with rubocop. Pull request #2394 by SHIBATA
-  Hiroshi.
-* Update rubocop and also use correct pessimistic version. Pull request
-  #2404 by Colby Swandale.
-* Enable more rubocop rules. Pull request #2435 by Ellen Marie Dash.
-* Fix and lock rubocop. Pull request #2465 by David Rodríguez.
-* Add a rubocop binstub. Pull request #2468 by David Rodríguez.
-* Restore the `rubocop` task. Pull request #2470 by David Rodríguez.
-* Remove trailing blank lines. Pull request #2471 by David Rodríguez.
-* Remove empty lines around method bodies. Pull request #2473 by David
-  Rodríguez.
-* Enable Style/MethodDefParentheses in Rubocop. Pull request #2478 by
-  Colby Swandale.
-* Enable Style/MultilineIfThen in Rubocop. Pull request #2479 by Luis
-  Sagastume.
-* Remove trailing 'then' from generated code. Pull request #2480 by Luis
-  Sagastume.
-
-=== 2.7.10 / 2019-06-14
+# 2.7.10 / 2019-06-14
 
-Minor enhancements:
+## Enhancements:
 
 * Fix bundler rubygems binstub not properly looking for bundler. Pull request #2426
   by David Rodríguez.
 * [BudlerVersionFinder] set .filter! and .compatible? to match only on major versions.
   Pull request #2515 by Colby Swandale.
-+ Update for compatibilty with new minitest. Pull request #2118 by MSP-Greg.
++ Update for compatibility with new minitest. Pull request #2118 by MSP-Greg.
 
-=== 2.7.9 / 2019-03-05
+# 2.7.9 / 2019-03-05
 
 Security fixes:
 
-* Fixed following vulnerabilities:
   * CVE-2019-8320: Delete directory using symlink when decompressing tar
   * CVE-2019-8321: Escape sequence injection vulnerability in `verbose`
   * CVE-2019-8322: Escape sequence injection vulnerability in `gem owner`
@@ -835,9 +1075,9 @@ Security fixes:
   * CVE-2019-8324: Installing a malicious gem may lead to arbitrary code execution
   * CVE-2019-8325: Escape sequence injection vulnerability in errors
 
-=== 2.7.8 / 2018-11-02
+# 2.7.8 / 2018-11-02
 
-Minor enhancements:
+## Enhancements:
 
 * [Requirement] Treat requirements with == versions as equal. Pull
   request #2230 by Samuel Giddins.
@@ -856,7 +1096,7 @@ Minor enhancements:
 * Improve bindir flag description. Pull request #2383 by Luis Sagastume.
 * Update bundler-1.16.6. Pull request #2423 by SHIBATA Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix #1470: generate documentation when --install-dir is present. Pull
   request #2229 by Elias Hernandis.
@@ -869,9 +1109,9 @@ Bug fixes:
 * Gem::Version should handle nil like it used to before. Pull request
   #2363 by Luis Sagastume.
 
-=== 2.7.7 / 2018-05-08
+# 2.7.7 / 2018-05-08
 
-Minor enhancements:
+## Enhancements:
 
 * [RequestSet] Only suggest a gem version with an installable platform.
   Pull request #2175 by Samuel Giddins.
@@ -886,7 +1126,7 @@ Minor enhancements:
   Sagastume.
 * Backport ruby core commits. Pull request #2264 by SHIBATA Hiroshi.
 
-Bug fixes:
+## Bug fixes:
 
 * Frozen string fix - lib/rubygems/bundler_version_finder.rb. Pull request
   #2115 by MSP-Greg.
@@ -899,16 +1139,19 @@ Bug fixes:
 * Fix path checks for case insensitive filesystem. Pull request #2211 by
   Lars Kanis.
 
-Compatibility changes:
+## Deprecations:
 
 * Deprecate unused code before removing them at #1524. Pull request #2197
   by SHIBATA Hiroshi.
 * Deprecate for rubygems 3. Pull request #2214 by SHIBATA Hiroshi.
 * Mark deprecation to `ubygems.rb` for RubyGems 4. Pull request #2269 by
   SHIBATA Hiroshi.
+
+## Breaking changes:
+
 * Update bundler-1.16.2. Pull request #2291 by SHIBATA Hiroshi.
 
-=== 2.7.6 / 2018-02-16
+# 2.7.6 / 2018-02-16
 
 Security fixes:
 
@@ -917,7 +1160,7 @@ Security fixes:
 * Fix possible Unsafe Object Deserialization Vulnerability in gem owner.
   Fixed by Jonathan Claudius.
 * Strictly interpret octal fields in tar headers.
-  Discoved by plover, fixed by Samuel Giddins.
+  Discovered by plover, fixed by Samuel Giddins.
 * Raise a security error when there are duplicate files in a package.
   Discovered by plover, fixed by Samuel Giddins.
 * Enforce URL validation on spec homepage attribute.
@@ -927,9 +1170,9 @@ Security fixes:
 * Prevent Path Traversal issue during gem installation.
   Discovered by nmalkin.
 
-=== 2.7.5
+# 2.7.5
 
-Bug fixes:
+## Bug fixes:
 
 * To use bundler-1.16.1 #2121 by SHIBATA Hiroshi.
 * Fixed leaked FDs. Pull request #2127 by Nobuyoshi Nakada.
@@ -941,9 +1184,9 @@ Bug fixes:
 * Set whether bundler is used for gemdeps with an environmental variable #2126 by SHIBATA Hiroshi.
 * Fix undefined method error when printing alert #1884 by Robert Ross.
 
-=== 2.7.4
+# 2.7.4
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed leaked FDs. Pull request #2127 by Nobuyoshi Nakada.
 * Avoid to warnings about gemspec loadings in rubygems tests. Pull request
@@ -952,9 +1195,9 @@ Bug fixes:
 * Handle environment that does not have `flock` system call. Pull request
   #2107 by SHIBATA Hiroshi.
 
-=== 2.7.3
+# 2.7.3
 
-Minor enhancements:
+## Enhancements:
 
 * Removed needless version lock. Pull request #2074 by SHIBATA Hiroshi.
 * Add --[no-]check-development option to cleanup command. Pull request
@@ -967,7 +1210,7 @@ Minor enhancements:
 * Remove multi load warning from plugins documentation. Pull request #2103
   by Thibault Jouan.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix test failure on Alpine Linux. Pull request #2079 by Ellen Marie
   Dash.
@@ -986,33 +1229,30 @@ Bug fixes:
 * Use setup command --regenerate-binstubs option flag. Pull request #2099
   by Thibault Jouan.
 
-=== 2.7.2
+# 2.7.2
 
-Bug fixes:
+## Bug fixes:
 
 * Added template files to vendoerd bundler. Pull request #2065 by SHIBATA
   Hiroshi.
 * Added workaround for non-git environment. Pull request #2066 by SHIBATA
   Hiroshi.
 
-=== 2.7.1 (2017-11-03)
+# 2.7.1 (2017-11-03)
 
-Bug fixes:
+## Bug fixes:
 
 * Fix `gem update --system` with RubyGems 2.7+. Pull request #2054 by
   Samuel Giddins.
 
-=== 2.7.0 (2017-11-02)
+# 2.7.0 (2017-11-02)
 
-Major enhancements:
+## Enhancements:
 
 * Update vendored bundler-1.16.0. Pull request #2051 by Samuel Giddins.
 * Use Bundler for Gem.use_gemdeps. Pull request #1674 by Samuel Giddins.
 * Add command `signin` to `gem` CLI. Pull request #1944 by Shiva Bhusal.
 * Add Logout feature to CLI. Pull request #1938 by Shiva Bhusal.
-
-Minor enhancements:
-
 * Added message to uninstall command for gem that is not installed. Pull
   request #1979 by anant anil kolvankar.
 * Add --trust-policy option to unpack command. Pull request #1718 by
@@ -1098,11 +1338,8 @@ Minor enhancements:
 * Warn when requiring deprecated files. Pull request #1939 by Ellen Marie
   Dash.
 
-Compatibility changes:
+## Deprecations:
 
-* Use `-rrubygems` instead of `-rubygems.rb`. Because ubygems.rb is
-  unavailable on Ruby 2.5. Pull request #2028 #2027 #2029
-  by SHIBATA Hiroshi.
 * Deprecate Gem::InstallerTestCase#util_gem_bindir and
   Gem::InstallerTestCase#util_gem_dir. Pull request #1729 by Jon Moss.
 * Deprecate passing options to Gem::GemRunner. Pull request #1730 by Jon
@@ -1110,10 +1347,16 @@ Compatibility changes:
 * Add deprecation for Gem#datadir. Pull request #1732 by Jon Moss.
 * Add deprecation warning for Gem::DependencyInstaller#gems_to_install.
   Pull request #1731 by Jon Moss.
+
+## Breaking changes:
+
+* Use `-rrubygems` instead of `-rubygems.rb`. Because ubygems.rb is
+  unavailable on Ruby 2.5. Pull request #2028 #2027 #2029
+  by SHIBATA Hiroshi.
 * Update Code of Conduct to Contributor Covenant v1.4.0. Pull request
   #1796 by Matej.
 
-Bug fixes:
+## Bug fixes:
 
 * Fix issue for MinGW / MSYS2 builds and testing. Pull request #1876 by
   MSP-Greg.
@@ -1166,7 +1409,7 @@ Bug fixes:
 * [StubSpecification] Don’t iterate through all loaded specs in #to_spec.
   Pull request #1738 by Samuel Giddins.
 
-=== 2.6.14 / 2017-10-09
+# 2.6.14 / 2017-10-09
 
 Security fixes:
 
@@ -1174,7 +1417,7 @@ Security fixes:
   See CVE-2017-0903 for full details.
   Fix by Aaron Patterson.
 
-=== 2.6.13 / 2017-08-27
+# 2.6.13 / 2017-08-27
 
 Security fixes:
 
@@ -1188,9 +1431,9 @@ Security fixes:
   to overwrite arbitrary files. (CVE-2017-0901)
   Discovered by Yusuke Endoh, fix by Samuel Giddins.
 
-=== 2.6.12 / 2017-04-30
+# 2.6.12 / 2017-04-30
 
-Bug fixes:
+## Bug fixes:
 
 * Fix test_self_find_files_with_gemfile to sort expected files. Pull
   request #1880 by Kazuaki Matsuo.
@@ -1211,9 +1454,9 @@ Bug fixes:
 * Allow Gem.finish_resolve to respect already-activated specs. Pull
   request #1910 by Samuel Giddins.
 
-=== 2.6.11 / 2017-03-16
+# 2.6.11 / 2017-03-16
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed broken tests on ruby-head. Pull request #1841 by
   SHIBATA Hiroshi.
@@ -1224,16 +1467,16 @@ Bug fixes:
 * Use improved resolver sorting algorithm. Pull request #1856 by
   Samuel Giddins.
 
-=== 2.6.10 / 2017-01-23
+# 2.6.10 / 2017-01-23
 
-Bug fixes:
+## Bug fixes:
 
 * Fix `require` calling the wrong `gem` method when it is overridden.
   Pull request #1822 by Samuel Giddins.
 
-=== 2.6.9 / 2017-01-20
+# 2.6.9 / 2017-01-20
 
-Bug fixes:
+## Bug fixes:
 
 * Allow initializing versions with empty strings. Pull request #1767 by
   Luis Sagastume.
@@ -1247,9 +1490,9 @@ Bug fixes:
 * RakeBuilder: avoid frozen string issue. Pull request #1819 by Olle
   Jonsson.
 
-=== 2.6.8 / 2016-10-29
+# 2.6.8 / 2016-10-29
 
-Bug fixes:
+## Bug fixes:
 
 * Improve SSL verification failure message. Pull request #1751
   by Eric Hodel.
@@ -1258,9 +1501,9 @@ Bug fixes:
 * Update vendored Molinillo to 0.5.3. Pull request #1763 by
   Samuel Giddins.
 
-=== 2.6.7 / 2016-09-26
+# 2.6.7 / 2016-09-26
 
-Bug fixes:
+## Bug fixes:
 
 * Install native extensions in the correct location when using the
   `--user-install` flag. Pull request #1683 by Noah Kantrowitz.
@@ -1272,24 +1515,24 @@ Bug fixes:
 * Update vendored Molinillo to 0.5.1. Pull request #1714 by
   Samuel Giddins.
 
-=== 2.6.6 / 2016-06-22
+# 2.6.6 / 2016-06-22
 
-Bug fixes:
+## Bug fixes:
 
 * Sort installed versions to make sure we install the latest version when
   running `gem update --system`. As a one-time fix, run
   `gem update --system=2.6.6`. Pull request #1601 by David Radcliffe.
 
-=== 2.6.5 / 2016-06-21
+# 2.6.5 / 2016-06-21
 
-Minor enhancements:
+## Enhancements:
 
 * Support for unified Integer in Ruby 2.4. Pull request #1618
   by SHIBATA Hiroshi.
 * Update vendored Molinillo to 0.5.0 for performance improvements.
   Pull request #1638 by Samuel Giddins.
 
-Bug fixes:
+## Bug fixes:
 
 * Raise an explicit error if Signer#sign is called with no certs. Pull
   request #1605 by Daniel Berger.
@@ -1309,16 +1552,16 @@ Bug fixes:
   Pull request #1644 by Charles Oliver Nutter.
 * Run Bundler tests on TravisCI. Pull request #1650 by Samuel Giddins.
 
-=== 2.6.4 / 2016-04-26
+# 2.6.4 / 2016-04-26
 
-Minor enhancements:
+## Enhancements:
 
 * Use Gem::Util::NULL_DEVICE instead of hard coded strings. Pull request #1588
   by Chris Charabaruk.
 * Use File.symlink on MS Windows if supported. Pull request #1418
   by Nobuyoshi Nakada.
 
-Bug fixes:
+## Bug fixes:
 
 * Redact uri password from error output when gem fetch fails. Pull request
   #1565 by Brian Fletcher.
@@ -1326,9 +1569,9 @@ Bug fixes:
 * Escape user-supplied content served on web pages by `gem server` to avoid
   potential XSS vulnerabilities. Samuel Giddins.
 
-=== 2.6.3 / 2016-04-05
+# 2.6.3 / 2016-04-05
 
-Minor enhancements:
+## Enhancements:
 
 * Lazily calculate Gem::LoadError exception messages. Pull request #1550
   by Aaron Patterson.
@@ -1339,7 +1582,7 @@ Minor enhancements:
 * Show default gems when using "gem list". Pull request #1570 by Luis
   Sagastume.
 
-Bug fixes:
+## Bug fixes:
 
 * Stub ordering should be consistent regardless of how cache is populated.
   Pull request #1552 by Aaron Patterson.
@@ -1355,9 +1598,9 @@ Bug fixes:
   Giddins.
 * Allow two digit version numbers in the tests. Pull request #1575 by unak.
 
-=== 2.6.2 / 2016-03-12
+# 2.6.2 / 2016-03-12
 
-Bug fixes:
+## Bug fixes:
 
 * Fix wrong version of gem activation for bin stub. Pull request #1527 by
   Aaron Patterson.
@@ -1368,9 +1611,9 @@ Bug fixes:
   #1538 by Charles Oliver Nutter.
 
 
-=== 2.6.1 / 2016-02-28
+# 2.6.1 / 2016-02-28
 
-Bug fixes:
+## Bug fixes:
 
 * Ensure `default_path` and `home` are set for paths. Pull request #1513
   by Aaron Patterson.
@@ -1379,9 +1622,9 @@ Bug fixes:
 * Fix invalid gem file preventing gem install from working. Pull request
   #1499 by Luis Sagastume.
 
-=== 2.6.0 / 2016-02-26
+# 2.6.0 / 2016-02-26
 
-Minor enhancements:
+## Enhancements:
 
 * RubyGems now defaults the `gem push` to the gem's "allowed_push_host"
   metadata setting.  Pull request #1486 by Josh Lane.
@@ -1392,7 +1635,7 @@ Minor enhancements:
 * Allow specifying gem requirements via env variables. Pull request #1472
   by Samuel E. Giddins.
 
-Bug fixes:
+## Bug fixes:
 
 * RubyGems now stores `gem push` credentials under the host you signed-in for.
   Pull request #1485 by Josh Lane.
@@ -1418,9 +1661,9 @@ Bug fixes:
 * Find_files only from loaded_gems when using gemdeps. Pull request #1277
   by Michal Papis.
 
-=== 2.5.2 / 2016-01-31
+# 2.5.2 / 2016-01-31
 
-Bug fixes:
+## Bug fixes:
 
 * Fix memoization of Gem::Version#prerelease? Pull request #1125 by Matijs van
   Zuijlen.
@@ -1436,7 +1679,7 @@ Bug fixes:
 * Handle symlinks containing ".." correctly. Pull request #1457 by Samuel E.
   Giddins.
 
-Minor enhancements:
+## Enhancements:
 
 * Add `--no-rc` flag, which skips loading `.gemrc`. Pull request #1329 by Luis
   Sagastume.
@@ -1461,9 +1704,9 @@ Minor enhancements:
 * Function correctly when string literals are frozen on Ruby 2.3. Pull request
   #1408 by Samuel E. Giddins.
 
-=== 2.5.1 / 2015-12-10
+# 2.5.1 / 2015-12-10
 
-Bug fixes:
+## Bug fixes:
 
 * Ensure platform sorting only uses strings. Affected binary installs on Windows.
   Issue #1369 reported by Ryan Atball (among others).
@@ -1492,9 +1735,9 @@ Bug fixes:
   Kudo.
 * Fixed double word typo.  Pull request #1411 by Jake Worth.
 
-=== 2.5.0 / 2015-11-03
+# 2.5.0 / 2015-11-03
 
-Major enhancements:
+## Enhancements:
 
 * Added the Gem::Licenses class which provides a set of standard license
   identifiers as set by spdx.org. This is now used by the
@@ -1503,8 +1746,6 @@ Major enhancements:
 
   Pull request #1249 by Kyle Mitchell.
 
-Minor enhancements:
-
 * Use Molinillo as the resolver library.  This is the same resolver as used by
   Bundler.  Pull request #1189 by Samuel E. Giddins.
 * Add `--skip=gem_name` to Pristine command.  Pull request #1018 by windwiny.
@@ -1566,7 +1807,7 @@ Minor enhancements:
 * Gem::RemoteFetcher allows users to set HTTP headers.  Pull request #1363 by
   Agis Anastasopoulos.
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed Rake homepage url in example for Gem::Specification#homepage.
   Pull request #1171 by Arthur Nogueira Neves
@@ -1623,22 +1864,22 @@ Bug fixes:
 * RubyGems handles invalid config files better.  Pull request #1367 by Agis
   Anastasopoulos.
 
-=== 2.4.8 / 2015-06-08
+# 2.4.8 / 2015-06-08
 
-Bug fixes:
+## Bug fixes:
 
 * Tightened API endpoint checks for CVE-2015-3900
 
-=== 2.4.7 / 2015-05-14
+# 2.4.7 / 2015-05-14
 
-Bug fixes:
+## Bug fixes:
 
 * Limit API endpoint to original security domain for CVE-2015-3900.
   Fix by claudijd
 
-=== 2.4.6 / 2015-02-05
+# 2.4.6 / 2015-02-05
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed resolving gems with both upper and lower requirement boundaries.
   Issue #1141 by Jakub Jirutka.
@@ -1663,9 +1904,9 @@ Bug fixes:
   Ondruch.
 * Relaxed Psych dependency.  Pull request #1128 by Vít Ondruch.
 
-=== 2.4.5 / 2014-12-03
+# 2.4.5 / 2014-12-03
 
-Bug fixes:
+## Bug fixes:
 
 * Improved speed of requiring gems.  (Around 25% for a 60 gem test).  Pull
   request #1060 by unak.
@@ -1705,27 +1946,27 @@ Bug fixes:
 * Fixed grouped expression warning.  Pull request #1081 by André Arko.
 * Fixed handling of platforms when writing lockfiles.
 
-=== 2.4.4 / 2014-11-12
+# 2.4.4 / 2014-11-12
 
-Bug fixes:
+## Bug fixes:
 
 * Add alternate Root CA for upcoming certificate change. Fixes #1050 by
   Protosac
 
-=== 2.4.3 / 2014-11-10
+# 2.4.3 / 2014-11-10
 
-Bug fixes:
+## Bug fixes:
 
 * Fix redefine MirrorCommand issue. Pull request #1044 by @akr.
 * Fix typo in platform= docs.  Pull request #1048 by @jasonrclark
 * Add root SSL certificates for upcoming certificate change.  Fixes #1050 by
   Protosac
 
-=== 2.4.2 / 2014-10-01
+# 2.4.2 / 2014-10-01
 
 This release was sponsored by Ruby Central.
 
-Bug fixes:
+## Bug fixes:
 
 * RubyGems now correctly matches wildcard no_proxy hosts.  Issue #997 by
   voelzemo.
@@ -1759,16 +2000,16 @@ Bug fixes:
 * RubyGems now fails immediately when a git reference cannot be found instead
   of spewing git errors.  Issue #1031 by Michal Papis
 
-=== 2.4.1 / 2014-07-17
+# 2.4.1 / 2014-07-17
 
-Bug fixes:
+## Bug fixes:
 
 * RubyGems can now be updated on Ruby implementations that do not support
   vendordir in RbConfig::CONFIG.  Issue #974 by net1957.
 
-=== 2.4.0 / 2014-07-16
+# 2.4.0 / 2014-07-16
 
-Minor enhancements:
+## Enhancements:
 
 * The contents command now supports a --show-install-dir option that shows
   only the directory the gem is installed in.  Feature request #966 by Akinori
@@ -1779,7 +2020,7 @@ Minor enhancements:
   in Gem.vendor_dir with the --vendor option to gem install.  Issue #943 by
   Marcus Rückert.
 
-Bug fixes:
+## Bug fixes:
 
 * Kernel#gem now respects the prerelease flag when activating gems.
   Previously this behavior was undefined which could lead to bugs when a
@@ -1829,9 +2070,9 @@ Bug fixes:
   during gem resolution.
 
 
-=== 2.3.0 / 2014-06-10
+# 2.3.0 / 2014-06-10
 
-Minor enhancements:
+## Enhancements:
 
 * Added the `open` command which allows you to inspect the source of a gem
   using your editor.
@@ -1872,7 +2113,7 @@ Minor enhancements:
 * RubyGems recommends SPDX IDs for licenses now.  Pull request #917 by
   Benjamin Fleischer.
 
-Bug fixes:
+## Bug fixes:
 
 * RubyGems now only fetches the latest specs to find misspellings which speeds
   up gem suggestions.  Pull request #808 by Aaron Patterson.
@@ -1952,29 +2193,29 @@ Bug fixes:
 * Gem::BasicSpecification#require_paths respects default_ext_dir_for now.  Bug
   #852 by Vít Ondruch.
 
-=== 2.2.5 / 2015-06-08
+# 2.2.5 / 2015-06-08
 
-Bug fixes:
+## Bug fixes:
 
 * Tightened API endpoint checks for CVE-2015-3900
 
-=== 2.2.4 / 2015-05-14
+# 2.2.4 / 2015-05-14
 
-Bug fixes:
+## Bug fixes:
 
 * Backport: Limit API endpoint to original security domain for CVE-2015-3900.
   Fix by claudijd
 
-=== 2.2.3 / 2014-12-21
+# 2.2.3 / 2014-12-21
 
-Bug fixes:
+## Bug fixes:
 
 * Backport: Add alternate Root CA for upcoming certificate change.
   Fixes #1050 by Protosac
 
-=== 2.2.2 / 2014-02-05
+# 2.2.2 / 2014-02-05
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed ruby tests when BASERUBY is not set.  Patch for #778 by Nobuyoshi
   Nakada.
@@ -1999,9 +2240,9 @@ Bug fixes:
 * Restored behavior of Gem::Version::new when subclassed.  Issue #805 by
   Sergio Rubio.
 
-=== 2.2.1 / 2014-01-06
+# 2.2.1 / 2014-01-06
 
-Bug fixes:
+## Bug fixes:
 
 * Platforms in the Gemfile.lock GEM section are now handled correctly.  Bug
   #767 by Diego Viola.
@@ -2027,12 +2268,12 @@ Bug fixes:
 * Fixed specification file sorting for Ruby 1.8.7 compatibility.  Pull
   request #763 by James Mead
 
-=== 2.2.0 / 2013-12-26
+# 2.2.0 / 2013-12-26
 
 Special thanks to Vít Ondruch and Michal Papis for testing and finding bugs in
 RubyGems as it was prepared for the 2.2.0 release.
 
-Major enhancements:
+## Enhancements:
 
 * RubyGems can check for gem dependencies files (gem.deps.rb or Gemfile) when
   rubygems executables are started and uses the found dependencies.  This
@@ -2055,8 +2296,6 @@ Major enhancements:
   The default sharing location may be configured by RubyGems packagers through
   Gem.default_ext_dir_for.  Pull Request #744 by Vít Ondruch.
 
-Minor enhancements:
-
 * RubyGems checks the 'allowed_push_host' metadata value when pushing a gem to
   prevent an accidental push to a public repository (such as rubygems.org).
   If you have private gems you should set this value in your gem specification
@@ -2102,7 +2341,7 @@ Minor enhancements:
 * Relaxed Gem.ruby tests for platforms that override where ruby lives.  Pull
   Request #755 by strzibny.
 
-Bug fixes:
+## Bug fixes:
 
 * RubyGems now returns an error status when any file given to `gem which`
   cannot be found.  Ruby bug #9004 by Eugene Vilensky.
@@ -2119,9 +2358,9 @@ Bug fixes:
 * Improved speed of `gem install --ignore-dependencies`.  Patch by Terence
   Lee.
 
-=== 2.1.11 / 2013-11-12
+# 2.1.11 / 2013-11-12
 
-Bug fixes:
+## Bug fixes:
 
 * Gem::Specification::remove_spec no longer checks for existence of the spec
   to be removed.  Issue #698 by Tiago Macedo.
@@ -2131,9 +2370,9 @@ Bug fixes:
 * The Gem::RemoteFetcher tests now choose the test server port more reliably.
   Pull Request #706 by akr.
 
-=== 2.1.10 / 2013-10-24
+# 2.1.10 / 2013-10-24
 
-Bug fixes:
+## Bug fixes:
 
 * Use class check instead of :version method check when creating Gem::Version
   objects.  Fixes #674 by jkanywhere.
@@ -2152,18 +2391,18 @@ Bug fixes:
 * The --ignore-dependencies option for gem installation works again.  Issue
   #695
 
-=== 2.1.9 / 2013-10-14
+# 2.1.9 / 2013-10-14
 
-Bug fixes:
+## Bug fixes:
 
 * Reduce sorting when fetching specifications.  This speeds up the update and
   outdated commands, and others.  Issue #657 by windwiny.
 * Proxy usernames and passwords are now escaped properly.  Ruby Bug #8979 by
   Masahiro Tomita, Issue #668 by Kouhei Sutou.
 
-=== 2.1.8 / 2013-10-10
+# 2.1.8 / 2013-10-10
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed local installation of platform gem files.  Issue #664 by Ryan Melton.
 * Files starting with "." in the root directory are installed again.  Issue
@@ -2171,9 +2410,9 @@ Bug fixes:
 * The index generator no longer indexes default gems.  Issue #661 by
   Jeremy Hinegardner.
 
-=== 2.1.7 / 2013-10-09
+# 2.1.7 / 2013-10-09
 
-Bug fixes:
+## Bug fixes:
 
 * `gem sources --list` now displays a list of sources.  Pull request #672 by
   Nathan Marley.
@@ -2186,9 +2425,9 @@ Bug fixes:
 * Expand unpack destination directory.  This fixes problems when File.realpath
   is missing and $GEM_HOME contains "..".  Issue #679 by Charles Nutter.
 
-=== 2.1.6 / 2013-10-08
+# 2.1.6 / 2013-10-08
 
-Bug fixes:
+## Bug fixes:
 
 * Added certificates to follow the s3.amazonaws.com certificate change.  Fixes
   #665 by emeyekayee.  Fixes #671 by jonforums.
@@ -2203,7 +2442,7 @@ Bug fixes:
   version.)  Issue #676 by Michal Papis.  Issue wayneeseguin/rvm#2262 by
   Thomas Sänger.
 
-=== 2.1.5 / 2013-09-24
+# 2.1.5 / 2013-09-24
 
 Security fixes:
 
@@ -2212,25 +2451,25 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.1.5, 2.0.10, 1.8.27 and
   1.8.23.2 (for Ruby 1.9.3).
 
-=== 2.1.4 / 2013-09-17
+# 2.1.4 / 2013-09-17
 
-Bug fixes:
+## Bug fixes:
 
 * `gem uninstall foo --all` now force-uninstalls all versions of foo.  Issue
   #650 by Kyle (remkade).
 * Fixed uninstalling gems installed in the home directory (as in
   `--user-install`).  Issue #653 by Lin Jen-Shin.
 
-=== 2.1.3 / 2013-09-12
+# 2.1.3 / 2013-09-12
 
-Bug fixes:
+## Bug fixes:
 
 * Gems with files entries starting with "./" no longer install 0 files.  Issue
   #644 by Darragh Curran, #645 by Brandon Turner, #646 by Alex Tambellini
 
-=== 2.1.2 / 2013-09-11
+# 2.1.2 / 2013-09-11
 
-Bug fixes:
+## Bug fixes:
 
 * Restore concurrent requires following the fix for ruby bug #8374.  Pull
   request #637 and issue #640 by Charles Nutter.
@@ -2239,14 +2478,14 @@ Bug fixes:
 * Gem fetch now fetches the newest (not oldest) gem when --version is given.
   Issue #643 by Brian Shirai.
 
-=== 2.1.1 / 2013-09-10
+# 2.1.1 / 2013-09-10
 
-Bug fixes:
+## Bug fixes:
 
 * Only matching gems matching your local platform are considered for
   installation.  Issue #638 by José M. Prieto, issue #639 by sawanoboly.
 
-=== 2.1.0 / 2013-09-09
+# 2.1.0 / 2013-09-09
 
 Security fixes:
 
@@ -2255,15 +2494,13 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.0.8, 1.8.26 and
   1.8.23.1 (for Ruby 1.9.3).  Issue #626 by Damir Sharipov.
 
-Major enhancements:
+## Enhancements:
 
 * RubyGems uses a new dependency resolver for gem installation which works
   similar to the bundler resolver.  The new resolver can resolve conflicts the
   previous resolver could not and offers improved diagnostics when conflicts
   are discovered.
 
-Minor enhancements:
-
 * RubyGems now has improved platform matching for the ARM architecture.  Gems
   built with a CPU of "arm" will match any specific ARM CPU.  See `gem help
   platform` for further details.  Fixes #532 by Kim Burgestrand.
@@ -2333,7 +2570,7 @@ Minor enhancements:
   still slow, but I see a near 50% improvement for 250 gems on a fast
   connection).  See also Gem::Specification::outdated_and_latest_version
 
-Bug fixes:
+## Bug fixes:
 
 * rubygems_plugin.rb files are now only loaded from the latest installed gem.
 * Fixed Gem.clear_paths when Security is defined at top-level.  Pull request
@@ -2341,29 +2578,29 @@ Bug fixes:
 * Fixed credential creation for `gem push` when `--host` is not given.  Pull
   request #622 by Arthur Nogueira Neves
 
-=== 2.0.17 / 2015-06-08
+# 2.0.17 / 2015-06-08
 
-Bug fixes:
+## Bug fixes:
 
 * Tightened API endpoint checks for CVE-2015-3900
 
-=== 2.0.16 / 2015-05-14
+# 2.0.16 / 2015-05-14
 
-Bug fixes:
+## Bug fixes:
 
 * Backport: Limit API endpoint to original security domain for CVE-2015-3900.
   Fix by claudijd
 
-=== 2.0.15 / 2014-12-21
+# 2.0.15 / 2014-12-21
 
-Bug fixes:
+## Bug fixes:
 
 * Backport: Add alternate Root CA for upcoming certificate change.
   Fixes #1050 by Protosac
 
-=== 2.0.14 / 2013-11-12
+# 2.0.14 / 2013-11-12
 
-Bug fixes:
+## Bug fixes:
 
 * Gem::Specification::remove_spec no longer checks for existence of the spec
   to be removed.  Issue #698 by Tiago Macedo.
@@ -2373,9 +2610,9 @@ Bug fixes:
 * The Gem::RemoteFetcher tests now choose the test server port more reliably.
   Pull Request #706 by akr.
 
-=== 2.0.13 / 2013-10-24
+# 2.0.13 / 2013-10-24
 
-Bug fixes:
+## Bug fixes:
 
 * Use class check instead of :version method check when creating Gem::Version
   objects.  Fixes #674 by jkanywhere.
@@ -2384,16 +2621,16 @@ Bug fixes:
 * Fix updating gems which have multiple platforms.  Issue #693 by Ookami
   Kenrou.
 
-=== 2.0.12 / 2013-10-14
+# 2.0.12 / 2013-10-14
 
-Bug fixes:
+## Bug fixes:
 
 * Proxy usernames and passwords are now escaped properly.  Ruby Bug #8979 by
   Masahiro Tomita, Issue #668 by Kouhei Sutou.
 
-=== 2.0.11 / 2013-10-08
+# 2.0.11 / 2013-10-08
 
-Bug fixes:
+## Bug fixes:
 
 * Added certificates to follow the s3.amazonaws.com certificate change.  Fixes
   #665 by emeyekayee.  Fixes #671 by jonforums.
@@ -2408,7 +2645,7 @@ Bug fixes:
   version.)  Issue #676 by Michal Papis.  Issue wayneeseguin/rvm#2262 by
   Thomas Sänger.
 
-=== 2.0.10 / 2013-09-24
+# 2.0.10 / 2013-09-24
 
 Security fixes:
 
@@ -2417,16 +2654,16 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.1.5, 2.0.10, 1.8.27 and
   1.8.23.2 (for Ruby 1.9.3).
 
-=== 2.0.9 / 2013-09-13
+# 2.0.9 / 2013-09-13
 
-Bug fixes:
+## Bug fixes:
 
 * Gem fetch now fetches the newest (not oldest) gem when --version is given.
   Issue #643 by Brian Shirai.
 * Fixed credential creation for `gem push` when `--host` is not given.  Pull
   request #622 by Arthur Nogueira Neves
 
-=== 2.0.8 / 2013-09-09
+# 2.0.8 / 2013-09-09
 
 Security fixes:
 
@@ -2435,14 +2672,14 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.0.8, 1.8.26 and
   1.8.23.1 (for Ruby 1.9.3).  Issue #626 by Damir Sharipov.
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed Gem.clear_paths when Security is defined at top-level.  Pull request
   #625 by elarkin
 
-=== 2.0.7 / 2013-08-15
+# 2.0.7 / 2013-08-15
 
-Bug fixes:
+## Bug fixes:
 
 * Extensions may now be built in parallel (therefore gems may be installed in
   parallel).  Bug #607 by Hemant Kumar.
@@ -2452,9 +2689,9 @@ Bug fixes:
   Patches by Yui Naruse and Koichi Sasada.
 * Fixed documentation for Kernel#require.
 
-=== 2.0.6 / 2013-07-24
+# 2.0.6 / 2013-07-24
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed the `--no-install` and `-I` options to `gem list` and friends.  Bug
   #593 by Blargel.
@@ -2466,14 +2703,14 @@ Bug fixes:
   Bug #599 by Chris Riesbeck
 * Restored default of remote search to `gem search`.
 
-=== 2.0.5 / 2013-07-11
+# 2.0.5 / 2013-07-11
 
 * Fixed building of extensions that run ruby in their makefiles.  Bug #589 by
   Zachary Salzbank.
 
-=== 2.0.4 / 2013-07-09
+# 2.0.4 / 2013-07-09
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed error caused by gem install not finding the right platform for your
   platform. Bug #576 by John Anderson
@@ -2512,9 +2749,9 @@ Bug fixes:
 * Fix deprecation warnings when converting gemspecs to yaml.  Ruby commit
   r41148 by Yui Naruse
 
-=== 2.0.3 / 2013-03-11
+# 2.0.3 / 2013-03-11
 
-* Bug fixes:
+## Bug fixes:
   * Reverted automatic upgrade to HTTPS as it breaks RubyGems APIs.  Fixes
     #506 by André Arko
   * Use File.realpath to remove extra / while checking if files are
@@ -2529,17 +2766,17 @@ Bug fixes:
   * Fixed default gem key and cert locations.  Pull request #511 by Samuel
     Cochran.
 
-=== 2.0.2 / 2013-03-06
+# 2.0.2 / 2013-03-06
 
-* Bug fixes:
+## Bug fixes:
   * HTTPS URLs are preferred over HTTP URLs.  RubyGems will now attempt to
     upgrade any HTTP source to HTTPS.  Credit to Alex Gaynor.
   * SSL Certificates are now installed properly.  Fixes #491 by hemanth.hm
   * Fixed HTTP to HTTPS upgrade for rubygems.org.
 
-=== 2.0.1 / 2013-03-05
+# 2.0.1 / 2013-03-05
 
-* Bug fixes:
+## Bug fixes:
   * Lazily load RubyGems.org API credentials to avoid failure during
     RubyGems installation.  Bug #465 by Isaac Sanders.
   * RubyGems now picks the latest prerelease to install.  Fixes bug #468 by
@@ -2561,7 +2798,7 @@ Bug fixes:
     Ruby bug #7713 by nobu
   * Fix tests when an 'a.rb' exists.  Ruby bug #7749 by nobu.
 
-=== 2.0.0 / 2013-02-24
+# 2.0.0 / 2013-02-24
 
 RubyGems 2.0 includes several new features and many breaking changes.  Some of
 these changes will cause existing software to break.  These changes are a
@@ -2573,7 +2810,7 @@ newer.  Older versions of bundler will not work with RubyGems 2.0.
 
 Changes since RubyGems 1.8.25 (including past pre-releases):
 
-* Breaking changes:
+## Breaking changes:
 
   * Deprecated Gem.unresolved_deps in favor of
     Gem::Specification.unresolved_deps
@@ -2595,7 +2832,7 @@ Changes since RubyGems 1.8.25 (including past pre-releases):
   * Removed support for Ruby 1.9.1
   * Removed many deprecated methods
 
-* Major enhancements:
+## Enhancements:
 
   * Improved support for default gems shipping with ruby 2.0.0+
   * A gem can have arbitrary metadata through Gem::Specification#metadata
@@ -2613,8 +2850,6 @@ Changes since RubyGems 1.8.25 (including past pre-releases):
     file (Gemfile, Isolate, gem.deps.rb).
     Set RUBYGEMS_GEMDEPS=path to have it loaded. Use - as the path
     to autodetect (current and parent directories are searched).
-
-* Minor enhancements:
   * Added `gem check --doctor` to clean up after failed uninstallation.  Bug
     #419 by Erik Hollensbe
   * RubyGems no longer defaults to uninstalling gems if a dependency would be
@@ -2657,7 +2892,7 @@ Changes since RubyGems 1.8.25 (including past pre-releases):
     GEM_HOME
   * When building gems with non-world-readable files a warning is shown.
 
-* Bug fixes:
+## Bug fixes:
   * Gem.refresh now maintains the active gem list.  Clearing the list would
     cause double-loads which would cause other bugs.  Pull Request #427 by
     Jeremy Evans
@@ -2714,7 +2949,7 @@ Changes since RubyGems 1.8.25 (including past pre-releases):
 
 Changes since RubyGems 2.0.0.rc.2:
 
-* Bug fixes:
+## Bug fixes:
   * Gem.gzip and Gem.gunzip now return strings with BINARY encoding.  Issue
     #450 by Jeremy Kemper
   * Fixed placement of executables with --user-install.  Ruby bug #7779 by Jon
@@ -2727,48 +2962,48 @@ Changes since RubyGems 2.0.0.rc.2:
   * Fixed verification of gems at LowSecurity due to missing signature.
     Thanks to André Arko.
 
-=== 2.0.0.rc.2 / 2013-02-08
+# 2.0.0.rc.2 / 2013-02-08
 
-* Bug fixes:
+## Bug fixes:
   * Fixed signature verification of gems which was broken only on master.
     Thanks to Brian Buchanan.
   * Proper exceptions are raised when verifying an unsigned gem.  Thanks to
     André Arko.
 
-=== 2.0.0.rc.1 / 2013-01-08
+# 2.0.0.rc.1 / 2013-01-08
 
-* Minor enhancements:
+## Enhancements:
   * This release of RubyGems can push gems to rubygems.org.  Ordinarily
     prerelease versions of RubyGems cannot push gems.
   * Added `gem check --doctor` to clean up after failed uninstallation.  Bug
     #419 by Erik Hollensbe
 
-* Bug fixes:
+## Bug fixes:
   * Fixed exception raised when attempting to push gems to rubygems.org.  Bug
     #418 by André Arko
   * Gem installation will fail if RubyGems cannot load the specification from
     the gem.  Bug #419 by Erik Hollensbe
 
-=== 2.0.0.preview2.2 / 2012-12-14
+# 2.0.0.preview2.2 / 2012-12-14
 
-* Minor enhancements:
+## Enhancements:
   * Added a cmake builder.  Pull request #265 by Allan Espinosa.
   * Removed rubyforge page from gem list output
 
-* Bug fixes:
+## Bug fixes:
   * Restored RubyGems 1.8 packaging behavior of omitting directories.  Bug
     #413 by Jeremy Kemper.
 
-=== 2.0.0.preview2.1 / 2012-12-08
+# 2.0.0.preview2.1 / 2012-12-08
 
-* Minor enhancements:
+## Enhancements:
   * Gem::DependencyInstaller now passes build_args down to the installer.
     Pull Request #412 by Sam Rawlins.
   * RubyGems no longer defaults to uninstalling gems if a dependency would be
     broken.  Now you must manually say "yes".  Pull Request #406 by Shannon
     Skipper.
 
-* Bug fixes:
+## Bug fixes:
   * RubyGems tests now run in FIPS mode.  Issue #365 by Vít Ondruch
   * Fixed Gem::Specification#base_dir for default gems.  Ruby Bug #7469
   * Only update the spec cache when we have permission.  Ruby Bug #7509
@@ -2780,13 +3015,13 @@ Changes since RubyGems 2.0.0.rc.2:
   * gem install now ignores directories that match the gem to install.  Bug
     #407 by Santiago Pastorino.
 
-=== 2.0.0.preview2 / 2012-12-01
+# 2.0.0.preview2 / 2012-12-01
 
 This release contains two commits not present in Ruby 2.0.0.preview2.  One
 commit is for ruby 1.8.7 support, the second allows RubyGems to work under
 $SAFE=1.  There is no functional difference compared to Ruby 2.0.0.preview2
 
-* Breaking changes:
+## Breaking changes:
 
   * Deprecated Gem.unresolved_deps in favor of
     Gem::Specification.unresolved_deps
@@ -2808,7 +3043,7 @@ $SAFE=1.  There is no functional difference compared to Ruby 2.0.0.preview2
   * Removed support for Ruby 1.9.1
   * Removed many deprecated methods
 
-* Major enhancements:
+## Enhancements:
 
   * Improved support for default gems shipping with ruby 2.0.0+
   * A gem can have arbitrary metadata through Gem::Specification#metadata
@@ -2826,9 +3061,6 @@ $SAFE=1.  There is no functional difference compared to Ruby 2.0.0.preview2
     file (Gemfile, Isolate, gem.deps.rb).
     Set RUBYGEMS_GEMDEPS=path to have it loaded. Use - as the path
     to autodetect (current and parent directories are searched).
-
-* Minor enhancements:
-
   * Added --only-executables option to `gem pristine`.  Fixes #326
   * Added -I flag for 'gem query' to exclude installed items
   * Added Gem.install(name, version=default) for interactive sessions
@@ -2862,7 +3094,7 @@ $SAFE=1.  There is no functional difference compared to Ruby 2.0.0.preview2
     GEM_HOME
   * When building gems with non-world-readable files a warning is shown.
 
-* Bug fixes:
+## Bug fixes:
 
   * Added PID to setup bin_file while installing RubyGems to protect against
     errors. Fixes #328 by ConradIrwin
@@ -2903,17 +3135,17 @@ $SAFE=1.  There is no functional difference compared to Ruby 2.0.0.preview2
   * URI scheme matching is no longer case-sensitive.  Fixes #322
   * ext/builder now checks $MAKE as well as $make (okkez)
 
-=== 1.8.29 / 2013-11-23
+# 1.8.29 / 2013-11-23
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed installation when the LANG environment variable is empty.
 * Added DigiCert High Assurance EV Root CA to the default SSL certificates for
   cloudfront.
 
-=== 1.8.28 / 2013-10-08
+# 1.8.28 / 2013-10-08
 
-Bug fixes:
+## Bug fixes:
 
 * Added the Verisign Class 3 Public Primary Certification Authority G5
   certificate and its intermediary to follow the s3.amazonaws.com certificate
@@ -2923,7 +3155,7 @@ Bug fixes:
 * Added test for missing certificates for https://s3.amazonaws.com or
   https://rubygems.org.  Pull request #673 by Hannes Georg.
 
-=== 1.8.27 / 2013-09-24
+# 1.8.27 / 2013-09-24
 
 Security fixes:
 
@@ -2932,7 +3164,7 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.1.5, 2.0.10, 1.8.27 and
   1.8.23.2 (for Ruby 1.9.3).
 
-=== 1.8.26 / 2013-09-09
+# 1.8.26 / 2013-09-09
 
 Security fixes:
 
@@ -2941,13 +3173,13 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.0.8, 1.8.26 and
   1.8.23.1 (for Ruby 1.9.3).  Issue #626 by Damir Sharipov.
 
-Bug fixes:
+## Bug fixes:
 
 * Fixed editing of a Makefile with 8-bit characters.  Fixes #181
 
-=== 1.8.25 / 2013-01-24
+# 1.8.25 / 2013-01-24
 
-* Bug fixes:
+## Bug fixes:
   * Added 11627 to setup bin_file location to protect against errors. Fixes
     #328 by ConradIrwin
   * Specification#ruby_code didn't handle Requirement with multiple
@@ -2956,14 +3188,14 @@ Bug fixes:
   * Fix missing load_yaml in YAML-related requirement.rb code.
   * Manually backport encoding-aware YAML gemspec
 
-=== 1.8.24 / 2012-04-27
+# 1.8.24 / 2012-04-27
 
-* 1 bug fix:
+## Bug fixes:
 
   * Install the .pem files properly. Fixes #320
   * Remove OpenSSL dependency from the http code path
 
-=== 1.8.23.2 / 2013-09-24
+# 1.8.23.2 / 2013-09-24
 
 Security fixes:
 
@@ -2972,7 +3204,7 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.1.5, 2.0.10, 1.8.27 and
   1.8.23.2 (for Ruby 1.9.3).
 
-=== 1.8.23.1 / 2013-09-09
+# 1.8.23.1 / 2013-09-09
 
 Security fixes:
 
@@ -2981,7 +3213,7 @@ Security fixes:
   including vulnerable APIs.  Fixed versions include 2.0.8, 1.8.26 and
   1.8.23.1 (for Ruby 1.9.3).  Issue #626 by Damir Sharipov.
 
-=== 1.8.23 / 2012-04-19
+# 1.8.23 / 2012-04-19
 
 This release increases the security used when RubyGems is talking to
 an https server. If you use a custom RubyGems server over SSL, this
@@ -2997,53 +3229,53 @@ You may also set :ssl_verify_mode to 0 to completely disable SSL
 certificate checks, but this is not recommended.
 
 
-* 2 security fixes:
+Security fixes:
   * Disallow redirects from https to http
   * Turn on verification of server SSL certs
 
-* 1 minor feature:
+## Enhancements:
   * Add --clear-sources to fetch
 
-* 2 bug fixes:
+## Bug fixes:
   * Use File.identical? to check if two files are the same.
   * Fixed init_with warning when using psych
 
-=== 1.8.22 / 2012-04-13
+# 1.8.22 / 2012-04-13
 
-* 4 bug fixes:
+## Bug fixes:
 
   * Workaround for psych/syck YAML date parsing issue
   * Don't trust the encoding of ARGV. Fixes #307
   * Quiet default warnings about missing spec variables
   * Read a binary file properly (windows fix)
 
-=== 1.8.21 / 2012-03-22
+# 1.8.21 / 2012-03-22
 
-* 2 bug fixes:
+## Bug fixes:
 
   * Add workaround for buggy yaml output from 1.9.2
   * Force 1.9.1 to remove it's prelude code. Fixes #305
 
-=== 1.8.20 / 2012-03-21
+# 1.8.20 / 2012-03-21
 
-* 4 bug fixes:
+## Bug fixes:
 
   * Add --force to `gem build` to skip validation. Fixes #297
   * Gracefully deal with YAML::PrivateType objects in Marshal'd gemspecs
   * Treat the source as a proper url base. Fixes #304
   * Warn when updating the specs cache fails. Fixes #300
 
-=== 1.8.19 / 2012-03-14
+# 1.8.19 / 2012-03-14
 
-* 3 bug fixes:
+## Bug fixes:
 
   * Handle loading psych vs syck properly. Fixes #298
   * Make sure Date objects don't leak in via Marshal
   * Perform Date => Time coercion on yaml loading. Fixes #266
 
-=== 1.8.18 / 2012-03-11
+# 1.8.18 / 2012-03-11
 
-* 4 bug fixes:
+## Bug fixes:
 
   * Use Psych API to emit more compatible YAML
   * Download and write inside `gem fetch` directly. Fixes #289
@@ -3051,14 +3283,14 @@ certificate checks, but this is not recommended.
   * Search everywhere for a spec for `gem spec`. Fixes #288
   * Fix Gem.all_load_path. Fixes #171
 
-=== 1.8.17 / 2012-02-17
+# 1.8.17 / 2012-02-17
 
-* 2 minor enhancements:
+## Enhancements:
 
   * Add MacRuby to the list of special cases for platforms (ferrous26)
   * Add a default for where to install rubygems itself
 
-* 3 bug fixes:
+## Bug fixes:
 
   * Fixed gem loading issue caused by dependencies not resolving.
   * Fixed umask error when stdlib is required and unresolved dependencies exist.
@@ -3066,57 +3298,59 @@ certificate checks, but this is not recommended.
   * Define SUCKAGE better, ie only MRI 1.9.2
   * Propagate env-shebang to the pristine command if set for install.
 
-=== 1.8.16 / 2012-02-12
+# 1.8.16 / 2012-02-12
 
-* 3 bug fixes:
+## Bug fixes:
 
   * Fix gem specification loading when encoding is not UTF-8. #146
   * Allow group writable if umask allows it already.
   * Uniquify the spec list based on directory order priority
 
-=== 1.8.15 / 2012-01-06
+# 1.8.15 / 2012-01-06
 
-* 1 bug fix:
+## Bug fixes:
 
   * Don't eager load yaml, it creates a bad loop. Fixes #256
 
-=== 1.8.14 / 2012-01-05
+# 1.8.14 / 2012-01-05
 
-* 2 bug fixes:
+## Bug fixes:
 
   * Ignore old/bad cache data in Version
   * Make sure our YAML workarounds are loaded properly. Fixes #250.
 
-=== 1.8.13 / 2011-12-21
+# 1.8.13 / 2011-12-21
 
-* 1 bug fix:
+## Bug fixes:
 
   * Check loaded_specs properly when trying to satisfy a dep
 
-* 2 minor enhancements:
+## Enhancements:
 
   * Remove using #loaded_path? for performance
   * Remove Zlib workaround for Windows build.
 
-=== 1.8.12 / 2011-12-02
+# 1.8.12 / 2011-12-02
+
+## Bug fixes:
 
-* Bug fix:
   * Handle more cases where Syck's DefaultKey showed up in requirements
     and wasn't cleaned out.
 
-=== 1.8.11 / 2011-10-03
+# 1.8.11 / 2011-10-03
+
+## Bug fixes:
 
-* Bug fix:
   * Deprecate was moved to Gem::Deprecate to stop polluting the top-level
     namespace.
 
-=== 1.8.10 / 2011-08-25
+# 1.8.10 / 2011-08-25
 
 RubyGems 1.8.10 contains a security fix that prevents malicious gems from
 executing code when their specification is loaded.  See
 https://github.com/rubygems/rubygems/pull/165 for details.
 
-* 5 bug fixes:
+## Bug fixes:
 
   * RubyGems escapes strings in ruby-format specs using #dump instead of #to_s
     and %q to prevent code injection.  Issue #165 by Postmodern
@@ -3127,21 +3361,21 @@ https://github.com/rubygems/rubygems/pull/165 for details.
   * Fixed Syck DefaultKey infecting ruby-format specifications.
   * `gem uninstall a b` no longer stops if gem "a" is not installed.
 
-=== 1.8.9 / 2011-08-23
+# 1.8.9 / 2011-08-23
 
-* Bug fixes:
+## Bug fixes:
 
   * Fixed uninstalling multiple gems using `gem uninstall`
   * Gem.use_paths splatted to take multiple paths!  Issue #148
 
-=== 1.8.8 / 2011-08-11
+# 1.8.8 / 2011-08-11
 
-* Bug fix:
+## Bug fixes:
   * The encoding of a gem's YAML spec is now UTF-8.  Issue #149
 
-=== 1.8.7 / 2011-08-04
+# 1.8.7 / 2011-08-04
 
-* Bug fixes:
+## Bug fixes:
   * Added missing require for `gem uninstall --format-executable`
   * The correct name of the executable being uninstalled is now displayed with
     --format-executable
@@ -3153,14 +3387,14 @@ https://github.com/rubygems/rubygems/pull/165 for details.
   * Gem repository directories are no longer created world-writable.  Patch by
     Sakuro OZAWA.  Ruby Bug #4930
 
-=== 1.8.6 / 2011-07-25
+# 1.8.6 / 2011-07-25
 
-* 1 minor enhancement:
+## Enhancements:
 
   * Add autorequires and delay startup of RubyGems until require is called.
     See Ruby bug #4962
 
-* 9 bug fixes:
+## Bug fixes:
 
   * Restore behavior of Gem::Specification#loaded?  Ruby Bug #5032
   * Clean up SourceIndex.add_specs to not be so damn noisy. (tadman)
@@ -3172,27 +3406,27 @@ https://github.com/rubygems/rubygems/pull/165 for details.
   * Handle the Syck DefaultKey problem once and for all.
   * Fix SystemStackError occurring with "gem list -r -a" on 1.9.
 
-=== 1.8.5 / 2011-05-31
+# 1.8.5 / 2011-05-31
 
-* 2 minor enhancement:
+## Enhancements:
 
   * The -u option to 'update local source cache' is official deprecated.
   * Remove has_rdoc deprecations from Specification.
 
-* 2 bug fixes:
+## Bug fixes:
 
   * Handle bad specs more gracefully.
   * Reset any Gem paths changed in the installer.
 
-=== 1.8.4 / 2011-05-25
+# 1.8.4 / 2011-05-25
 
-* 1 minor enhancement:
+## Enhancements:
 
   * Removed default_executable deprecations from Specification.
 
-=== 1.8.3 / 2011-05-19
+# 1.8.3 / 2011-05-19
 
-* 4 bug fixes:
+## Bug fixes:
 
   * Fix independent testing of test_gem_package_tar_output.  Ruby Bug #4686 by
     Shota Fukumori
@@ -3201,33 +3435,33 @@ https://github.com/rubygems/rubygems/pull/165 for details.
   * Fixed some bad calls left behind after rolling out some refactorings.
   * Syck has a parse error on (good) times output from Psych. (dazuma, et al)
 
-=== 1.8.2 / 2011-05-11
+# 1.8.2 / 2011-05-11
 
-* 2 minor enhancements:
+## Enhancements:
 
   * Moved #outdated from OutdatedCommand to Specification (for Isolate).
   * Print out a warning about missing executables.
 
-* 3 bug fixes:
+## Bug fixes:
 
   * Added missing requires to fix various upgrade issues.
   * `gem pristine` respects multiple gem repositories.
   * setup.rb now execs with --disable-gems when possible
 
-=== 1.8.1 / 2011-05-05
+# 1.8.1 / 2011-05-05
 
-* 1 minor enhancement:
+## Enhancements:
 
   * Added Gem::Requirement#specific? and Gem::Dependency#specific?
 
-* 4 bug fixes:
+## Bug fixes:
 
   * Typo on Indexer rendered it useless on Windows
   * gem dep can fetch remote dependencies for non-latest gems again.
   * gem uninstall with multiple versions no longer crashes with ArgumentError
   * Always use binary mode for File.open to keep Windows happy
 
-=== 1.8.0 / 2011-04-34
+# 1.8.0 / 2011-04-34
 
 This release focused on properly encapsulating functionality.  Most of this
 work focused on moving functionality out of Gem::SourceIndex and
@@ -3242,7 +3476,7 @@ extensions.  You will need to run `gem pristine gem_with_extension --
 --build-arg` to regenerate a gem with an extension where it requires special
 build arguments.
 
-* 24(+) Deprecations (WOOT!):
+## Deprecations:
 
   * DependencyList.from_source_index deprecated the source_index argument.
   * Deprecated Dependency.new(/regex/).
@@ -3263,14 +3497,11 @@ build arguments.
   * Deprecated all of Gem::GemPathSearcher.
   * Deprecated Gem::Specification#default_executable.
 
-* 2 major enhancements:
+## Enhancements:
 
   * Gem::SourceIndex functionality has been moved to Gem::Specification.
     Gem::SourceIndex is completely disconnected from Gem::Specification
   * Refactored GemPathSearcher entirely out. RIPMF
-
-* 41 minor enhancements:
-
   * Added CommandManager#unregister_command
   * Added Dependency#matching_specs + to_specs.
   * Added Dependency#to_spec
@@ -3318,7 +3549,7 @@ build arguments.
     extensions.
   * `gem pristine` can now restore multiple gems.
 
-* 6 bug fixes:
+## Bug fixes:
 
   * DependencyInstaller passed around a source_index instance but used
     Gem.source_index.
@@ -3330,15 +3561,15 @@ build arguments.
   * `gem pristine` can now restore non-latest gems where the cached gem was
     removed.
 
-=== 1.7.1 / 2011-03-32
+# 1.7.1 / 2011-03-32
 
-* 1 bug fix:
+## Bug fixes:
   * Fixed missing file in Manifest.txt.  (Also a bug in hoe was fixed where
     `rake check_manifest` showing a diff would not exit with an error.)
 
-=== 1.7.0 / 2011-03-32
+# 1.7.0 / 2011-03-32
 
-* 16 Deprecations (woot!)
+## Deprecations:
   * Deprecated Gem.all_load_paths, latest_load_paths, promote_load_path, and
     cache.
   * Deprecated RemoteFetcher#open_uri_or_path.
@@ -3350,7 +3581,7 @@ build arguments.
     test_suite_file(=).
   * Deprecated Specification#has_rdoc= and default_executable=
 
-* 26 minor enhancements:
+## Enhancements:
   * Added stupid simple deprecation module.
   * Added --spec option to `gem unpack` to output a gem's original metadata
   * Added packaging option to Specification#validate
@@ -3382,7 +3613,7 @@ build arguments.
   * UpdateCommand#gems_to_update now returns (name, version) pairs.
   * UpdateCommand#which_to_update now takes an optional system argument.
 
-* 11 bug fixes:
+## Bug fixes:
   * Added missing remote fetcher require to pristine command (aarnell)
   * Building gems now checks to ensure all required fields are non-nil
   * Fix option parser when summary is nil.
@@ -3398,17 +3629,17 @@ build arguments.
     Elias Baixas
   * `gem update` now uniq's command line arguments.
 
-=== 1.6.2 / 2011-03-08
+# 1.6.2 / 2011-03-08
 
-Bug Fixes:
+## Bug fixes:
 
 * require of an activated gem could cause activation conflicts.  Fixes
   Bug #29056 by Dave Verwer.
 * `gem outdated` now works with up-to-date prerelease gems.
 
-=== 1.6.1 / 2011-03-03
+# 1.6.1 / 2011-03-03
 
-Bug Fixes:
+## Bug fixes:
 
 * Installation no longer fails when a dependency from a version that won't be
   installed is unsatisfied.
@@ -3417,9 +3648,9 @@ Bug Fixes:
 * Gem files are cached correctly again.  Patch #29051 by Mamoru Tasaka.
 * Tests now pass with non-022 umask.  Patch #29050 by Mamoru Tasaka.
 
-=== 1.6.0 / 2011-02-29
+# 1.6.0 / 2011-02-29
 
-4 Deprecations:
+## Deprecations:
 
 * RubyGems no longer requires 'thread'.  Rails < 3 will need to add require
   'thread' to their applications.
@@ -3428,14 +3659,11 @@ Bug Fixes:
 * Gem::LoadError#version_requirements has been removed.  Use
   Gem::LoadError#requirement.
 
-2 Major Enhancements:
+## Enhancements:
 
 * Rewrote how Gem::activate (gem and require) resolves dependencies.
 * Gem::LoadError#version_requirement has been removed. Use
   Gem::LoadError#requirement.
-
-17 Minor Enhancments:
-
 * Added --key to `gem push` for setting alternate API keys.
 * Added --format-executable support to gem uninstall.
 * Added Gem::DependencyList#clear.
@@ -3459,7 +3687,7 @@ Bug Fixes:
   locally cached gem specifications.
 * SpecFetcher.fetch_spec can now take a string source_uri.
 
-10 Bug Fixes:
+## Bug fixes:
 
 * Added missing require of Gem::RemoteFetcher to the unpack command.
 * RubyGems now completely removes a previous install when reinstalling.
@@ -3472,28 +3700,28 @@ Bug Fixes:
 * Gem::Security used FileUtils but didn't require it.  Reported by Elia Schito.
 * Gem::Uninstaller now respects --format-executable.
 
-=== 1.5.3 / 2011-02-26
+# 1.5.3 / 2011-02-26
 
-Bug Fixes:
+## Bug fixes:
 
 * Fix for a bug in Syck which causes install failures for gems packaged with
   Psych.  Bug #28965 by Aaron Patterson.
 
-=== 1.5.2 / 2011-02-10
+# 1.5.2 / 2011-02-10
 
-Bug Fixes:
+## Bug fixes:
 
 * Fixed <tt>gem update --system</tt>.  RubyGems can now update itself again.
 
-=== 1.5.1 / 2011-02-09
+# 1.5.1 / 2011-02-09
 
-==== NOTE: `gem update --system` is broken. See UPGRADING.rdoc.
+#= NOTE: `gem update --system` is broken. See UPGRADING.rdoc.
 
-Minor Enhancement:
+## Enhancements:
 
 * Added ability to do gem update --system X.Y.Z.
 
-Bug Fixes:
+## Bug fixes:
 
 * Scrub !!null YAML from 1.9.2 (install and build).
 * Added missing requires for user_interaction.
@@ -3502,17 +3730,14 @@ Bug Fixes:
 * Fixed SilentUI for cygwin; try /dev/null first then fall back to NUL.
 * RubyGems now enforces ruby 1.8.7 or newer.
 
-=== 1.5.0 / 2011-01-31
+# 1.5.0 / 2011-01-31
 
-==== NOTE: `gem update --system` is broken. See UPGRADING.rdoc.
+#= NOTE: `gem update --system` is broken. See UPGRADING.rdoc.
 
-Major Enhancements:
+## Enhancements:
 
 * Finally fixed all known 1.9.x issues. Upgrading is now possible!
 * Merged huge 1.3.7/ruby-core changes to master.
-
-Minor Enhancements:
-
 * Added UPGRADING.rdoc to help deal with 1.9 issues.
 * Gem::Format now gives better errors for corrupt gem files and includes paths
 * Pre-install hooks can now abort gem installation by returning false
@@ -3524,7 +3749,7 @@ Minor Enhancements:
 * Gem::SilentUI now behaves like Gem::StreamUI for asking questions.  Patch by
   Erik Hollensbe.
 
-Bug Fixes:
+## Bug fixes:
 
 * `gem update` was implicitly doing --system.
 * 1.9.3: Fixed encoding errors causing gem installs to die during rdoc phase.
@@ -3536,25 +3761,25 @@ Bug Fixes:
   Erik Hollensbe.
 * rubygems-update lists its development dependencies again
 
-=== 1.4.2 / 2011-01-06
+# 1.4.2 / 2011-01-06
 
-Bug fixes:
+## Bug fixes:
 
 * Gem::Versions: "1.b1" != "1.b.1", but "1.b1" eql? "1.b.1". Fixes gem indexing.
 * Fixed Gem.find_files.
 * Removed otherwise unused #find_all_dot_rb. Only 6 days old and hella buggy.
 
-=== 1.4.1 / 2010-12-31
+# 1.4.1 / 2010-12-31
 
 Since apparently nobody reads my emails, blog posts or the README:
 
 DO NOT UPDATE RUBYGEMS ON RUBY 1.9! See UPGRADING.rdoc for details.
 
-Bug fix:
+## Bug fixes:
 
 * Specification#load was untainting a frozen string (via `gem build *.spec`)
 
-=== 1.4.0 / 2010-12-30
+# 1.4.0 / 2010-12-30
 
 NOTE: In order to better maintain rubygems and to get it in sync with
 the world (eg, 1.9's 1.3.7 is different from our 1.3.7), rubygems is
@@ -3564,7 +3789,7 @@ You have been warned!
 
 NOTE: We've switched to git/github. See README.rdoc for details.
 
-New features:
+## Features:
 
 * Added --launch option to `gem server`. (gthiesfeld)
 * Added fuzzy name matching on install failures. (gstark/presidentbeef)
@@ -3574,7 +3799,7 @@ New features:
 * --source is now additive with your current sources.
   Use --clear-sources first to maintain previous behavior.
 
-Bug fixes:
+## Bug fixes:
 
 * Dependency "~>"s now respect lower-bound prerelease versions.
 * Ensure the gem directories exist on download.
@@ -3585,7 +3810,7 @@ Bug fixes:
   Do not depend on rubygems to require stdlib stuff for you. (raggi/tmm1)
 * Treat 1.0.a10 like 1.0.a.10 for sorting, etc. Fixes #27903. (dchelimsky)
 
-=== 1.3.7 / 2010-05-13
+# 1.3.7 / 2010-05-13
 
 NOTE:
 
@@ -3596,7 +3821,7 @@ http://gems.rubyforge.org with https://rubygems.org/
 
 http://gems.rubyforge.org will continue to work for the foreseeable future.
 
-New features:
+## Features:
 
 * `gem` commands
   * `gem install` and `gem fetch` now report alternate platforms when a
@@ -3615,7 +3840,7 @@ New features:
     in 1.3.6)
 * RubyGems now has platform support for IronRuby.  Patch #27951 by Will Green.
 
-Bug fixes:
+## Bug fixes:
 
 * Require rubygems/custom_require if --disable-gem was set.  Bug #27700 by
   Roger Pack.
@@ -3627,9 +3852,9 @@ Bug fixes:
 * Gem::PackageTask depends on the package dir like the other rake package
   tasks so dependencies can be hooked up correctly.
 
-=== 1.3.6 / 2010-02-17
+# 1.3.6 / 2010-02-17
 
-New features:
+## Features:
 
 * `gem` commands
   * Added `gem push` and `gem owner` for interacting with modern/Gemcutter
@@ -3641,7 +3866,7 @@ New features:
     force rebuilding.  Patch #25982 by Akinori MUSHA.
 * Capital letters are now allowed in prerelease versions.
 
-Bug fixes:
+## Bug fixes:
 
 * Development deps are no longer added to rubygems-update gem so older
   versions can update successfully.
@@ -3660,7 +3885,7 @@ Bug fixes:
 * Gem::RemoteFetcher no longer copies the file if it is where we want it.
   Patch #27409 by Jakub Šťastný.
 
-Deprecation Notices:
+## Deprecations:
 
 * lib/rubygems/timer.rb has been removed.
 * Gem::Dependency#version_requirements is deprecated and will be removed on or
@@ -3669,23 +3894,23 @@ Deprecation Notices:
 * Gem::manage_gems was removed in 1.3.3.
 * Time::today was removed in 1.3.3.
 
-=== 1.3.5 / 2009-07-21
+# 1.3.5 / 2009-07-21
 
-Bug fixes:
+## Bug fixes:
 
 * Fix use of prerelease gems.
 * Gem.bin_path no longer escapes path with spaces. Bug #25935 and #26458.
 
-Deprecation Notices:
+## Deprecations:
 
 * Bulk index update is no longer supported (the code currently remains, but not
   the tests)
 * Gem::manage_gems was removed in 1.3.3.
 * Time::today was removed in 1.3.3.
 
-=== 1.3.4 / 2009-05-03
+# 1.3.4 / 2009-05-03
 
-Bug Fixes:
+## Bug fixes:
 
 * Fixed various warnings
 * Gem::ruby_version works correctly for 1.8 branch and trunk
@@ -3696,16 +3921,16 @@ Bug Fixes:
   drives.  Bug #25882 by Lars Christensen
 * Fix typo in Gem::Requirement#parse.  Bug #26000 by Mike Gunderloy.
 
-Deprecation Notices:
+## Deprecations:
 
 * Bulk index update is no longer supported (the code currently remains, but not
   the tests)
 * Gem::manage_gems was removed in 1.3.3.
 * Time::today was removed in 1.3.3.
 
-=== 1.3.3 / 2009-05-04
+# 1.3.3 / 2009-05-04
 
-New Features:
+## Features:
 
 * `gem server` allows port names (from /etc/services) with --port.
 * `gem server` now has search that jumps to RDoc.  Patch #22959 by Vladimir
@@ -3715,7 +3940,7 @@ New Features:
 * Gem::Specification#has_rdoc= is deprecated and ignored (defaults to true)
 * RDoc is now generated regardless of Gem::Specification#has_rdoc?
 
-Bug Fixes:
+## Bug fixes:
 
 * `gem clean` now cleans up --user-install gems.  Bug #25516 by Brett
   Eisenberg.
@@ -3737,15 +3962,15 @@ Bug Fixes:
 * Raise Gem::LoadError if Kernel#gem fails due to previously-loaded gem.  Bug
   reported by Alf Mikula.
 
-Deprecation Notices:
+## Deprecations:
 
 * Gem::manage_gems has been removed.
 * Time::today has been removed early.  There was no way to make it warn and be
   easy to override with user code.
 
-=== 1.3.2 / 2009-04-15
+# 1.3.2 / 2009-04-15
 
-Select New Features:
+## Features:
 
 * RubyGems now loads plugins from rubygems_plugin.rb in installed gems.
   This can be used to add commands (See Gem::CommandManager) or add
@@ -3773,7 +3998,7 @@ Select New Features:
   * Modern indicies can now be updated incrementally.
   * Legacy indicies can be updated separately from modern.
 
-Select Bugs Fixed:
+## Bug fixes:
 
 * Better gem activation error message. Patch #23082.
 * Kernel methods are now private.  Patch #20801 by James M. Lawrence.
@@ -3799,7 +4024,7 @@ Select Bugs Fixed:
   * Deal with extraneous quotation mark when autogenerating .bat file on MS
     Windows.  Bug #22712.
 
-Deprecation Notices:
+## Deprecations:
 
 * Gem::manage_gems has been removed.
 * Time::today will be removed in RubyGems 1.4.
@@ -3807,9 +4032,9 @@ Deprecation Notices:
 Special thanks to Chad Wooley for backwards compatibility testing and Luis
 Lavena and Daniel Berger for continuing windows support.
 
-=== 1.3.1 / 2008-10-28
+# 1.3.1 / 2008-10-28
 
-Bugs fixed:
+## Bug fixes:
 
 * Disregard ownership of ~ under Windows while creating ~/.gem.  Fixes
   issues related to no uid support under Windows.
@@ -3820,13 +4045,13 @@ Bugs fixed:
 * Gem::location_of_caller now behaves on Windows.  Patch by Daniel Berger.
 * Silence PATH warning.
 
-Deprecation Notices:
+## Deprecations:
 
 * Gem::manage_gems will be removed on or after March 2009.
 
-=== 1.3.0 / 2008-09-25
+# 1.3.0 / 2008-09-25
 
-New features:
+## Features:
 
 * RubyGems doesn't print LOCAL/REMOTE titles for `gem query` and friends if
   stdout is not a TTY, except with --both.
@@ -3840,12 +4065,12 @@ New features:
 * RubyGems now updates the ri cache when the rdoc gem is installed and
   documentation is generated.
 
-Deprecation Notices:
+## Deprecations:
 
 * Gem::manage_gems now warns when called.  It will be removed on or after March
   2009.
 
-Bugs Fixed:
+## Bug fixes:
 
 * RubyGems 1.3.0+ now updates when no previous rubygems-update is installed.
   Bug #20775 by Hemant Kumar.
@@ -3869,7 +4094,7 @@ Bugs Fixed:
 * `gem lock --strict` works again.  Patch #21814 by Sven Engelhardt.
 * Platform detection for Solaris was improved.  Patch #21911 by Bob Remeika.
 
-Other Changes Include:
+## Enhancements:
 
 * `gem help install` now describes _version_ argument to executable stubs
 * `gem help environment` describes environment variables and ~/.gemrc and
@@ -3895,9 +4120,9 @@ Other Changes Include:
 * test/test_ext_configure_builder.rb
   * Locale-free patch by Yusuke Endoh [ruby-core:17444].
 
-=== 1.2.0 / 2008-06-21
+# 1.2.0 / 2008-06-21
 
-New features:
+## Features:
 
 * RubyGems no longer performs bulk updates and instead only fetches the gemspec
   files it needs.  Alternate sources will need to upgrade to RubyGems 1.2 to
@@ -3916,7 +4141,7 @@ New features:
 * setup.rb now handles --vendor and --destdir for packagers
 * `gem stale` command that lists gems by last access time
 
-Bugs Fixed:
+## Bug fixes:
 
 * File modes from gems are now honored, patch #19737
 * Marshal Gem::Specification objects from the future can now be loaded.
@@ -3931,7 +4156,7 @@ Bugs Fixed:
 * Gem::DependencyInstaller resets installed gems every install, bug #19444
 * Gem.default_path is now honored if GEM_PATH is not set, patch #19502
 
-Other Changes Include:
+## Enhancements:
 
 * setup.rb
   * stub files created by RubyGems 0.7.x and older are no longer removed.  When
@@ -3950,9 +4175,9 @@ Other Changes Include:
 * Gem::RemoteFetcher now performs persistent connections for HEAD requests,
   bug #7973
 
-=== 1.1.1 / 2008-04-11
+# 1.1.1 / 2008-04-11
 
-Bugs Fixed:
+## Bug fixes:
 
 * Gem.prefix now returns non-nil only when RubyGems was installed outside
   sitelibdir or libdir.
@@ -3967,9 +4192,9 @@ Bugs Fixed:
 * Gem::RemoteFetcher handles Errno::ECONNABORTED.
 * Printing of release notes fixed.
 
-=== 1.1.0 / 2008-03-29
+# 1.1.0 / 2008-03-29
 
-New features:
+## Features:
 
 * RubyGems now uses persistent connections on index updates.  Index updates are
   much faster now.
@@ -3981,7 +4206,7 @@ New features:
 * `gem spec` now extracts specifications from .gem files.
 * `gem query --installed` to aid automation of checking for gems.
 
-Bugs Fixed:
+## Bug fixes:
 
 * RubyGems works with both Config and RbConfig now.
 * Executables are now cleaned upon uninstall.
@@ -3997,7 +4222,7 @@ Bugs Fixed:
 * Gem stub scripts on windows now work outside Gem.bindir.
 * `gem sources -r` now works without network access.
 
-Other Changes Include:
+## Enhancements:
 
 * RubyGems now requires Ruby > 1.8.3.
 * Release notes are now printed upon installation.
@@ -4008,26 +4233,26 @@ Other Changes Include:
 
 For a full list of changes to RubyGems, see the ChangeLog file.
 
-=== 1.0.1 / 2007-12-20
+# 1.0.1 / 2007-12-20
 
-Bugs Fixed:
+## Bug fixes:
 
 * Installation on Ruby 1.8.3 through 1.8.5 fixed
 * `gem build` on 1.8.3 fixed
 
-Other Changes Include:
+## Enhancements:
 
 * Since RubyGems 0.9.5, RubyGems is no longer supported on Ruby 1.8.2 or older,
   this is official in RubyGems 1.0.1.
 
-=== 1.0.0 / 2007-12-20
+# 1.0.0 / 2007-12-20
 
-Major New Features Include:
+## Features:
 
 * RubyGems warns about various problems with gemspecs during gem building
 * More-consistent versioning for the RubyGems software
 
-Other Changes Include:
+## Enhancements:
 
 * Fixed various bugs and problems with installing gems on Windows
 * Fixed using `gem server` for installing gems
@@ -4041,7 +4266,7 @@ Other Changes Include:
 * `gem unpack` can now unpack into a specific directory with --target
 * OpenSSL is no longer required by default
 
-Deprecations and Deletions:
+## Breaking changes:
 
 * Kernel#require_gem has been removed
 * Executables without a shebang will not be wrapped in a future version, this
@@ -4053,9 +4278,9 @@ Deprecations and Deletions:
 * Gem::Specification#autorequire= has been deprecated
 * Time::today will be removed in a future version
 
-=== 0.9.5 / 2007-11-19
+# 0.9.5 / 2007-11-19
 
-Major New Features Include:
+## Features:
 
 * Platform support
 * Automatic installation of platform gems
@@ -4067,7 +4292,7 @@ Major New Features Include:
 * Improved stubs and `gem.bat` on mswin, including better compatibility
   with the One-Click Installer.
 
-Other Changes Include:
+## Enhancements:
 
 * Time::today is deprecated and will be removed at a future date
 * Gem::manage_gems is deprecated and will be removed at a future date
@@ -4112,13 +4337,13 @@ Special thanks to:
 * Tom Copeland
 * Wilson Bilkovich
 
-=== 0.9.4 / 2007-05-23
+# 0.9.4 / 2007-05-23
 
 If you are experiencing problems with the source index (e.g. strange
 "No Method" errors), or problems with zlib (e.g. "Buffer Error"
 messsage), we recommend upgrading to RubyGems 0.9.4.
 
-Bug Fixes Include:
+## Bug fixes:
 
 * Several people have been experiencing problems with no method errors
   on the source index cache.  The source index cache is now a bit more
@@ -4130,9 +4355,9 @@ Bug Fixes Include:
 * Several sub-commands were accidentally dropped from the "gem" command.
   These commands have been restored.
 
-=== 0.9.3 / 2007-05-10
+# 0.9.3 / 2007-05-10
 
-Bug Fixes Include:
+## Bug fixes:
 
 The ZLib library on Windows will occasionally complains about a buffer error
 when unpacking gems.  The Gems software has a workaround for that problem, but
@@ -4140,19 +4365,19 @@ the workaround was only enabled for versions of ZLib 1.2.1 or earlier.  We
 have received several reports of the error occurring with ZLib 1.2.3, so we
 have permanently enabled the work around on all versions.
 
-=== 0.9.2 / 2007-02-05
+# 0.9.2 / 2007-02-05
 
-Bug Fixes Include:
+## Bug fixes:
 
 * The "unpack" command now works properly.
 * User name and password are now passed properly to the authenticating
   proxy when downloading gems.
 
-=== 0.9.1 / 2007-01-16
+# 0.9.1 / 2007-01-16
 
 See ChangeLog
 
-=== 0.9.0 / 2006-06-28
+# 0.9.0 / 2006-06-28
 
 Finally, the much anticipated RubyGems version 0.9.0 is now available.
 This release includes a number of new features and bug fixes.  The
@@ -4160,7 +4385,7 @@ number one change is that we can now download the gem index
 incrementally.  This will greatly speed up the gem command when only a
 few gems are out of date.
 
-Major Enhancments include:
+## Enhancements:
 
 * The gem index is now downloaded incrementally, only updating entries
   that are out of date.  If more than 50 entries are out of date, we
@@ -4175,9 +4400,6 @@ Major Enhancments include:
 * Both RI and RDOC documents are now generated by default.
 * A gemri command is included to read gem RI docs (only needed for
   Ruby 1.8.4 or earlier).
-
-Minor enhancements include:
-
 * Version 0.0.0 is now a valid gem version.
 * Better detection of missing SSL functionality.
 * SSL is not required if the security policy does not require
@@ -4190,7 +4412,7 @@ Minor enhancements include:
 * .rbw is now a supported suffix for RubyGem's custom require.
 * Several Ruby 1.9 compatibility fixes (Eric Hodel).
 
-Bug Fixes:
+## Bug fixes:
 
 * Added dashes to gemspecs generated in Ruby 1.8.3.  This solves some
   cross-Ruby version compatibility issues.
@@ -4202,7 +4424,7 @@ Bug Fixes:
 * Fixed prefix handling for native expressions (patch by Aaron Patterson).
 * Fixed several Upgrade => Update typos.
 
-=== 0.8.11 / 2005-07-13
+# 0.8.11 / 2005-07-13
 
 * -y is a synonym for --include-dependencies.
 * Better handling of errors in the top level rescue clause.
@@ -4221,7 +4443,7 @@ Bug Fixes:
 * Added David Glasser's install-from-mirror patch.
 * Additional internal structural cleanup and test reorganization.
 
-=== 0.8.10 / 2005-03-27
+# 0.8.10 / 2005-03-27
 
 * In multi-user environments, it is common to supply multiple versions of gems
   (for example Rails), allowing individual users to select the version of the
@@ -4232,16 +4454,16 @@ Bug Fixes:
   installed, then the "gem update --system" command will download a new
   update, but install the latest update prior to the download.
 
-=== 0.8.9
+# 0.8.9
 
 Never released
 
-=== 0.8.8 / 2005-03-14
+# 0.8.8 / 2005-03-14
 
 * Moved the master definition of class Requirement back under version.
   Kept the body of Requirement under Gem.
 
-=== 0.8.7 / 2005-03-14
+# 0.8.7 / 2005-03-14
 
 Even though it has only been a few weeks since that last release,
 there are quite a number of new features in 0.8.7.  A complete list of
@@ -4294,11 +4516,11 @@ file system.  You can read more about them here:
 * gemconfigure: http://docs.rubygems.org/read/chapter/4#page73
 * gemwhich: http://docs.rubygems.org/read/chapter/17
 
-=== 0.8.6 / 2005-02-27
+# 0.8.6 / 2005-02-27
 
 * Fixed a small bug with shebang construction
 
-=== 0.8.5 / 2005-02-26
+# 0.8.5 / 2005-02-26
 
 Do you know how you used to dread getting the following message while
 installing gems?
@@ -4320,7 +4542,7 @@ us.  No RDoc generation was included in the following times.
 The new caching code is at least 3x faster than previous versions.  Woo
 Hoo!
 
-=== 0.8.4 / 2005-01-01
+# 0.8.4 / 2005-01-01
 
 * Rubygems 0.8.3's installer was broken unless you already had an older
   version of RubyGems installed.  That's fixed.
@@ -4330,7 +4552,7 @@ Hoo!
 * Support for lower-cased Gem file names (for you, Paul Duncan :)
 * Erik Veenstra's patch for making Gem versions sortable.
 
-=== 0.8.3 / 2004-12-07
+# 0.8.3 / 2004-12-07
 
 No real earth shattering news here, but there were a number of really
 annoying issues involving other libraries that RubyGems depends upon.
@@ -4372,11 +4594,11 @@ There has been some minor usability enhancements and changes ...
   names.  This was useful for him while testing libs that he had in
   development.
 
-=== 0.8.1 / 2004-09-17
+# 0.8.1 / 2004-09-17
 
 * Quick release to capture some bug fixes.
 
-=== 0.8.0 / 2004-09-15
+# 0.8.0 / 2004-09-15
 
 * Remove need for library stubs.  Set the RUBYOPT environment variable to
   include "rrubygems", and a normal require will find gem files.  Continue to
@@ -4399,15 +4621,15 @@ There has been some minor usability enhancements and changes ...
   to pick.
 * Added "gem unpack" for "unpacking" a gem to the current directory
 
-=== 0.7.0 / 2004-07-09
+# 0.7.0 / 2004-07-09
 
 See ChangeLog
 
-=== 0.6.1 / 2004-06-08
+# 0.6.1 / 2004-06-08
 
 See ChangeLog
 
-=== 0.6.0 / 2004-06-08
+# 0.6.0 / 2004-06-08
 
 * Collapse output of --search and --list (and gem_server) operations so that
   each gem is listed only once, with each of its versions listed on the same
@@ -4420,7 +4642,7 @@ See ChangeLog
     spec.required_ruby_version = "> 1.8.0"
 * --install-stub defaults to true, so library stubs are created
 
-=== 0.5.0 / 2004-06-06
+# 0.5.0 / 2004-06-06
 
 * Jim added the ability to specify version constraints to avoid API
   incompatibilities.  This has been the subject of much debate for the past
@@ -4443,11 +4665,11 @@ See ChangeLog
   automatically included.
 * Some small bug fixes
 
-=== 0.4.0 / 2004-05-30
+# 0.4.0 / 2004-05-30
 
 * Minor bug fixes including Windows compatibility issues
 
-=== 0.3.0 / 2004-04-30
+# 0.3.0 / 2004-04-30
 
 * Cleanup of command-line arguments and handling.  Most commands accept a
   --local or --remote modifier.
@@ -4468,6 +4690,6 @@ See ChangeLog
 * Generally improved error messages (still more work to do)
 * Rearranged gem directory structure for cleanliness.
 
-=== 0.2.0 / 2004-03-14
+# 0.2.0 / 2004-03-14
 
 * Initial public release