README for Yanoff Java Conduit v1.0pre5 General ------- This is a conduit for the Yanoff news reader for Palm OS devices (Palm Pilot). The conduit works in combination with HotSync 3.0 and Yanoff v1.4.4 or later. For development work, you need quite a lot of tools (see below) since this conduit is written in Java and uses a Unix-like development environment (Cygwin), while Windows 95/NT is used as a development platform. If you don't plan to recompile, you only need Yanoff 1.5 and JSync. JSync is part of the CDK-J, but can also be downloaded from the conduit web site. See the COPYRIGHT and COPYING files for details on licensing terms and (the absence of) warranty. See the HISTORY file for version history. The most recent version of this package can be found at http://www.tbm.tudelft.nl/webstaf/janb/yanoff/index.html Needed tools (development only) ------------------------------- Of course you need Yanoff itself, from http://yanoff.sourceforge.net/yanoff/yanoff.html For this conduit, you need version 1.4.4 or higher. You need a 1.1 Java Development Kit, such as jdk-1.1.8 from Sun. Download from http://www.javasoft.com/products/jdk/1.1/ The Makefile is for the Cygnus Solutions CygWin GNU environment for Windows 95/NT. Download from http://sources.redhat.com/cygwin/ You need the JSync Java synchronisation runtime from Palm computing, buried in the "Conduit Development Kit - Java". Download from http://www.palm.com/devzone/cdkjava/cdkjava.html Directories ----------- The Java source files are in the src/ directory. To make things complicated, the class files (Java bytecode) are in the class/ directory. Installation ------------ Quickest installation instructions: 0. Install Yanoff 1. Install JSync (use the JSyncInstaller.exe file) 2. Install the conduit using the .exe-file distribution 4. Try it, and mail me bug-reports! Quick installation instructions: 0. Install Yanoff ;-) 1. Install the CDKJ 2. In the directory you installed the CDKJ in, there is a subdirectory called JSync Installer. Install the JSync runtime from here. 3. Unpack the yancond archive. 4. Use the instructions from the CDKJ to instruct HotSync to use your brand-new Yanoff conduit. You need to run CondCfg.exe from the CDKJ. Add a conduit with creator ID "MJyf", class name "palm.conduit.yanoff.YanoffConduit" and class path: the path you installed yancond, appended with "\java" In my setup, the classpath is "e:\src\yancond\java" 5. Restart the HotSync Manager 6. Try it, and mail me bug-reports! Full installation instructions (if you want to hack the conduit source): 0. Install Yanoff ;-) 1. Install the JDK 2. Install Cygnus Solution's CygWin 3. Install the CDKJ 4. In the directory you installed the CDKJ in, there is a subdirectory called JSync Installer. Install the JSync runtime from here. 5. Unpack the yancond archive, if you haven't already. 6. Edit the Makefile. Set the paths in the first couple of lines 7. do "make" 8. OBSOLETE: use Install.exe instead. If you're daring, type "make install" to insert the settings into the registry Else, you need to run CondCfg.exe from the CDKJ. Add a conduit with creator ID "MJyf", class name "palm.conduit.yanoff.YanoffConduit" and class path of the form PATH1;PATH2 where PATH1 is the path you installed yancond, appended with "\java" and where PATH2 is the path you installed yancond, appended with "\NetComponents.jar". In my setup, the classpath is "d:\java\yancond\java;d:\java\yancond\NetComponents.jar" 9. Restart HotSync Manager 10. Try it, and mail me bug-reports! Hints ----- - The JSync Installer does its job without user interaction. It just copies files, make some registry changes and exits without telling you that it's ready. Don't worry about this behaviour. - Windows 2000 may need a number of restarts to get the conduit working. This may have to do with profiles, or something like that. - Don't set the "Jump back" options in Yanoff's Misc Preferences when you use the conduit. This will confuse Yanoff profoundly, probably leading to a necessary reset of your Palm device. Author ------ This software is written by Jan-Pascal van Best. Reach the author at janpascal(at)vanbest.org