Libidn README -- Notes for the JAVA API proof of concept.
Copyright (C) 2003-2026 Simon Josefsson
See the end for copying conditions.

This directory builds Java *.class files that implement the Libidn
API.  Note!  It is unfinished and left as a proof of concept.  A
developer with knowledge about Java is encouraged to take over it.

The current Makefile.am require GCJ.  It was tested with Sun JDK 1.1
and IBM JDK 1.1.8 too, after replacing "gcj" with "javac" and "gcjh"
with "javah" in Makefile.am.  Some combinations of compilation with
one package and executing using another package (e.g., compile with
GCJ, run with Sun's JRE) also seemed to work.

$ ./autogen.sh
$ ./configure
$ make
$ su
# make install
# exit
$ make ExampleIDNA
$ gij ExampleIDNA räksmörgås
xn--rksmrgs-5wao1o
$

Please let me know if you want to finish and maintain the Java API
glue.  It may involve some tedious work initially, but could be useful
for Java developers.

Eventually I think the Java API Glue functions should be merged into
libidn, instead of having a separate libidn-java library.

----------------------------------------------------------------------
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
