rubygems-update 3.1.5 → 3.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78a4d800b2d75e1b49ee618dee0f663d8b9cecb90fe46043b65a88865aa4fc78
-  data.tar.gz: a4535a4ee7fd3e14a60c11d1ec8c82c01063c7023f4b5a63070e8dfbc322b3c9
+  metadata.gz: 89d8b149374def285695109ddc454c37bce9e4237c234c5effd43d9cf4ccc26a
+  data.tar.gz: d47581abe6eeacc1037e20a882df82001f5742fb33418d38829c788bb341f073
 SHA512:
-  metadata.gz: 1c0b699ea3e0a12b393e4f54fb2bb095ff26bcb52911d77ae38dbe82d6591e061d6a9e6b99bb475aed7c2ed48a83e81ad36e4eebda065a86aaf3385d553bbeb8
-  data.tar.gz: 3710d47156752e7ef3d4cdf8e1aab2a6e0aaf8e80cc9f79a9314f5774a1ea64d7a40283989e5f8fc6d67e2fb4616531d391d892536155a1f78bb6fab1657c924
+  metadata.gz: 34fe6a294d1aaed49dc46a1a3aecdc211a2fb308a88ab352cbc732a0b9dc8ffdedc0e87302efc29275972051f77a275b8caf3c436538dcbb43e569b75ce1e429
+  data.tar.gz: 10af836317bb8539971af80345a129963d56149affab1a89498abde570c31802a374246c0cee85bf3bdfd6c37d6dcfd1db33677b4db9c5514d6cd5102741be89

data/CODE_OF_CONDUCT.md

@@ -1,45 +1,81 @@
-# Contributor Code of Conduct
+# RubyGems and Bundler Code of Conduct
 
 ## Our Pledge
 
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
 
 ## Our Standards
 
-Examples of behavior that contributes to creating a positive environment include:
+Examples of behavior that contributes to a positive environment for our community include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
 
-Examples of unacceptable behavior by participants include:
+Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
+* The use of sexualized language or imagery, and sexual attention or advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Publishing others' private information, such as a physical or email address, without their explicit permission
 * Other conduct which could reasonably be considered inappropriate in a professional setting
 
-## Our Responsibilities
+## Enforcement Responsibilities
 
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
 
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
 
 ## Scope
 
