From 5fa9e4dca318236740344b42b757f5ccaaee4e77 Mon Sep 17 00:00:00 2001
From: Nathan Sudermann-Merx <45530936+spiralulam@users.noreply.github.com>
Date: Wed, 23 Aug 2023 00:07:17 +0200
Subject: [PATCH] Added installation help for GLPK and CBC for Windows users

---
 docs/installation.rst | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index 3915001..35105f5 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -42,4 +42,19 @@ problems. The most common choices are the commercial solvers `Gurobi <https://ww
 `Xpress <https://www.fico.com/en/products/fico-xpress-optimization>`__ as well as the noncommercial solvers
 `GLPK <https://www.gnu.org/software/glpk/>`__,
 `CBC <https://github.com/coin-or/Cbc/>`__  and `SCIP <https://www.scipopt.org
-/>`__.
\ No newline at end of file
+/>`__.
+
+Some help for Windows users with CBC and GLPK
+-----------------------------------------------------------------
+
+If you are a Windows user and you want to use Pyomo with the free solvers CBC and/or GLPK, here is what you have to do.
+
+1. Install the latest Microsoft Visual C++ Redistributable. You can get them
+   `here <https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170>`_.
+2. Download the binaries. `Here <https://github.com/coin-or/Cbc/releases>`__ are the latest files for CBC and
+   `here <https://sourceforge.net/projects/winglpk/>`__ the files for GLPK, respectively.
+3. Create one folder for each solver and extract the ZIP files there. These folders might be ``C:\CBC`` and ``C:\GLPK``.
+4. Copy the paths containing the executables. In our example, these paths would be ``C:\CBC\bin`` and ``C:\GLPK\glpk-4.65\w64``.
+5. Insert these paths into the environment variable named ``PATH``. You can access this variable under System and
+   Security>>System>>Advanced system settings>>Environment Variables. Then click on `path` in the top window, click the
+   `Edit` button, then `New`.