From 1a41b04b89bbc78342848f9b3f23391779ff294c Mon Sep 17 00:00:00 2001 From: Jon Pugh Date: Tue, 4 Sep 2018 20:04:18 -0400 Subject: [PATCH 1/3] Adding Notes about Composer Version Constraints. This explains that to upgrade drupal with the `composer update` command you have to change the `drupal/core` version constraint. --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 395b7aa917..4b1bfe5a69 100644 --- a/README.md +++ b/README.md @@ -75,6 +75,14 @@ Follow the steps below to update your core files. keeping all of your modifications at the beginning or end of the file is a good strategy to keep merges easy. +### Notes about Composer Version Constraints + +The `composer update` will only upgrade your packages within the "version constraints" specified in your `composer.json` file. + +If you use the default version constraint for `drupal/core` used in this project (`~8.5.3`), the `composer upgrade` command will only upgrade `drupal/core` within the `8.5.x` branch (for example to `8.5.4`) + +If you want the `composer update` command to automatically update minor versions, like from `8.5` to `8.6` automatically, set the version of `drupal/core` and `webflo/drupal-core-require-dev` to `~8.5`. + ## Generate composer.json from existing project With using [the "Composer Generate" drush extension](https://www.drupal.org/project/composer_generate) From 80b2cd495b85946e5193dc761cf1c39db19f6dc2 Mon Sep 17 00:00:00 2001 From: Jon Pugh Date: Tue, 4 Sep 2018 20:06:01 -0400 Subject: [PATCH 2/3] Being more specific about what the command will not do. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4b1bfe5a69..b384a67bfd 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ Follow the steps below to update your core files. The `composer update` will only upgrade your packages within the "version constraints" specified in your `composer.json` file. -If you use the default version constraint for `drupal/core` used in this project (`~8.5.3`), the `composer upgrade` command will only upgrade `drupal/core` within the `8.5.x` branch (for example to `8.5.4`) +If you use the default version constraint for `drupal/core` used in this project (`~8.5.3`), the `composer upgrade` command will only upgrade `drupal/core` within the `8.5.x` branch (for example to `8.5.4`). It will _not_ upgrade drupal/core to `8.6.0` when it comes out, unless you change the version constraint. If you want the `composer update` command to automatically update minor versions, like from `8.5` to `8.6` automatically, set the version of `drupal/core` and `webflo/drupal-core-require-dev` to `~8.5`. From 85f0b1009506b4904f5009444ad4b6b959ed375a Mon Sep 17 00:00:00 2001 From: Jon Pugh Date: Tue, 4 Sep 2018 20:07:32 -0400 Subject: [PATCH 3/3] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index b384a67bfd..23ec0e2aa8 100644 --- a/README.md +++ b/README.md @@ -83,6 +83,8 @@ If you use the default version constraint for `drupal/core` used in this project If you want the `composer update` command to automatically update minor versions, like from `8.5` to `8.6` automatically, set the version of `drupal/core` and `webflo/drupal-core-require-dev` to `~8.5`. +Visit the [Composer Versions and Constraints documentation](https://getcomposer.org/doc/articles/versions.md) for more information. + ## Generate composer.json from existing project With using [the "Composer Generate" drush extension](https://www.drupal.org/project/composer_generate)