home *** CD-ROM | disk | FTP | other *** search
/ PalmOS Software Digest / PalmDigest.iso / 工具 / Currency32 / readme.txt < prev   
Text File  |  2001-01-16  |  13KB  |  293 lines
  1.  
  2. Currency Version 3.2 (last built 16 Jan. 2001)
  3. ===============================================
  4.  
  5.                     by 
  6.             Henrique M. Martins 
  7.            hm_martins@email.com
  8.     
  9. ------------------------------------------------------------
  10.  See also 
  11.  
  12.     http://members.nbci.com/HM_Martins/currex.htm
  13.  
  14. ------------------------------------------------------------
  15.  
  16. Currency is a currency database and conversion utility.
  17.  
  18. Installation
  19.  
  20.    This distribution comprises two freeware components:
  21.  
  22.     1. The PalmOS application, (file currex.prc), which is distributed
  23.        in file currex.zip and must be installed in your Palm as usual.
  24.     2. The Currency conduit (credits: Tim Endres), which is distributed 
  25.        in file conduit.zip and which can be *OPTIONALY* installed in 
  26.        your host desktop to fully automate the process of updating the 
  27.        exchange rates. The official site for the conduit is
  28.  
  29.              http://www.dotfile.com/palm/currex
  30.  
  31. 1. Intallation of currex.prc
  32.  
  33.     This is done as usal. Using the palm desktop, add currex.prc 
  34.         to the list of files to upload at the next Hot-Sync.
  35.  
  36.        If you are upgrading from a very old version of "Currency" 
  37.         and you find any problem (this is not foreseen), you may have 
  38.         a database compatibility problem. In this case, just delete 
  39.         Currency from your Palm (which automatically will also delete 
  40.         the database) and load it again.
  41.  
  42. 2. Instalation of the conduit
  43.  
  44.     The currency conduit is an optional component which enables
  45.         an automatic update of the exchange rates every time an
  46.         Hot-Sync is performed.
  47.  
  48.     The instalation of the currency conduit is an easy and 
  49.         straightforward process described in detail in the file 
  50.         readme.html, under the "Conduit\doc" folder. Note, howerver,
  51.         that  you do not have to install the Conduit to test the Palm
  52.         application. Even without the conduit, you may daily download 
  53.         from our site a new database with an updated set of exchange 
  54.         rates and install it in your Palm using the Palm desktop.
  55.     The conduit only enables the full automation of this process 
  56.         every time you Hot-Sync. 
  57.  
  58.     The instalation of the conduit is highly recommended if you 
  59.         are a professional user of if you need to have the exchange 
  60.         rates updated in a regular basis.
  61.  
  62. Full and reduced version
  63.  
  64.      Two versions of "Currency" are distributed. The first one,
  65. distributed in archive currex.zip, includes support for 174 currencies.
  66. The second one, distributed in currred.zip,  is a reduced version and 
  67. supports 66 currencies. Both are free and daily udapted. 
  68.  
  69.      To update Currency it is only required to download a small 
  70. update database (either cupdate.pdb or cupdred.pdb), or re-install
  71. the application.
  72.  
  73.             Full Version    Reduced version  
  74. --------------------------------------------------------
  75. File name        currex.prc        curred.prc
  76. Number of curr.          174                     66
  77. Size (.prc)             52657                  43870
  78. Size (.pdb)             25068                  10000
  79. Total                   77725                  53870
  80. --------------------------------------------------------
  81. Update database
  82.   Name            cupdate.pdb       cupdred.pdb
  83.   Size                    6204                 2804 
  84. ---------------------------------------------------------
  85.  
  86.      Check in http://members.nbci.com/HM_Martins/currex.htm the
  87. full list of currencies included in each version.
  88.  
  89. Updating exchange rates
  90.  
  91.      Exchange rate may be updated manually, editing the 
  92. "Settings/Currency" (see configuration details below).
  93.  
  94.      It is possible to  update all currency rates automatically 
  95. downloading a small database from the distribution web site. This 
  96. database is kept daily updated according to the official rates 
  97. published by the European Central Bank (ECB) (for the main currencies) 
  98. or distributed by OANDA (see http://www.oanda.com/). Note that while 
  99. ECB rates are "european official rates", OANDA rates are usually 
  100. closer to the world market averages. OANDA rates are used, 
  101. among many other sites, by CNN currency converter.
  102.  
  103.      To update the rates automatically proceed as follows:
  104.  
  105.    1. Download the update database (cupdate.pdb) from
  106.  
  107.       http://members.nbci.com/HM_Martins/cupdate.pdb
  108.         
  109.          (or, if you use the reduced version "currred.prc",
  110.           http://members.nbci.com/HM_Martins/cupdred.pdb)
  111.  
  112.    2. On the host PC, run the HotSync application ("Palm desktop"), 
  113.       select Install/Add and browse until select cupdate.pdb, as 
  114.       you do to install a standard application.
  115.  
  116.    3. Hot-Sync your Palm as usual.
  117.  
  118. Automated exchange rate update using a conduit (Credits: Tim Endres)
  119.  
  120. Instead of manually downloading the cupdate.pdb file periodically 
  121. from http://members.nbci.com/HM_Martins/cupdate.pdb, you may have an 
  122. automated procedure that  downloads the  exchange rate update database 
  123. whenever an   Hot Sync of the Palm is performed. For this purpose, 
  124. the Currency Conduit must be installed in your desktop PC. The 
  125. Currency Conduit was written and  developed by Tim Endres (thank you!), 
  126. and, upon unzipping of the distribution file, can be found under
  127. the <conduit> subdirectory. More detailed information can be found in
  128.  
  129.       conduit/doc/readme.html 
  130.  
  131. or at Tim Endre's site:
  132.  
  133.       http://www.dotfile.com/palm/currex/.
  134.  
  135. Direct download of the exchange rates to your Palm.
  136.  
  137. Some Palm applications support direct download of files from remote internet
  138. locations. You may use one of such applications to update "cupdate.pdb"
  139. while on leave. One possibility is SmartDoc (please check 
  140. http://www.tapworks.com/) which has the ability to download documents 
  141. by FTP or HTTP. In this case, you just have to enter the NetMark
  142. http://members.nbci.com/HM_Martins/cupdate.pdb.
  143.  
  144.  
  145. Main features:
  146.  
  147. - Freeware.
  148. - Configurable display (see  Settings / Display menu)
  149. - Up to 6 simultaneous currencies on display.
  150. - Simultaneous update of all displayed currencies.
  151. - User selectable font size.
  152. - User defined number format (support of international formats)
  153.   according to the main system preferences (see the "Prefs" 
  154.   application in the system folder, format category, 
  155.   menu "number format").
  156. - All calculations performed in double precision (~14 digits of 
  157.   precision). 
  158.       Att: Least significant digits may be incorrect if
  159.       more then 14 digits are used.
  160. - 174 or 66 currencies included.
  161. - All 12 Euro currencies (frozen exchange rates).
  162. - Daily update support.
  163. - All to all currency conversions. 
  164.       (Conversions performed via Euro triangulation, 
  165.        which may not be correct for conversion between 
  166.        non Euro currencies.) 
  167. - Configurable currency details (see Settings / Currency menu).
  168. - User selectable reference currency for exchange rate updates.
  169. - Warning issued for outdated exchange rates.
  170. - Configurable display format.
  171. - Auxiliary small keyboard input.
  172. - Date of last exchange rate update stored for each individual currency. 
  173. - Independent setting of actual and default preferences.
  174. - System default rates as supplied by Olsen and Associates (OANDA,
  175.   see http://www.oanda.com/).
  176. - The prc image at EuroCool will be daily updated at about 13:30/14:30 GMT
  177.   with the spot rates published by the European Central Bank. Since this 
  178.   service will be provided at no cost, it may be interrupted at any
  179.   moment without prior notice.
  180. - Full keyboard support.
  181.  
  182. Configuration details:
  183.  
  184. - The display can be configured tapping the "Select" button.
  185.   Use < and > to add/remove currencies to the active display list.
  186.   You may reorder the currencies in the active display list
  187.   by "drag & drop": select the currency you want to move, drag 
  188.   the pen until the new position where you would like to see it,
  189.   and lift the pen. The currencies in the initial and final positions
  190.   will exchange locations.
  191. - The details for each currency can be fully configured taping the
  192.   currency code or using the  "Settings/currency" option. Editable fields 
  193.   are clearly marked.
  194. - In the "Settings/Currency" screen select preferred reference
  195.   currency, which can be optionaly used to update exchange rates.
  196. - The default button in the "Settings/Currency" screen recalls 
  197.   the system default value for the displayed currencies.
  198. - The "Reset/Reset all currencies" menu in the "Settings/Currency" 
  199.   screen resets all currencies (INCLUDING user defined currencies) 
  200.   to system default values.
  201. - Currency keeps track of two configuration profiles.
  202.   Each profile is defined by the set of displayed currencys, 
  203.   amd the slected font.
  204.  
  205.   1. The actual configuration is the one in use and which is kept when 
  206.      switching between applications. 
  207.   2. The "user default" profile can be defined by the user by setting
  208.      the desired configuration and then selecting the menu option 
  209.      "Display/Set as default" in the "Configure display" screen.
  210.   3. The "User default" profile can be restored at any time either in 
  211.      the main screen using the "Settings/User default" menu or in the 
  212.      Configure Display screen using the "Display/Restore default" 
  213.      option. 
  214.  
  215. - The download of a new prc image in order to update exchange rates will
  216.   not affect user defined settings (display configuration,  number format and
  217.   user defined currencies). Only the exchange rates of the default currencies
  218.   will be updated IF they are newer (more recent) than those in the 
  219.   currency database.
  220.   
  221. - Validity period for rates in use can be set at the "Settings/Validity" 
  222. menu. After the specified period of time, a warning symbol is displayed
  223. near the currency code.
  224.  
  225. Calculator
  226.  
  227. - Full algebric calculator. Standard algebric priorities and  
  228.   parenthesis  supported.
  229. - Given the basic "Currency" design (where all displayed currencies are
  230.   treated in parallel) , some inconsistencies may be expected  in 
  231.   operation of the calculator. For example, when computing 
  232.   $1000 * 0.15 = $150, the 0.15 factor will be treated as "Currency" and
  233.   its "rate" computed for all displayed currencies, even if it is
  234.   just a multiplication factor.  On the other hand, if the active 
  235.   currency field (the one displaying the insertion cursor) is changed 
  236.   in the middle of an expression, the result may be unexpected.
  237.   But this is an inconsistent (and unlikely) use of the calculator.
  238.  
  239. - Defining a positive or negative tax rate in the  Setting / Tax
  240.   menu, a one touch operation key for that factor will be displayed
  241.   in the main screen.
  242.  
  243. -- Known problems
  244.     
  245.  A few users wich own "older" Palm devices, running Palm OS 2.0 
  246.  prior to 2.0.5, experienced some problems after the installation 
  247.  of the "full" Currency version. The symptoms are: (1) An attempt 
  248.  to run Currency makes the Palm return to the application menu 
  249.  (2) Apparently, it does not seem possible to delete "Currency" 
  250.  from the main memory.  There are no reports of "hard" crashes or 
  251.  data loss in any of these  situations.
  252.  
  253.  It is possible to  recover a "normal" Palm behavior as 
  254.  follows:
  255.  
  256. 1. Perform a backup of your Palm. This is not strictly required, but let's
  257.    be safe.
  258. 2. Perform an hardware soft reset. With a small clip, press *once* the 
  259.    reset button in the rear pannel. This reinitializes the system but does
  260.    not erase any data, so all your information is kept. 
  261. 3. Delete "Currency". The delete will work OK now.
  262. 4. Download the "reduced"  Currency version, wich is known to work  
  263.    OK with all operating systems. 
  264.    The reduced version can be downloaded  from 
  265.  
  266.    http://members.nbci.com/HM_Martins/currred.zip
  267.  
  268.    The reduced version only supports about 65 currencies, but 
  269.    it includes the major trading currencies (check which ones
  270.    in http://members.nbci.com/HM_Martins/). 
  271.  
  272. Distribution:
  273.  
  274. - This software may be freely distributed. But an e-mail informing me 
  275.   would be welcome.  
  276.  
  277. Disclaimer:
  278.  
  279. - The software is supplied as is.  The author disclaims all warranties, 
  280.   expressed or implied, including, without limitation, the warranties of 
  281.   merchantability and of fitness for any purpose. The author nor 
  282.   anyone else who has been involved in the delivery of this product
  283.   assumes any liability for damages, direct or consequential, 
  284.   which may result from the use of the software. 
  285.  
  286. Comments:
  287.  
  288. - Comments welcome.
  289.  
  290. -- Henrique M. Martins
  291.    hm_martins@email.com
  292.  
  293.