Subject: | Add Mac OS X/homebrew info to INSTALL |
A recent ticket patched Makefile.PL to use readline installed via homebrew on the mac.
The attached patch adds some info to the INSTALL doc about it.
Subject: | INSTALL.txt.patch |
--- INSTALL.txt.ORIG 2015-05-17 07:30:24.000000000 -0700
+++ INSTALL.txt 2015-05-17 07:54:16.000000000 -0700
@@ -100,7 +100,35 @@
3. make and install
% make install
-2.1.1. Install on Mac OS X
+2.1.1. Install on Mac OS X with homebrew
+
+ 1. Install [homebrew](http://brew.sh/)
+
+ 2. Use homebrew to install the GNU Readline Library:
+ `brew install readline`
+
+ * Because the GNU Readline library conflicts with the the
+ similarly-named-but-different library installed in the base OS,
+ homebrew does not link readline into /usr/local (it is
+ "keg-only").
+
+ * Makefile.PL uses `brew prefix readline` to find and use the "keg"
+ directory so things work seamlessly.
+
+ 3. Build Term::ReadLine::Gnu as described above:
+ `perl Makefile.PL`
+ `make`
+ `make test`
+ `make install`
+
+ * `brew cleanup` will not remove keg-only formula, to avoid breaking
+ things that have been linked against it. However, if you force
+ it, `brew cleanup --force`, then it will remove the keg-only
+ formula and Term::ReadLine::Gnu will cease to work. You'll need
+ to rebuild Term::ReadLine::GNU so that it links against
+ whichever newer version you have installed.
+
+2.1.2. Install on Mac OS X manually
/usr/bin/perl on Mac OS X 10.5 (Leopard) and later supports
32bit/64bit universal binary. Make Makefile as follows;