From 51abffbc521816ea9351126a7b33a3afbfad31c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Tue, 1 May 2018 20:26:41 +0200
Subject: [PATCH] package/homebrew: provide stable version as well.

---
 doc/building.dox           | 17 ++++++++++++-----
 doc/changelog.dox          |  4 ++++
 package/homebrew/magnum.rb |  2 ++
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/doc/building.dox b/doc/building.dox
index 4111fb3d1..30c3fa0c1 100644
--- a/doc/building.dox
+++ b/doc/building.dox
@@ -210,17 +210,24 @@ There are also Gentoo packages for @ref building-plugins-packages-gentoo "Magnum
 
 macOS [Homebrew](https://brew.sh) formulas building the latest Git revision are
 in the `package/homebrew` directory. Either use the `*.rb` files directly or
-use the tap at https://github.com/mosra/homebrew-magnum. When installing from
-the `*.rb` files you need to install the
-@ref building-corrade-packages-brew "Corrade Homebrew package" first, otherwise
-you can do just this:
+use the tap at https://github.com/mosra/homebrew-magnum. This will install the
+latest stable version of Magnum with all its dependencies:
+
+@code{.sh}
+brew install mosra/magnum/magnum
+@endcode
+
+But often you may want to install the latest Git revision of all Magnum
+projects instead:
 
 @code{.sh}
 brew install --HEAD mosra/magnum/corrade
 brew install --HEAD mosra/magnum/magnum
 @endcode
 
-If you want to pass additional flags to CMake or
+When installing from the `*.rb` files you need to install the
+@ref building-corrade-packages-brew "Corrade Homebrew package" first. If you
+want to pass additional flags to CMake or
 @ref building-features "enable / disable additional features", edit the `*.rb`
 file.
 
diff --git a/doc/changelog.dox b/doc/changelog.dox
index 9cdfa7e84..7213ceaf0 100644
--- a/doc/changelog.dox
+++ b/doc/changelog.dox
@@ -201,6 +201,10 @@ Released 2018-05-01, tagged as
     [mosra/magnum#238](https://github.com/mosra/magnum/issues/238))
 -   Fixed Vcpkg packages to properly copy all plugin and their dependencies
     along the executable (see [mosra/magnum#235](https://github.com/mosra/magnum/issues/235))
+-   Stable version of Magnum is now available as a binary package in the
+    ArchLinux `[community]` repo
+-   Homebrew macOS packages were updated to install the stable version by
+    default
 -   Fixed the Debian package after introducing `SOVERSION` to all libraries
     (see [mosra/magnum#237](https://github.com/mosra/magnum/issues/237))
 -   Fixed the Debian package to not include a revision. While just a warning on
diff --git a/package/homebrew/magnum.rb b/package/homebrew/magnum.rb
index ea5730a23..6938f9821 100644
--- a/package/homebrew/magnum.rb
+++ b/package/homebrew/magnum.rb
@@ -3,6 +3,8 @@
 class Magnum < Formula
   desc "C++11/C++14 graphics middleware for games and data visualization"
   homepage "http://magnum.graphics"
+  url "https://github.com/mosra/magnum/archive/v2018.02.tar.gz"
+  sha256 "e7575e9949952f3436a642c8bb1b98079ce1b6e33d6031695da64c8721833216"
   head "git://github.com/mosra/magnum.git"
 
   depends_on "cmake"