-This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the [project team](MAINTAINERS.txt). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at team@bundler.io, or directly contacting project team members via email or Slack. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
 
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
+available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
 
 [homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.

data/CONTRIBUTING.md

@@ -42,7 +42,6 @@ To run commands like `gem install` from the repo:
 To run bundler test:
 
     $ cd bundler
-    $ git submodule update --init --recursive
     $ bin/rake spec:deps
     $ bin/rspec spec
 
@@ -65,27 +64,42 @@ can help with. That are marked with a light gray `contribution: *`
 
 ### Type
 
-Most Issues or pull requests will have a light green `type: *` label,  which
-describes the type of the issue or pull request.
+Issues might have a light green `type: *` label,  which describes the type of
+the issue.
 
 *   **bug report** - An issue describing a bug in rubygems. This would be
     something that is broken, confusing, unexpected behavior etc.
-*   **bug fix** - A pull request that fixes a bug report.
 *   **feature request** - An issue describing a request for a new feature or
     enhancement.
-*   **feature implementation** - A pull request implementing a feature
-    request.
 *   **question** - An issue that is a more of a question than a call for
     specific changes in the codebase.
-*   **cleanup** - Generally for a pull request that improves the code base
-    without fixing a bug or implementing a feature.
-*   **major bump** - This issue or pull request requires a major version bump
+*   **cleanup** - An issue that proposes cleanups to the code base without
+    fixing a bug or implementing a feature.
+*   **major bump** - This issue  request requires a major version bump
 *   **administrative** - This issue relates to administrative tasks that need
     to take place as it relates to rubygems
 *   **documentation** - This issue relates to improving the documentation for
     in this repo. Note that much of the rubygems documentation is here:
     https://github.com/rubygems/guides
 
+Pull request might have a light orange `rubygems: *` or a light blue `bundler:
+*` label which describes the pull request according to the following criteria:
+
+*   **security fix** - A pull request that fixes a security issue.
+*   **breaking change** - A pull request including any change that requires a
+    major version bump.
+*   **major enhancement** - A pull request including a backwards compatible
+    change worth a special mention in the changelog
+*   **deprecation** - A pull request that introduces a deprecation.
+*   **feature** - A pull request implementing a feature request.
+*   **deprecation** - A pull request that implements a performance improvement.
+*   **documentation** - A pull request introducing documentation improvements
+    worth mentioning to end users.
+*   **minor enhancements** - A pull request introducing small but user visible changes.
+*   **bug fix** - A pull request that fixes a bug report.
+
+In the case of `bundler`, these labels are set by maintainers on PRs and have
+special importance because they are used to automatically build the changelog.
 
 ### Workflow / Status
 
@@ -152,7 +166,7 @@ an appropriate purple `platform: *` label. Current platform labels:
 ### Git
 
 Please sign your commits. Although not required in order for you to contribute,
-it does ensures that any code submitted by you wasn't altered while you were
+it ensures that any code submitted by you wasn't altered while you were
 transferring it, and proves that it was you who submitted it and not someone
 else.
 

data/History.txt

@@ -1,15 +1,232 @@
-# coding: UTF-8
+=== 3.2.2 / 2020-12-17
 
-=== 3.1.5 / 2020-12-09
+Bug fixes:
 
-Minor enhancements:
+* 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
 
-* Add GlobalSign Root CA - R3 cert and remove outdated certs. Pull request #4100
-  by Aditya Prakash.
+=== 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.
+
+Deprecations:
+
+* Set deprecation warning on query command. Pull request #2967 by Luis
+  Sagastume.
+
+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
 
-Minor enhancements:
+Enhancements:
 
 * Deprecate rubyforge_project attribute only during build
   time. Pull request #3609 by Josef Šimánek.
@@ -20,7 +237,7 @@ Minor enhancements:
 
 === 3.1.3 / 2020-05-05
 
-Minor enhancements:
+Enhancements:
 
 * Resolver: require NameTuple before use. Pull request #3171 by Olle
   Jonsson.
@@ -45,7 +262,7 @@ Bug fixes:
 
 === 3.1.2 / 2019-12-20
 
-Minor enhancements:
+Enhancements:
 
 * Restore non prompting `gem update --system` behavior. Pull request #3040
   by David Rodríguez.
@@ -72,12 +289,9 @@ Bug fixes:
 
 === 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.
@@ -96,15 +310,18 @@ Bug fixes:
 * 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.
 
+Breaking changes:
+
+* Remove 1.8.7 leftovers. Pull request #2972 by David Rodríguez.
+
 === 3.1.0.pre3 / 2019-11-11
 
-Minor enhancements:
+Enhancements:
 
 * Fix gem pristine not accounting for user installed gems. Pull request
   #2914 by Luis Sagastume.
@@ -125,7 +342,7 @@ Minor enhancements:
 
 === 3.1.0.pre2 / 2019-10-15
 
-Minor enhancements:
+Enhancements:
 
 * Optimize Gem::Package::TarReader#each. Pull request #2941 by Jean byroot
   Boussier.
@@ -134,7 +351,7 @@ Minor enhancements:
 
 === 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
@@ -145,9 +362,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
@@ -300,29 +514,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
@@ -331,24 +549,26 @@ 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
 
@@ -358,7 +578,7 @@ Bug fixes:
 
 === 3.0.5 / 2019-08-16
 
-Minor enhancements:
+Enhancements:
 
 * Use env var to configure api key on push. Pull request #2559 by Luis
   Sagastume.
@@ -411,7 +631,7 @@ Bug fixes:
 
 === 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
@@ -468,7 +688,6 @@ Bug fixes:
 
 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`
@@ -478,7 +697,7 @@ Security fixes:
 
 === 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.
@@ -506,7 +725,7 @@ Bug fixes:
 
 === 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.
@@ -514,9 +733,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.
@@ -543,7 +759,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
@@ -575,11 +791,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.
@@ -727,7 +943,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.
@@ -780,44 +996,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
 
-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
 
 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`
@@ -827,7 +1019,7 @@ Security fixes:
 
 === 2.7.8 / 2018-11-02
 
-Minor enhancements:
+Enhancements:
 
 * [Requirement] Treat requirements with == versions as equal. Pull
   request #2230 by Samuel Giddins.
@@ -861,7 +1053,7 @@ Bug fixes:
 
 === 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.
@@ -889,13 +1081,16 @@ 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
@@ -907,7 +1102,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.
@@ -944,7 +1139,7 @@ Bug fixes:
 
 === 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
@@ -994,15 +1189,12 @@ Bug fixes:
 
 === 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
@@ -1088,11 +1280,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
@@ -1100,6 +1289,12 @@ 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.
 
@@ -1272,7 +1467,7 @@ Bug fixes:
 
 === 2.6.5 / 2016-06-21
 
-Minor enhancements:
+Enhancements:
 
 * Support for unified Integer in Ruby 2.4. Pull request #1618
   by SHIBATA Hiroshi.
@@ -1301,7 +1496,7 @@ Bug fixes:
 
 === 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.
@@ -1318,7 +1513,7 @@ Bug fixes:
 
 === 2.6.3 / 2016-04-05
 
-Minor enhancements:
+Enhancements:
 
 * Lazily calculate Gem::LoadError exception messages. Pull request #1550
   by Aaron Patterson.
@@ -1371,7 +1566,7 @@ Bug fixes:
 
 === 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.
@@ -1426,7 +1621,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.
@@ -1484,7 +1679,7 @@ Bug fixes:
 
 === 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
@@ -1493,8 +1688,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.
@@ -1758,7 +1951,7 @@ Bug fixes:
 
 === 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
@@ -1821,7 +2014,7 @@ Bug fixes:
 
 === 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.
@@ -2022,7 +2215,7 @@ Bug fixes:
 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
@@ -2045,8 +2238,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
@@ -2245,15 +2436,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.
@@ -2504,7 +2693,7 @@ Bug fixes:
 
 === 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
@@ -2521,7 +2710,7 @@ Bug fixes:
 
 === 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
@@ -2529,7 +2718,7 @@ Bug fixes:
 
 === 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
@@ -2563,7 +2752,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
@@ -2585,7 +2774,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
@@ -2603,8 +2792,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
@@ -2647,7 +2834,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
@@ -2704,7 +2891,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
@@ -2719,7 +2906,7 @@ Changes since RubyGems 2.0.0.rc.2:
 
 === 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
@@ -2727,13 +2914,13 @@ Changes since RubyGems 2.0.0.rc.2:
 
 === 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
@@ -2741,24 +2928,24 @@ Changes since RubyGems 2.0.0.rc.2:
 
 === 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
 
-* 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
@@ -2776,7 +2963,7 @@ 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
@@ -2798,7 +2985,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
@@ -2816,9 +3003,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
@@ -2852,7 +3036,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
@@ -2937,7 +3121,7 @@ Bug fixes:
 
 === 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
@@ -2948,7 +3132,7 @@ Bug fixes:
 
 === 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
@@ -2987,20 +3171,20 @@ 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
 
-* 4 bug fixes:
+Bug fixes:
 
   * Workaround for psych/syck YAML date parsing issue
   * Don't trust the encoding of ARGV. Fixes #307
@@ -3009,14 +3193,14 @@ certificate checks, but this is not recommended.
 
 === 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
 
-* 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
@@ -3025,7 +3209,7 @@ certificate checks, but this is not recommended.
 
 === 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
@@ -3033,7 +3217,7 @@ certificate checks, but this is not recommended.
 
 === 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
@@ -3043,12 +3227,12 @@ certificate checks, but this is not recommended.
 
 === 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.
@@ -3058,7 +3242,7 @@ certificate checks, but this is not recommended.
 
 === 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.
@@ -3066,37 +3250,39 @@ certificate checks, but this is not recommended.
 
 === 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
 
-* 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 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
 
-* Bug fix:
+Bug fixes:
+
   * Handle more cases where Syck's DefaultKey showed up in requirements
     and wasn't cleaned out.
 
 === 1.8.11 / 2011-10-03
 
-* Bug fix:
+Bug fixes:
+
   * Deprecate was moved to Gem::Deprecate to stop polluting the top-level
     namespace.
 
@@ -3106,7 +3292,7 @@ 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
@@ -3119,19 +3305,19 @@ https://github.com/rubygems/rubygems/pull/165 for details.
 
 === 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
 
-* Bug fix:
+Bug fixes:
   * The encoding of a gem's YAML spec is now UTF-8.  Issue #149
 
 === 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
@@ -3145,12 +3331,12 @@ https://github.com/rubygems/rubygems/pull/165 for details.
 
 === 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)
