@Database Spitfire².guide @Author Ralph Torchia @(c) 2000 Ralph Torchia @HELP "Terms" @INDEX "INDEX" @$VER: Spitfire²_english.guide v1.1 (21.06.2000) @Macro Ver "V1.1" @Macro _Bullet "@{b}·@{ub} @{LIndent 4}" @Macro _Bullet2 " @{b}·@{ub} @{LIndent 13}" @Macro _Section "@{JLeft}@{LIndent 0}@{u}@{b} $1 @{ub}@{uu}@{LIndent 2}@{Par}@{Line} @SmartWrap @node Main "Spitfire² - AmigaGuide documentation" @next "Preface" @{JCenter} @{u}@{b} Table of contents @{uu}@{ub}@{par} @{FG Highlight}___________________________________________________@{FG Text}@{par} @{b}Spitfire²@{ub}@{Par} AmigaGuide @{Ver} Documentation@{Par} Copyright ©2000 By Ralph Torchia@{Par} @{FG Highlight}___________________________________________________@{FG Text}@{par} @{Line} @{Line} @{b}@{u}Introduction@{uu}@{ub}@{par} @{Line} @{" Preface " link "Preface" 0}@{Par} @{" About Spitfire² " link "About" 0}@{Par} @{" Requirements " link "Requirements" 0}@{Par} @{b}@{u}Legal Issues@{uu}@{ub}@{par} @{Line} @{" License " link "License" 0}@{Par} @{" No Warranty " link "Warranty" 0}@{Par} @{" Disclaimer " link "Disclaimer" 0}@{Par} @{" Shareware " link "Registration" 0}@{Par} @{" Registration Form " link "registrationform" 0}@{Par} @{" Upgrade Form " link "registrationform" 0}@{Par} @{b}@{u}Getting Started@{uu}@{ub}@{par} @{Line} @{" Installation " link "Installation" 0}@{Par} @{" Usage " link "Usage" 0}@{Par} @{" Demo Version " link "Demo" 0}@{Par} @{b}@{u}Other information@{uu}@{ub}@{par} @{Line} @{" Author " link "Author" 0}@{Par} @{" MUI " link "MUI" 0}@{Par} @{" Palmlink " link "Palmlink" 0}@{Par} @{" Acknowledgements " link "Acknowledgements" 0}@{Par} @{" ATO " link "Acknowledgements" 0}@{Par} @{" Trademarks " link "Acknowledgements" 0}@{Par} @{" History " link "History" 0}@{Par} @{" Future " link "Future" 0}@{Par} @{" Mailing List " link "MailingList" 0}@{par} @endnode @node "Preface" "Preface" @next "About" @prev "MAIN" @{_Section "Preface"} @{b}Spitfire²@{ub} is offered to you under the concept of @{i}Shareware@{ui}. You may use @{b}Spitfire²@{ub} for an evaluation period of up to 30 days without paying any fee. If you are going to use @{i}Spitfire²@{ui} after the evaluation period, you have to register.@{par} See @{"License" link "License"} and @{"Shareware" link "Registration"} for more information.@{par} @endnode @node "About" "About" @next "Requirements" @prev "Preface" @{_Section "About Spitfire²"} Spitfire² is a Palm Desktop for the AmigaOS. It provides a connection to 3Com's Palm computer or compatibles, and allows a user to HotSync these devices with their Amiga.@{par} The entire Spitfire² package provides the following main capabilities:@{par} @{_bullet}Allows working with PalmOS applications on your Amiga. Spitfire² provides Date Book, Address Book, To Do List, and Memo Pad applications of the PalmOS so you can view, enter and modify any data stored on your handheld device.@{LIndent 2} @{_bullet}HotSync synchroniztion which enables you to backup the data stored on your handheld device, and synchronize the data with Spitfire².@{LIndent 2} @{_bullet}Import and export capabilities so you can use existing database files as the basis of Address Book or Memo Pad entries.@{LIndent 2} @{_Section "Summary of features"} Spitfire² supports the following main features:@{par} @{_bullet}Partial, Mirror and Full backup of Palm databases and files.@{LIndent 2} @{_bullet}Restoring of Palm databases and files.@{LIndent 2} @{_bullet}Multiple user support.@{LIndent 2} @{_bullet}Installation of PalmOS files and databases.@{LIndent 2} @{_bullet}AmigaOS equivalents of PalmOS Memo Pad, To Do List, Address Book, and Date Book.@{LIndent 2} @{_bullet}Full Synchronizing of Memo Pad, To Do List, Address Book, and Date Book with AmigaOS desktop.@{LIndent 2} @{_bullet}Import/Export of Memos in ASCII format.@{LIndent 2} @{_bullet}Import/Export of Addresses in CSV format.@{LIndent 2} @{_bullet}Import/Export of Address with Contact Manager.@{LIndent 2} @{_bullet}Easy configurability with support for any serial device.@{LIndent 2} @{_bullet}Modular design for easy expansion.@{LIndent 2} @{_bullet}One button HotSyncing!@{LIndent 2} @{_bullet}Localization.@{LIndent 2} @{_bullet}Easy to use interface, with all the customization features of MUI@{LIndent 2} @{LIndent 0} @endnode @node "Requirements" "Requirements" @next "License" @prev "Features" @{_Section "Requirements"} @{_bullet}Amiga with 020/2Mb or better.@{LIndent 2} @{_bullet}An available serial port.@{LIndent 2} @{_bullet}Palm Pilot or compatible with it's cradle plugged into a serial port.@{LIndent 2} @{_bullet}AmigaOS 3.0 or greater.@{LIndent 2} @{_bullet}MUI 3.8 or greater.@{LIndent 2} - third-party MCC classes:@{par} · TextInput@{par} · NList@{par} · MonthNavigator@{par} · DateText@{par} · DateString@{par} · TimeText@{par} · TimeString@{par} @{_bullet}palmlink.library@{LIndent 2} @{_bullet}date.library@{LIndent 2} @{_bullet}vapor_toolkit.library@{LIndent 2} The install script will properly install all necessary parts from the Spitfire² archive.@{par} @endnode @node "License" "License" @next "Warranty" @prev "Requirements" @{_Section "License"} This license applies to the product called @{b}Spitfire²@{ub}, a set of programs for the Amiga computer, published by Ralph Torchia under the concepts of Shareware, and the accompanying documentation, example files and anything else that comes with the original distribution. The terms "Programs" and "@{b}Spitfire²@{ub}" below, refer to this product. The licensee is addressed as "you".@{par} You may copy and distribute verbatim copies of the programs' executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified programs, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original.@{par} You may not copy and/or distribute these programs without the accompanying documentation and other additional files that came with the original. You may not copy and/or distribute modified versions of these programs. You may not copy, modify, sublicense, distribute or transfer the programs except as expressly provided under this license. Any attempt otherwise to copy, modify, sublicense, distribute or transfer the programs is void, and will automatically terminate your rights to use the programs under this license. However, parties who have received copies, or rights to use copies, from you under this license will not have their licenses terminated so long as such parties remain in full compliance.@{par} By copying, distributing and/or using the programs you indicate your acceptance of this license to do so, and all its terms and conditions.@{par} Each time you redistribute the programs, the recipient automatically receives a license from the original licensor to copy, distribute and/or use the programs subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein.@{par} You may not disassemble, decompile, re-source or otherwise reverse engineer the programs.@{par} You may use the programs for a period of up to 30 days for evaluation. After that, you have to @{"register" link Registration}.@{par} If you wish to incorporate parts of the programs into other programs, write to the author to ask for permission.@{par} You agree to cease distributing the programs and data involved if requested to do so by the author.@{par} @endnode @node "Warranty" "No Warranty" @next "Disclaimer" @prev "License" @{_Section "No warranty"} There is no warranty for the programs, to the extent permitted by applicable law. Except when otherwise stated in writing the copyright holder and/or other parties provide the programs "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the programs is with you. Should the programs prove defective, you assume the cost of all necessary servicing, repair or correction.@{par} In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may redistribute the programs as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the programs (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the programs to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages.@{par} @endnode @node "Disclaimer" "Disclaimer" @next "Installation" @prev "Warranty" @{_Section "Disclaimer"} No warranty, either express or implied, is made with respect to the fitness or merchantability of @{b}Spitfire²@{ub}.@{par} @{b}Ralph Torchia@{ub} (referred to as "the author"), reserves the right to not develop any future versions of @{b}Spitfire²@{ub}.@{par} The author will try to make a good faith attempt at correcting any problems if any are discovered, but is in no way required, nor bound to correct them.@{par} The author neither assumes nor accepts any responsibility for the use or misuse of these programs. He also will not be held liable for damages or any compensation due to loss of profit or any other damages arising out of the use, or inability to use these programs.@{par} The author will not be liable for any damage arising from the failure of these programs to perform as described, or any destruction of other programs or data residing on a system attempting to run the programs. While I know of no damaging errors, the user of these programs uses it at his or her own risk.@{par} @endnode @node "Installation" "Installation" @next "Usage" @prev "Dislaimer" @{_Section "Installation"} @{LIndent 2} 1) @{LIndent 5}With your Amiga turned off, plug the Palm cradle into an available serial port. If your Amiga only has a 25-pin serial port then a 9-pin to 25-pin adapter will be required to plug the Palm's cradle into the Amiga's standard serial port.@{LIndent 2} 2) @{LIndent 5}Use the Installer to copy the Spitfire² files to your hard drive. The installer uses the standard Amiga installer program and will install Spitfire² and its appropriate files onto your hard drive.@{LIndent 2} @{Line} @{Line} When Spitfire² is executed for the fist time on a system, it will ask the user:@{par} 1) @{LIndent 5}To set up the preferences and serial port settings that the cradle is connected to.@{LIndent 2} 2) @{LIndent 5}To perform a HotSync of the Palm (therefore be sure to have your Palm ready and its cradle connected to your Amiga).@{LIndent 2} This first time procedure will allow Spitfire² to establish the proper accounts on your Palm and Amiga.@{par} If your Palm has already been HotSync with another computer, then Spitfire² will recognize this and create a new account on your Amiga. It will not overwrite a user name established on a Palm unless specifically told to do so. @endnode @node "Usage" "Usage" @next "TipsAndTricks" @prev "Installation" @{_Section "Usage"} Spitfire² consists of two main applications:@{Line} @{JLeft}@{LIndent 0}(1) Hotsync Manager (SpitfireHSM)@{LIndent 6}@{par} This is the core of Spitfire², and controls all the hotsync procedures. Since HSM is an MUI application you can use the MUI prefs to set many of its features and look. The HSM also gives access to customization of the serial port for hotsyncing, viewing of log files, and customizing of available conduits. @{LIndent 2}@{Line} @{JLeft}@{LIndent 0}(2) Desktop Application Manager (SpitfireDAM)@{LIndent 6}@{par} This is a small program that allows easy access to the desktop applications. It can be launced from the HSM or from the Workbench. @{LIndent 0} @{_Section "Conduits"} A conduit determines how records are handled during a hotsync. Each application has its own conduit, or uses the normal system conduit for hotsyncing. Spitfire² defaults to synchronizing of all files between the handheld device and the Amiga. Generally, you should leave the settings to synchronize all files. In addition to the standard Address Book, Date Book, Memo Pad, and To Do List conduits, Spitfire² has a System and Install conduits. The System conduit backs up the system information stroed in your handheld device. The default setting for this conduit is Mirror backups, which will maintain mirror copies of system information on the handheld and the Amiga; in otherwords, files are synchronized. Partial backup will only backup application which have a "backup" flag set for them by the application itself. Complete backup will copy all files from the handheld to the Amiga. The Install conduit is used to install PalmOS applications. @{i}Refer to the Palm's User manual for help with terms and operation.@{ui} @endnode @node "TipsAndTricks" "Tips And Tricks" @next "Author" @prev "Usage" None for now... @endnode @node "Author" "Author" @next "Acknowledgements" @prev "TipsAndTricks" @{_Section "Author"} Ralph Torchia, B.Sc., D.D.S. Mail : 3069 Suffolk Windsor, Ontario Canada N8R 1P1 Email : torchia@windsor.igs.net Homepage: http://www.windsor.igs.net/~torchia/ @endnode @node "MUI" "MUI - Magic User Interface" @prev "MAIN" @next "MAIN" @{JCenter}@{b}MUI - MagicUserInterface@{ub} © 1993/96 by Stefan Stuntz @{JLeft} MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. @{JCenter}If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @{JLeft} @endnode @node "Palmlink" "Palmlink" @prev "MAIN" @next "MAIN" @{jcenter} This application uses@{par} Palmlink.library@{par} (c) Copyright 1998 by Richard Körber@{par} The palmlink.library archive can be found on Aminet and at:@{par} http://shredzone.home.pages.de/@{par} @{jright} E-Mail: richard.koerber@koeln.netsurf.de@{par} shred@eratosthenes.starfleet.de@{par} @endnode @node "Acknowledgements" "Acknowledgements" @next "History" @prev "Author" @{_Section "Acknowledgements"} @{_bullet}USRobotics/3Com for the wonderful Palm!@{LIndent 2} @{_bullet}Richard Körber for the excellent PalmLink library.@{LIndent 2} @{_bullet}Szymon Ulatowski for the emails and programming tips on plug-in design.@{LIndent 2} @{_bullet}Ingo Heinicke and Dhomas Trenn for beta testing.@{LIndent 2} @{_bullet}Oliver Wagner for the Textinput MUI classes.@{LIndent 2} @{_bullet}Amiga Foundation Classes (http://www.intercom.it/~fsoft/afc.html) for their wonderful classes that made developing Spitfire² easier in many ways.@{LIndent 2} @{_bullet}Kai Hofmann for date.library, MonthNavigator, DateXXX and TimeXXX MUI class.@{LIndent 2} @{_bullet}Phil Vedovatti for the Newicon images and icons.@{LIndent 2} @{_bullet}Joachim Betz & Ingo Heinicke for the German catalog translations.@{LIndent 2} And to all those that have registered Spitfire and Spitfire², a big THANK-YOU! @{LIndent 0} @{_Section "ATO (Amiga Translators' Organization)"} This software was translated with the help of ATO, the Amiga Translators' Organization. ATO is a non-profit organization that translates for the Amiga community. The following members were involved in this project:@{par} @{_bullet}Czech:@{LIndent 2} @{_bullet2}Translator: Vit Sindlar @{LIndent 2} @{_bullet2}Proofreader: Vit Sindlar @{LIndent 2} @{_bullet}Italian:@{LIndent 2} @{_bullet2}Translator: Maurizio Lotauro @{LIndent 2} @{_bullet2}Proofreader: Stefano Guarnieri @{LIndent 2} @{_bullet}Portuguese:@{LIndent 2} @{_bullet2}Translator: Rúben Alvim @{LIndent 2} @{_bullet2}Proofreader: Joel Alvim @{LIndent 2} @{_bullet}Russian:@{LIndent 2} @{_bullet2}Translator: Oleg Sergeev @{LIndent 2} @{_bullet2}Proofreader: Andrew Boyarintsev @{LIndent 2} @{_bullet}Slovenian:@{LIndent 2} @{_bullet2}Translator: Damir Arh @{LIndent 2} @{_bullet2}Proofeader: Bostjan Cargo @{LIndent 2} @{_bullet}Swedish:@{LIndent 2} @{_bullet2}Translator: Erik Johansson @{LIndent 2} @{_bullet2}Proofreader: Kristoffer Larsson @{LIndent 2} @{JCenter} -**-@{par} @{i}Amiga Translators' Organization@{ui}@{par} http://ato.vapor.com/ato/@{par} E-mail:ato-info@ato.vapor.com@{par} @{JLeft} @{_Section "Trademarks"} @{_bullet}Palm and PalmOS are trademarks of 3Com.@{LIndent 2} @{_bullet}3Com and HotSync are registered trademarks of 3Com.@{LIndent 2} @{_bullet}All other copyrights and trademarks are held by their owners. @endnode @node "History" "History" @next "Future" @prev "Acknowledgements" @{_Section "Version History"} v1.0 (May 31, 2000)@{par} @{_bullet2}First Public Release!@{LIndent 2} v1.1 (June 21, 2000)@{par} @{_bullet2}Demo expiry date was being incorrectly calculated.@{LIndent 2} @{_bullet2}Date & Time conduit sync completed [registered users only]@{LIndent 2} @{_bullet2}Re-wrote routines that took into account 'virgin' (ID=0) Palms. Things should be much better now with changing user names and ids on Palms.@{LIndent 2} @{_bullet2}datebook.conduit did not always return a text error to log file.@{LIndent 2} @{_bullet2}datebook.conduit would try to open 'datbookdb' instead of 'datebookdb' on restoring files (Amiga->Handheld).@{LIndent 2} @{_bullet2}todo.conduit did not always return text error to log file.@{LIndent 2} @{_bullet2}Cleaned up some code in memo and address conduits.@{LIndent 2} @{_bullet2}In order to handle username changes without userid changes on handheld devices, the userid is now appended to directories that are created for database storage.@{LIndent 2} @{_bullet2}First new user to Spitfire would not be seen until a restart.@{LIndent 2} @{_bullet2}users.dat file updated before clients are notified of new user addition.@{LIndent 2} @{_bullet2}Changed all desktop apps to support new user path directory name format.@{LIndent 2} @{_bullet2}HSM was doubling usernames in listviews when multiple users present.@{LIndent 2} @{_bullet2}The file pocketchess.prc was being distributed with the Spitfire² archive. It has been removed.@{LIndent 2} @{_bullet2}Under OS 3.1 the icon images for DAM are now all the same height.@{LIndent 2} @endnode @node "Future" "Future" @next "Main" @prev "History" @{_Section "Future"} Write to me and tell me what would be cool to add to Spitfire²! Things that are currently planned: @{_bullet}Import/Export of To Do items in CSV format.@{LIndent 2} @{_bullet}Better documentation (I hate doing this kind of stuff...)@{LIndent 2} Additional suggestions by users: @{_bullet}Email conduit - I would like to do one, but my PalmPilot Personal does not have an email applications, thus there is no way for me to develope one. :-(@{LIndent 2} @{_bullet}Conversion of text files into Doc format with installation.@{LIndent 2} @{_bullet}Full ARexx port@{LIndent 2} @endnode @node INDEX "Index" @next "Registration" @prev "MAIN" Do you really need an index? @endnode @node Registration "Registration/Upgrading" @next "Registrationform" @prev "MAIN" @{_Section "Registration"} @{LIndent 0}@{Line} Please read @{u}carefully@{uu} the following text!@{par} To register, please print the @{"registration form" link Registrationform}, neatly complete it and send it to me along with the required sum of money.@{par} The registration fee is $20 US or $30 CND (Canadian dollars)@{par} If you registered Spitfire before February, 2000, then the upgrade fee is $10 US or $15 CND (Canadian dollars)@{par} You can choose between various methods of payment:@{LIndent 2} @{_bullet}Send money in an envelope, together with the registration form.@{LIndent 2} @{_bullet}Make an international postal money order, and send the registration form in an envelope.@{LIndent 2} @{LIndent 0}@{Line} You can choose whether to receive the keyfile via e-mail or via normal mail.@{LIndent 2} @{_bullet}If you decide to receive it via e-mail, please specify your e-mail address on the registration form. This is the fastest and preferred method.@{LIndent 2} @{_bullet}If you decide to receive it via normal mail, please enclose a pre-formatted floppy disk (Amiga DD 880k or MS-DOS DD 720k) into the envelope.@{LIndent 2} @{LIndent 0}@{Line} I will ship you the keyfile as soon as I have received BOTH the registration form AND the money. If you request a shipment via normal mail, please allow 2-8 weeks for delivery.@{par} Send registration to:@{par} @{jcenter} @{"Ralph Torchia" link "Author"@}@{par} 3069 Suffolk@{par} Windsor, Ontario@{par} CANADA N8R 1P1@{par} @{jleft} If anything is not clear, please write to me for more information.@{par} Thank you!@{par} @endnode @node Registrationform "Registration Form" @next "Registration" @prev "Registration" Please print and complete the registration form and send it together with payment to:@{par} @{"Ralph Torchia" link "Author"@}@{par} 3069 Suffolk@{par} Windsor, Ontario@{par} CANADA N8R 1P1@{par} <-------------------------------CUT HERE---------------------------------->@{par} SPITFIRE² REGISTRATION FORM@{par} ===========================@{par} I would like to become a registered user of Spitfire². Please find enclosed@{par} the registration form along with the required payment in:@{par} [ ] Cash@{par} [ ] An international money order@{par} I acknowledge that the cost:@{par} [ ] For registration is $20 US or $30 CND for shipment of the keyfile@{par} [ ] For upgrading from Spitfire is $10 US or $15 CND@{par} (If registered Spitfire before February, 2000)@{par} I want to receive my personal keyfile, as soon as possible, by:@{par} [ ] Electronic mail (e-mail) at the address specified below@{par} [ ] Normal mail (please enclose a pre-formatted 880k floppy disk)@{par} If the keyfile is sent via normal mail, I allow 2-8 weeks for@{par} delivery, starting from the day the author has received both@{par} the registration form and payment.@{par} My personal information is:@{par} First name:________________________ Last name:____________________________@{par} Address:__________________________________________ Apt. Number:___________@{par} City:____________________ State/Prov:________ ZIP/Postal Code: __________@{par} Country:___________________________________________________________________@{par} E-mail address:_______________________@____________________________________@{par} Spitfire² version I'm using:_______________________________________________@{par} Optional information:@{par} Configuration of the Amiga(s) I own:_______________________________________@{par} ___________________________________________________________________________@{par} Configuration of the Palm(s) I own:________________________________________@{par} ___________________________________________________________________________@{par} I guarantee that the keyfile I receive will not be distributed and will be@{par} used only by myself on one or more computers owned by myself. I also@{par} acknowledge that future upgrades of Spitfire² may require an update@{par} registration fee. Signature:________________________________ Date:_______________________@{par} @endnode @node demo "Demo Version" @next "MAIN" @prev "MAIN" @{_Section "Demo Limitations"} The unregistered demo version of Spitfire² has the following limitations: @{_bullet}Requesters reminding the user to register their copy.@{LIndent 2} @{_bullet}Maximum of 3 HotSync, without quiting and restarting the program.@{LIndent 2} @endnode @Node MailingList "MailingList" @{_Section "Mailing List"} Please join the Palmiga mailing list. This mailing list is made for anyone who owns a Palm @{B}and@{UB} an Amiga.@{par} To join, send an e-mail to @{FG FILL}palmiga-subscribe@egroups.com@{FG TEXT} . You do not need to write anything in the subject line or in the body of the message.@{par} After you have joined, you can post to this list by sending a mail to @{FG FILL}palmiga@egroups.com@{FG TEXT} . Please note that you @{B}must@{UB} join the list and you @{B}must@{UB} use the address you have subscribed with, if you want to contribute. This is necessary to keep the list spam free.@{par} You can unsubscribe anytime, just send another mail to @{FG FILL}palmiga-unsubscribe@egroups.com@{FG TEXT} .@{par} BTW: EGroups will not sell your e-mail address, neither will the lists maintainer, Richard Körber. Please inform yourself about the privacy policy at @{FG FILL}http://www.egroups.com@{FG TEXT} .@{par} @EndNode