X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=README;h=c0629ca119655bd1e5ec2b850d5b189c3b13805a;hb=ba869bffd750ea4fc87c0283437a5d865c90c79f;hp=ce264f75db1469deb1da027969ac191f91206cf5;hpb=35a1566cbc04eb2af69f2242e844a8c592cc002c;p=yaz4j-moved-to-github.git

diff --git a/README b/README
index ce264f7..c0629ca 100644
--- a/README
+++ b/README
@@ -24,12 +24,26 @@ be updated to match your Swig version. Both can be overriden through:
 
 mvn -Dyaz.path=/path/to/yaz/installation -Dswig=/path/to/swig/binary install
 
-Use the command prompt provided with the Windows SDK. Yaz/bin directory must
-be on the PATH.
+Use the command prompt provided with the Windows SDK.
 
 
-Links
------
+RUNNING A TEST PROGRAM
+
+A trivial test program is included in the yaz4.jar, you can invoke it to check
+the sanity of your yaz4j compilation/installation. On Windows, the YAZ/bin 
+directory (default "C:\Porgam Files\YAZ\bin", if you are using YAZ installer) 
+MUST be on the PATH, otherwise dependent shared libraries will fail to load. 
+Run:
+
+  java -Djava.library.path=/path/to/yaz4j/dll/or/so/dir -jar any/target/yaz4j.jar
+
+Where "/path/to/yaz4j/dll/or/so/dir" points to the directory containing the
+native yaz4j libary (Windows -> yaz4j/win32/target, Unix -> yaz4j/unix/target).
+You can omit this flag, if your yaz4j.dll/so is already available on the 
+library path.
+
+
+LINKS
 
 The following is most probably already outdated, consult Google.