@@ -3164,25 +3350,25 @@ https://github.com/rubygems/rubygems/pull/165 for details.
 
 === 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 minor enhancement:
+Enhancements:
 
   * Removed default_executable deprecations from Specification.
 
 === 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
@@ -3193,12 +3379,12 @@ https://github.com/rubygems/rubygems/pull/165 for details.
 
 === 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.
@@ -3206,11 +3392,11 @@ https://github.com/rubygems/rubygems/pull/165 for details.
 
 === 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.
@@ -3232,7 +3418,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/).
@@ -3253,14 +3439,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
@@ -3308,7 +3491,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.
@@ -3322,13 +3505,13 @@ build arguments.
 
 === 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
 
-* 16 Deprecations (woot!)
+Deprecations:
   * Deprecated Gem.all_load_paths, latest_load_paths, promote_load_path, and
     cache.
   * Deprecated RemoteFetcher#open_uri_or_path.
@@ -3340,7 +3523,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
@@ -3372,7 +3555,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.
@@ -3390,7 +3573,7 @@ build arguments.
 
 === 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.
@@ -3398,7 +3581,7 @@ Bug Fixes:
 
 === 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.
@@ -3409,7 +3592,7 @@ Bug Fixes:
 
 === 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.
@@ -3418,14 +3601,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.
@@ -3449,7 +3629,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.
@@ -3464,14 +3644,14 @@ Bug Fixes:
 
 === 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
 
