home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 November / Chip_1999-11_cd.bin / zkuste / MacOS / DATA / FILES / FOLDERS.SIT / FoldersSynchronizer / ReadMe < prev    next >
Text File  |  1999-09-23  |  10KB  |  95 lines

  1. FoldersSynchronizer 1.0.3  - by Lorenzo Puleo, September 1999
  2.  
  3. Utilities for Macintosh. Choose two folders and then they will be synchronized exaclty equal. The old files will be replaced with the newest files  in both the directions. The new files (new entries) will be copied in both the directions, as well as the new Folders.
  4. The old Folders will not replaced enterely by the newer, as the Finder uses to do, but their content will be updated with the newest files, the new files (new entries), the newest Folder and new Folders(new entries). If some conflict occurs between FileNames and FolderNames, FoldersSynchronizer will append to the FileNames the post-fix ".1", ".2"...
  5. Before use if, try it on two trial folders in which there are subfolders and files.
  6. FoldersSynchronizer cannot Undo the process. Scriptable by AppleScript.
  7.  
  8.  
  9. To Start
  10. Ñ Launch the application "FoldersSynchronizer".
  11. Ñ Pick the 1th Folder by clicking on the Top Folder Icon.
  12. Ñ Pick the 2th Folder by clicking on the Bottom Folder Icon.
  13. Ñ Click on button "Synchronize" to launch the process. You can stop the process at any time.
  14. Ñ By clicking on the blue icon "i" at the bottom-right, you could set the check-box "Remember Folders" which allows FoldersSynchronizer to remember the last two Folder chosen, so you can avoid to pick the two folders every time you need to Synchronize or BackUp. It's recommended for advanced users (someone could synchronize two unwanted folders). It's most useful when you control this application by AppleScript. See below.
  15. Ñ The 2th check-box "One direction Only" turns FoldersSinchronizer into a BackUp program. The orange arrow at the left will change into gray arrow. The Bottom folder will be upgraded with the newest files and folders coming from the Top folder, and the Top Folder will leave intouched.
  16. Ñ Whenever FodersSyncronizer meets conflicts between FolderNames and FileNames (e.g. it trys to copy the file "MyJob" into a folder in which there is the folder "MyJob"), firstly, it renames automatically the FileName appending the post-fix ".1", ".2", ".3", .etc, and then it copys the file. Even if the file is coming from the source folder during a BackUp, it will be renamed. Thus, when before we said "the Top Folder will leave intouched", we was speaking about no deleting.
  17. Ñ Remember that FodersSyncronizer cannot revert the process. There is not UNDO command. Therefore, to prevent any troubles, use this application with care.
  18. Ñ FodersSyncronizer, at the end of the process, saves a Text Log File into the folder "Log Files" which describes each task done and a summary of files copied, replaced or renamed and Folders created for both the main folders chosen.
  19. The filename of the Log file shows e.g. Bckp_1999_09_23_00_10_05. The format is "Bckp" for BackUps, "Sync" for Synchronizations. After, YYYY_MM_DD_HH_MM_SS. The version 1.0.2 made some errors regarding the date and time formats saving the Log files. The version 1.0.3 fixed this trouble.
  20. Ñ If some error occurs (e.g. some file is write-protected and FS cannot overwrite it), FS will advise you by an alert-box showing which file or folder causes troubles, and will stop the entire process. At the bottom of the Log file, you will find the line regarding the error occurred (e.g. Error coping file "MyDisk:Jobs:myFile" into "Server:BackUp:Jobs:myFile). Solve your problem (e.g. the disk is full) and then relaunch the process.  FS restarts from the first item, but will skip quikly the items already updated.
  21. Ñ The user can stop the entire process by clicking on the button "Stop". The file Log will report this action by the user.
  22. Again, you can relaunch the process. FS restarts from the first item, but will skip quikly the items already updated.
  23. Ñ If you need to work with thousands of files and FS quits before the process is complete, try to increase the application memory in the finder application's Info.
  24. Ñ AppleScript can manage the process. See the 2 samples into the "AE Applet Samples" folder included in this package.
  25. Try to substitute the pathFolders with your pathFolders.
  26. Ñ The author is not responsible for the damages regarding lost datas, damages of the archives, and any other troubles coming from the use of this software. The user, when register his copy, accepts these terms.
  27. Ñ Dont' modify, move or rename the folders "XTRAs" and "XTRAsMac".
  28.  
  29.  
  30. ----------------------------------------
  31. About Registration and Pricing:
  32. "FoldersSynchronizer" has the following pricing:
  33. 1-5 single user licenses, $20 per user (US Dollars)
  34. 6-9 single user licenses, $18 per user
  35. 10 or more single user licenses, $17 per user
  36.  
  37. A Site License costs $400 and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  38. A World-Wide License costs $1600 and it covers all locations for your organization on the planet earth.
  39.  
  40. Paying for the FoldersSynchronizer is fairly simple. There are two methods. On the Web and by "Register" application.
  41.  
  42. Ñ To register on the web:
  43. Go to the web page http://order.kagi.com/?U3S
  44. You will see a form-list of my sharewares.
  45. Fill the form with your name, email, address, and how many copies of each product of mine you want.
  46. Click on the button "Continue" and it will appear the invoice form. It will show the list of the products you chosen and the total amount.
  47. Fill the fields regarding you Credit-Card datas and then click on the button "Purchase".
  48. If your browser supports, you can switch on SSL secure payment form (it's the internet international standandard secure form of payment).
  49. Your invoice will be processed in 3 or 4 days. Therefore, you will receive by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "XTRAs" folder (which is into the "FoldersSynchronizer" folder).
  50.  
  51. Ñ To register by the "Register" application:
  52. You need the "Register" application that accompanies "FoldersSynchronizer" package.
  53. If you lost the "Register" application, you could download it (51Kb) from http://space.tin.it/arte/lpuleo/download/register.sit
  54. Launch the "Register" application, enter your name, email address and the number of single user licenses or other licenses you desire.
  55. Save or copy or print the data from the Register program and send the data and payment to Kagi.
  56. Kagi handles my payment processing. See the end of this document for more specific payment information.
  57. The fastest way (round 3 days) is to save the invoice to a text file, choosing "via email", and therefore send that text file via email as attachment to sales@kagi.com . You can also open the invoice text file with an editor (e.g. SimpleText) select all the text, copy and paste into the email so as it is (without any changement). Don't forget to include your email address. We need to send to you the RegistrationFile by email.
  58. Once your message is received by Kagi, you will receive (in round3 days) by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "XTRAs" folder (which is into the "FoldersSynchronizer" folder).
  59.  
  60.  
  61. Detailed Payment Info:
  62. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  63.  
  64. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  65.  
  66. If you are paying with Cash or USD Cheque you should print the data using the Register application and send it to the address shown on the form, which is: 
  67.  
  68.     Kagi
  69.     1442-A Walnut Street #392-U3S
  70.     Berkeley, California 94709-1405
  71.     USA
  72.  
  73. You can pay with a wide variety of cash from different countries but at present if you pay via cheque, it must be a cheque drawn in US Dollars. Kagi cannot accept cheques in other currencies.
  74.  
  75. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment. 
  76. Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  77.  
  78. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  79.  
  80. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  81.  
  82.  
  83. Requirements for Macintosh:
  84. Power Macintosh
  85. MacOs 7.0.1 or higher
  86. 7 Mb of free RAM
  87. 2.2 Mb free on disk
  88. 14" Color Monitor
  89.  
  90. --
  91. For further informations about the software:
  92. Lorenzo Puleo - Email: puleo@kagi.com  - Web Site: http://space.tin.it/arte/lpuleo
  93.  
  94. For further informations about the payment:
  95. Kagi - Email: sales@kagi.com  - Web Site: http://www.kagi.com