LP1817932 Hatch Mac install instructions

Signed-off-by: Bill Erickson <berickxx@gmail.com>

diff --git a/INSTALL.adoc b/INSTALL.adoc
index ec2cc51..2de29bb 100644 (file)
--- a/INSTALL.adoc
+++ b/INSTALL.adoc
@@ -34,7 +34,6 @@ https://addons.mozilla.org/en-US/firefox/addon/hatch-native-messenger/[it is ava
 
 === Continue with xref:using-hatch[Using Hatch] ===
 
-
 anchor:linux[]
 
 == Linux ==
@@ -116,6 +115,88 @@ $ mkdir -p ~/.evergreen
 $ ./hatch.sh test
 -------------------------------------------------------------------------
 
+=== Continue with xref:using-hatch[Using Hatch] ===
+
+anchor:mac[]
+
+== Mac ==
+
+=== Download Hatch Sources
+
+[source,sh]
+-----------------------------------------------------------------------------
+git clone git://git.evergreen-ils.org/Hatch.git
+cd Hatch
+-----------------------------------------------------------------------------
+
+=== Download Java Dependencies
+
+[source,sh]
+-----------------------------------------------------------------------------
+./fetch-deps.sh mac
+-----------------------------------------------------------------------------
+
+=== Compile Hatch ===
+
+[source,sh]
+-------------------------------------------------------------------------
+$ ./hatch.sh compile
+-------------------------------------------------------------------------
+
+=== Configure Native Messaging ===
+
+Edit extension/host/org.evergreen_ils.hatch.(chrome|firefox).json and change the "path"
+value to match the location of your copy of "hatch.sh", found in the root
+directory of the Hatch repository.
+
+Copy the correct host file, changing the filename to org.evergreen_ils.hatch.json, into the browser's configuration directory.
+
+For Chrome:
+
+[source,sh]
+-------------------------------------------------------------------------
+$ mkdir -p ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/
+$ cp extension/host/org.evergreen_ils.hatch.chrome.json ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/org.evergreen_ils.hatch.json
+-------------------------------------------------------------------------
+
+For Chromium:
+
+[source,sh]
+-------------------------------------------------------------------------
+$ mkdir -p ~/Library/Application\ Support/Chromium/NativeMessagingHosts/
+$ cp extension/host/org.evergreen_ils.hatch.chrome.json ~/Library/Application\ Support/Chromium/NativeMessagingHosts/org.evergreen_ils.hatch.json
+-------------------------------------------------------------------------
+
+For Firefox:
+
+[source,sh]
+-------------------------------------------------------------------------
+$ mkdir -p ~/Library/Application\ Support/Mozilla/NativeMessagingHosts/
+$ cp extension/host/org.evergreen_ils.hatch.chrome.json ~/Library/Application\ Support/Mozilla/NativeMessagingHosts/org.evergreen_ils.hatch.json
+-------------------------------------------------------------------------
+
+=== Install Chrome Extension ===
+
+Install the Chrome exenstion directly from the
+https://chrome.google.com/webstore/detail/hatch-native-messenger/ppooibdipmklfichpmkcgplfgdplgahl[Chrome App Store].
+
+=== Install Firefox Extension ===
+
+Install the Firefox extension from the
+https://addons.mozilla.org/en-US/firefox/addon/hatch-native-messenger/[Firefox Addons site].
+
+
+==== Optional: Test Hatch ====
+
+NOTE: print commands are disabled by default in the tests to avoid
+unexpected printing but they can be added by un-commenting
+them in src/org/evergreen_ils/hatch/TestHatch.java and recompiling.
+
+[source,sh]
+-------------------------------------------------------------------------
+$ mkdir -p ~/.evergreen
+$ ./hatch.sh test
+-------------------------------------------------------------------------
 
 anchor:using-hatch[]