home *** CD-ROM | disk | FTP | other *** search
/ Dream 58 / Amiga_Dream_58.iso / Java / Java.txt < prev    next >
Text File  |  1998-09-16  |  5KB  |  104 lines
  1. ===================================================================================
  2. INTRODUCTION
  3. ===================================================================================
  4. The SyncBuilder framework allows you to develop Java-applications that can connect with 
  5. PalmOS devices. It works independently from Palm Computings HotSync(tm) technology
  6. and is not bound to a specific platform (some functionality currently requires a UNIX-
  7. System such as Linux). 
  8.  
  9. Its functionality includes the ability to read and write records from/to the PalmOS
  10. device, and to query information on the PalmOS device. It also offers special support
  11. for the built-in applications (Calendar, To-Do, Address book, Mail, Expenses, MemoPad).
  12. Finally, it can read and write PDB and PRC-files. It supports both the normal sync through
  13. a serial cable as well as the Network HotSync technology. 
  14. Modem HotSync technology has not been tested and is not expected to work.
  15.  
  16. The SyncBuilder framework is a derivative work of the original Java binding that comes
  17. with pilot-link 0.9.0 by Kenneth Albanowski.
  18. The current goal is to modify the object design so as to make it easier to understand
  19. and easier to use. There is also an ongoing effort to decouple the framework from
  20. the underlying pilot-link software in order to give it more platform independence.
  21.  
  22. ===================================================================================
  23. RECOMMENDED READING - WHERE TO GO FROM HERE
  24. ===================================================================================
  25. Read the installation instructions on the web-site. This will help you to properly
  26. install the framework and get up and running quickly (a local copy of the web-site
  27. is in the docs/website-directory).
  28.  
  29. Study the sample code in the samplecode-directory and its sub-directories. You
  30. might also wish to read tutorials from external sources about the way Palm OS
  31. organizes data. 
  32.  
  33. Read COPYING for a copy of the GNU General Public License version 2.
  34. Read COPYING.LIB for a copy of the GNU Library General Public License version 2.
  35. Read CHANGES.html to see what has already happened. 
  36. Read TODO in order to see a list of long-term goals.
  37. Read FIXME in order to see which bugs and short-term goals exist.
  38.  
  39.  
  40. ===================================================================================
  41. RECOMMENDED TOOLS
  42. ===================================================================================
  43. jikes (by IBM, available at <http://www.alphaworks.ibm.com/formula>) is a blin-
  44. dingly fast Java compiler that will be autodetected by my configuration scripts.
  45. It is HIGHLY recommended!
  46.  
  47. jdeps (by Steven Robbins, available at
  48. <http://www.cs.mcgill.ca/~stever/software/JavaDeps/>) is required for dependancy
  49. generation. This is only needed if you wish to make changes to the software.
  50.  
  51. polardoc (by Tony Gee, available at
  52. <http://www.ualberta.ca/~tgee/polardoc>) is recommended for documentation 
  53. generation. 
  54.  
  55. Together/J Whiteboard Edition (by Object International, available at
  56. <http://www.oi.com>) has done a good job of visualizing the class-hierarchy on
  57. my Linux box and my Windows NT box.
  58.  
  59.  
  60. ===================================================================================
  61. LEGAL DETAILS
  62. ===================================================================================
  63. The original binding is copyrighted (C) 1997,1998 by Kenneth Albanowski.
  64. All the changes are copyrighted (C) 1998 by Tilo Christ.
  65.  
  66. The following disclaimer is in effect for all executable programs
  67. in this package:
  68.  
  69.     This program is free software; you can redistribute it and/or modify
  70.     it under the terms of the GNU General Public License as published by
  71.     the Free Software Foundation; either version 2 of the License, or
  72.     (at your option) any later version.
  73.  
  74.     This program is distributed in the hope that it will be useful,
  75.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  76.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  77.     GNU General Public License for more details.
  78.  
  79.     You should have received a copy of the GNU General Public License
  80.     along with this program; if not, write to the Free Software
  81.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  82.  
  83. The following disclaimer is in effect for all libraries in this package. These 
  84. are all the files which explicitly state that they are under the GNU Library
  85. Public License:
  86.  
  87.     This library is free software; you can redistribute it and/or
  88.     modify it under the terms of the GNU Library General Public
  89.     License as published by the Free Software Foundation; either
  90.     version 2 of the License, or (at your option) any later version.
  91.  
  92.     This library is distributed in the hope that it will be useful,
  93.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  94.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  95.     Library General Public License for more details.
  96.  
  97.     You should have received a copy of the GNU Library General Public
  98.     License along with this library; if not, write to the Free
  99.     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  100.  
  101.  
  102.  
  103.  
  104.