From 693328724a10fbd6a38ea6def0709e57b41c309b Mon Sep 17 00:00:00 2001
From: "Ian Y. Choi" <ianyrchoi@gmail.com>
Date: Mon, 3 Oct 2016 17:06:52 +0900
Subject: [PATCH] [upstream] Document git-review for new macOS users

Mac OS X El Capitan and macOS Sierra users cannot install
git-review using pip command.

Change-Id: Id4a53299065475b888e91ed9c9d296fa46d54b31
Story: #2000481
---
 doc/upstream-training/source/website/git.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/upstream-training/source/website/git.rst b/doc/upstream-training/source/website/git.rst
index 41e61f01..f6fe00b4 100644
--- a/doc/upstream-training/source/website/git.rst
+++ b/doc/upstream-training/source/website/git.rst
@@ -91,6 +91,21 @@ If you don't have pip installed already, follow the `installation documentation
 <https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py>`_ for
 pip.
 
+.. note::
+
+  Mac OS X El Capitan and macOS Sierra users might see an error
+  message like "Operation not permitted" when installing with the command.
+  In this case, there are two options to successfully install git-review.
+
+  Option 1: install using pip with more options::
+
+    pip install --install-option '--install-data=/usr/local' git-review
+
+  Option 2: Use the package manager `Homebrew <http://brew.sh>`_,
+  and type in a terminal::
+
+    brew install git-review
+
 Linux
 ^^^^^^