-Bug Fixes:
+Bug fixes:
 
 * Fixed <tt>gem update --system</tt>.  RubyGems can now update itself again.
 
@@ -3479,11 +3659,11 @@ Bug Fixes:
 
 ==== 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.
@@ -3496,13 +3676,10 @@ Bug Fixes:
 
 ==== 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
@@ -3514,7 +3691,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.
@@ -3540,7 +3717,7 @@ 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`)
 
@@ -3554,7 +3731,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)
@@ -3586,7 +3763,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
@@ -3619,7 +3796,7 @@ Bug fixes:
 
 === 1.3.6 / 2010-02-17
 
-New features:
+Features:
 
 * `gem` commands
   * Added `gem push` and `gem owner` for interacting with modern/Gemcutter
@@ -3650,7 +3827,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
@@ -3666,7 +3843,7 @@ 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)
@@ -3675,7 +3852,7 @@ Deprecation Notices:
 
 === 1.3.4 / 2009-05-03
 
-Bug Fixes:
+Bug fixes:
 
 * Fixed various warnings
 * Gem::ruby_version works correctly for 1.8 branch and trunk
@@ -3686,7 +3863,7 @@ 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)
@@ -3695,7 +3872,7 @@ Deprecation Notices:
 
 === 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
@@ -3705,7 +3882,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.
@@ -3727,7 +3904,7 @@ 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
@@ -3735,7 +3912,7 @@ Deprecation Notices:
 
 === 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
@@ -3763,7 +3940,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.
@@ -3789,7 +3966,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.
@@ -3799,7 +3976,7 @@ Lavena and Daniel Berger for continuing windows support.
 
 === 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.
@@ -3810,13 +3987,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
 
-New features:
+Features:
 
 * RubyGems doesn't print LOCAL/REMOTE titles for `gem query` and friends if
   stdout is not a TTY, except with --both.
@@ -3830,12 +4007,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.
@@ -3859,7 +4036,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
@@ -3887,7 +4064,7 @@ Other Changes Include:
 
 === 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
@@ -3906,7 +4083,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.
@@ -3921,7 +4098,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
@@ -3942,7 +4119,7 @@ Other Changes Include:
 
 === 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.
@@ -3959,7 +4136,7 @@ Bugs Fixed:
 
 === 1.1.0 / 2008-03-29
 
-New features:
+Features:
 
 * RubyGems now uses persistent connections on index updates.  Index updates are
   much faster now.
@@ -3971,7 +4148,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.
@@ -3987,7 +4164,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.
@@ -4000,24 +4177,24 @@ For a full list of changes to RubyGems, see the ChangeLog file.
 
 === 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
 
-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
@@ -4031,7 +4208,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
@@ -4045,7 +4222,7 @@ Deprecations and Deletions:
 
 === 0.9.5 / 2007-11-19
 
-Major New Features Include:
+Features:
 
 * Platform support
 * Automatic installation of platform gems
@@ -4057,7 +4234,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
@@ -4108,7 +4285,7 @@ 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
@@ -4122,7 +4299,7 @@ Bug Fixes Include:
 
 === 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
@@ -4132,7 +4309,7 @@ have permanently enabled the work around on all versions.
 
 === 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
@@ -4150,7 +4327,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
@@ -4165,9 +4342,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
@@ -4180,7 +4354,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.