From 2dda24c492e48ea06a41842661932b16edf83cef Mon Sep 17 00:00:00 2001
From: Heitor <heitorPB@users.noreply.github.com>
Date: Sun, 21 Oct 2018 11:47:10 +0200
Subject: [PATCH 1/3] Add installation instructions for pip

Several issues report problems with using `pip install basemap`. A workaround is using the latest version from Github.

Some issues with pip problems:
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index b3b8cba7c..3651df6fd 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,15 @@ prompt.
 To run all the examples (except those that have extra dependencies
 or require an internet connection), execute 'python run_all.py'.
 
+An alternative method is using `pip`:
+
+```
+pip install git+https://github.com/matplotlib/basemap.git
+```
+
+You migh want to run pip with administrative privilegies (e.g. `sudo pip`) or
+perform an user only installation (e.g. `pip install --user`).
+
 ## Contact
 
 Ben Root <ben.v.root@gmail.com>

From 79860caef79f02bc3d4984bc9f188e20ad0dd93a Mon Sep 17 00:00:00 2001
From: Heitor <heitorPB@users.noreply.github.com>
Date: Tue, 23 Oct 2018 11:45:31 +0200
Subject: [PATCH 2/3] Update README.md

---
 README.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 3651df6fd..7553787bc 100644
--- a/README.md
+++ b/README.md
@@ -103,12 +103,9 @@ or require an internet connection), execute 'python run_all.py'.
 An alternative method is using `pip`:
 
 ```
-pip install git+https://github.com/matplotlib/basemap.git
+pip install --user git+https://github.com/matplotlib/basemap.git
 ```
 
-You migh want to run pip with administrative privilegies (e.g. `sudo pip`) or
-perform an user only installation (e.g. `pip install --user`).
-
 ## Contact
 
 Ben Root <ben.v.root@gmail.com>

From 5002950bffa6e3210a2524319a57c382c268251a Mon Sep 17 00:00:00 2001
From: Heitor Pascoal de Bittencourt <heitorpbittencourt@gmail.com>
Date: Sat, 3 Nov 2018 12:26:42 +0100
Subject: [PATCH 3/3] Add deprecation warning to readme

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 7553787bc..c76042008 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,9 @@
 Plot on map projections (with coastlines and political boundaries)
 using matplotlib.
 
+**Warning**: this package is being deprecated in favour of
+[cartopy](https://scitools.org.uk/cartopy/docs/latest/).
+
 ## Requirements
 
 * Python 2.6 (or higher)