contrib/java/README

   1 Libidn README -- Notes for the JAVA API proof of concept.
   2 Copyright (C) 2003, 2004, 2005, 2006, 2007 Simon Josefsson
   3 See the end for copying conditions.
   4
   5 This directory builds Java *.class files that implement the Libidn
   6 API.  Note!  It is unfinished and left as a proof of concept.  A
   7 developer with knowledge about Java is encouraged to take over it.
   8
   9 The current Makefile.am require GCJ.  It was tested with Sun JDK 1.1
  10 and IBM JDK 1.1.8 too, after replacing "gcj" with "javac" and "gcjh"
  11 with "javah" in Makefile.am.  Some combinations of compilation with
  12 one package and executing using another package (e.g., compile with
  13 GCJ, run with Sun's JRE) also seemed to work.
  14
  15 $ ./autogen.sh
  16 $ ./configure
  17 $ make
  18 $ su
  19 # make install
  20 # exit
  21 $ make ExampleIDNA
  22 $ gij ExampleIDNA räksmörgås
  23 xn--rksmrgs-5wao1o
  24 $
  25
  26 Please let me know if you want to finish and maintain the Java API
  27 glue.  It may involve some tedious work initially, but could be useful
  28 for Java developers.
  29
  30 Eventually I think the Java API Glue functions should be merged into
  31 libidn, instead of having a separate libidn-java library.
  32
  33 ----------------------------------------------------------------------
  34 Copying and distribution of this file, with or without modification,
  35 are permitted in any medium without royalty provided the copyright
  36 notice and this notice are preserved.