How to build java-readline on OS X

Background

Building java-readline on OS X requires substantial edits to the Makefiles supplied with the distribuition. To save you the trouble of banging your head against the differences between linux and OS X I've written this up.

Steps

If you don't already have it, get the free Developer Tools from Apple. You need a number of headers that the kit installs.
Download and unzip/untar java-readline from sourceforge: http://sourceforge.net/project/showfiles.php?group_id=48669
You want libreadline-java-0.7.3-src.tar.gz

Download and unzip/untar termcap: ftp://ftp.gnu.org/gnu/termcap/

"./configure" and "make" and "make install" termcap. I put it in /usr/local/lib

Edit the Makefiles in libreadline-java-0.7.3/ and libreadline-java-0.7.3/src/native

in the libreadline-java-0.7.4/ dir make these changes to the Makefile:

The following should variables should be defined, but changes their values like so:

  T_LIBS = JavaReadline #JavaEditline  
  JAVANATINC = $(JAVA_HOME)/include

Add the following:

  JAVA_HOME = /Library/Java/Home

And rename the variable LD_LIBRARY_PATH to DYLD_LIBRARY_PATH (do a search to find it)

   DYLD_LIBRARY_PATH=. java -jar $(JAR) src/test/tinputrc

in the libreadline-java-0.7.3/src/native dir make these changes to the Makefile

  LIBPATH = -L/usr/local/lib  # should be where you put termcap
  CC = cc                    
  CFLAGS=-fno-common

Also change this line:

       $(CC) -shared org_gnu_readline_Readline.o $(LIBPATH) $($(TG)_LIBS) -o $@

to this:

       $(CC) -bundle -flat_namespace -undefined suppress org_gnu_readline_Readl ine.o $(LIBPATH) $($(TG)_LIBS) -o $@

run make: you'll get warnings about symbols, but ignore them. You're successful if you get a .jar file and a .so file in your working directory

since we've built a jni library it has to have .jnilib as a suffix rather than .so. This should be done in the Makefile, but I'm lazy so just did:
```
 mv libJavaReadline.so libJavaReadline.dylib
```
make test : if all goes well you should get a "linux>" prompt

I also skipped make install and just cp'ed libJavaReadline.jnilib to /usr/lib/java and put libreadline-java.jar in /usr/local/java. Put them where you will. According to Apple, standard places for java libraries are the following:
```
     ./
     /usr/lib
     /usr/lib/java
     /lib
     /System/Library/Framworks/JavaVM.framework/Versions/1.3/Libraries
```

You're done.

Useful resources

The fink page on porting linux apps to OSX is where I stole most of the compiler options from. It's got some good, basic information about why things are different under OS X.
Apple's site has some info on jni libraries and standard library paths.

$Header: /home/iancooke/Docs/RCS/HT-install-java-readline-on-osx.html,v 1.5 2002/09/29 00:24:48 iancooke Exp iancooke $