home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Finance / Finance.zip / et323.zip / READ.ME < prev    next >
Text File  |  2000-04-29  |  15KB  |  325 lines
  1. This is the 'official' read me file for Electronic Teller 3.23
  2.  
  3.  
  4.                  *** IMPORTANT NOTICE ***
  5.  
  6.     PLEASE NOTE THAT MY E-MAIL ADDRESS AND HOME PAGE  URL 
  7.     CHANGED EFFECTIVE 1 NOVEMBER 1999. SEE 'CONTACT 
  8.     INFORMATION' AT THE END OF THIS FILE FOR DETAILS.
  9.  
  10.  
  11. CONTENTS:
  12.  
  13.     - Introduction
  14.     - Installation
  15.       - Selecting a cheque designer / printer
  16.     - Migrating from Earlier Versions
  17.     - A Call for Translators
  18.     - Files
  19.     - Importing (from QIF files)
  20.     - Bug reports
  21.     - Known Problems
  22.     - Where to Turn for Help
  23.     - Contact Information
  24.  
  25.                            INTRODUCTION 
  26.                            ~~~~~~~~~~~~ 
  27.  
  28. Electronic Teller is a home finance application. It features a rich 
  29. set of functions and utilities, which include: 
  30.  
  31.       An attractive user-interface to handle various sets of 
  32.        accounts. 
  33.       Multiple-user support to shield accounts from one another. 
  34.       A calculator.
  35.       A reminder utility that can be used for upcoming fiscal 
  36.        and/or social events with limited or perpetual repetition 
  37.        options. 
  38.       Two configurable cheque printers that support user-defined 
  39.        designs and multiple cheque-per-page printing. 
  40.       A wide assortment of reports, from budget to transaction 
  41.        reports, with a variety of subtotalling options. 
  42.       Budget tracking and graphs. 
  43.       Category tracking and graphs.
  44.       Transaction fee or service charge tracking. 
  45.       A converter to import and export QIF files. 
  46.       International currency support, including conversion to/from 
  47.        a domestic currency.
  48.       International language support (French, German, Portuguese, 
  49.        Spanish, UK and US English)
  50.       Account Book transactions can be sorted chronologically 
  51.        (default), by code, payee, category, or class.
  52.  
  53. Electronic Teller is released as shareware, and sells for $40.00 US.
  54.  
  55.  
  56.                                INSTALLATION
  57.                                ~~~~~~~~~~~~
  58. Unzip the files in the archive to a separate directory and run the 
  59. install.exe utility.  You will be asked to supply a destination 
  60. directory.  DO NOT specify the '-j' switch to your unzip utility,
  61. because install.exe expects to find the icon files in the  'Icon\'
  62. subdirectory.
  63.  
  64. The destination CANNOT contain an existing copy of Electronic Teller.  
  65. This rule is enforced to prevent damage to accounts in the event of a 
  66. bug, and a means of easily backing out of an upgrade should the need 
  67. arise.  A migration utility has been included, however, to migrate
  68. from some older version of Electronic Teller (see below).
  69.  
  70. The installation utility will not create folders containing existing 
  71. accounts.  To have these created in Electronic Teller's main desktop 
  72. folder, start the program.  As existing portfolios are read, WPS 
  73. folders will be created.  As each portfolio is then opened from 
  74. within the Service Desk, corresponding account objects will be created 
  75. in the associated WPS folder.  Accounts can then be launched directly 
  76. from their respective WPS object, bypassing the Service Desk altogether.
  77.  
  78.  
  79.                  SELECTING A CHEQUE DESIGNER / PRINTER
  80.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81. Electronic Teller ships with two cheque designers / printers.  One is 
  82. mouse intensive and uses metric measurements to instruct the printer 
  83. where particular printable cheque items should be printed.  The second
  84. is was created for users who experienced difficulties with the original
  85. printer and is less mouse intensive.  Moreover, it positions printable
  86. cheque items using pel, or pixel, measurements.
  87.  
  88. The original cheque printer's executable file is named etprnc.exe.  If
  89. you experience difficulties in printing cheques or in designing layouts
  90. with this designer 
  91.  
  92.   1) Close the utility.
  93.   2) Rename original executable to etprnc1.exe.
  94.   3) Rename the alternative executable from etprnc2.exe to etprnc.exe.
  95.   4) Start the application from within an Account Book.
  96.   5) Recreate the designs.
  97.  
  98. For those who use the cheque printer and decide to give the alternative
  99. designer a try, it would be prudent to create the designs using different
  100. names so that returning to the original design will not require recreating
  101. the original designs.  I would also like to know what people's thoughts are
  102. on the new design.  If it is found to be easier to use, then I will consider
  103. eliminating the original design from future releases.  If, however, you find
  104. the original design superior, then, please say so; otherwise, if the only
  105. opinion I get is to scrap the original design, then I will.  One vote in
  106. favour of the original design will guarantee its inclusion in future releases.
  107.  
  108.  
  109.                     MIGRATING FROM EARLIER VERSIONS
  110.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  111. A separate utility is included as of version 3.11 to handle migrating
  112. accounts from earlier versions.
  113.  
  114. THIS UTILITY WILL MIGRATE ACCOUNTS THAT WERE CREATED WITH VERSION 3.10
  115. AND LATER.  I must apologize for this inconvenience which is the direct 
  116. result of my own stupidity.  I repartitioned a hardrive earlier in 1998
  117. and lost the source code for Electronic Teller.  I had to work with an 
  118. old backup copy.  As a result, I lost the data structures for the 
  119. account files and could not recall what the structures were so that 
  120. I could, at least, read the file and import directly into version 3.10.
  121.  
  122.                          Migrating from pre-3.10
  123.                          ------------------------
  124. To migrate accounts from any version earlier than this, it will be 
  125. necessary to perform the following steps:
  126.  
  127.   1) export the individual accounts to QIF file using the old version 
  128.      of Electronic Teller.
  129.   2) Close the old version of Electronic Teller and start the newest
  130.      version.
  131.   3) Recreate the portfolios (what used to be called ATM Cards in
  132.      previous versions and Folders before that).
  133.   4) Access the Porfolio into which the account(s) are to be imported
  134.      (do this by double-clicking on the portfolio).
  135.   5) Select the 'Import QIF' item from the Service Desk's 'Porftfolios'
  136.      menu.
  137.  
  138. Unfortunately, the QIF Converter packaged with versions of ET earlier than
  139. 3.10 will NOT preserve deleted, postdated, or voided transactions, so 
  140. some repairs will be required to the transactions after they have been
  141. imported or, if desired, by editing the actual QIF file that is generated
  142. by the export function.  Since postdated setups are not exported, either,
  143. instructions below describe what is required to ensure that deleted and/or
  144. voided transactions are properly preserved on import:
  145.  
  146.   1)  After the account has been exported to a QIF file, open that file
  147.       with a text editor.
  148.   2)  Locate the individual deleted and/or voided transactions in the
  149.       QIF file and, when one is located, add the following text 
  150.       immediately to the right of the line with the 'P' prefix:
  151.  
  152.         for deleted transactions, add DELETED:
  153.         for voided transactions, add VOID:
  154.  
  155.       For example, if the first deleted transaction has a line with
  156.       a 'P' prefix that reads:  
  157.  
  158.         PHome Hardware
  159.  
  160.       that line would be amended to read:
  161.  
  162.         PDELETED:Home Hardware
  163.  
  164.       Similarly, if a second transaction was voided, it would be
  165.       amended to read:
  166.  
  167.         PVOID:Home Hardware
  168.  
  169.   3) Save the file and invoke the QIF converter to import the QIF
  170.      file.
  171.  
  172. Complete help on exporting/importing is available on-line.
  173.  
  174.  
  175.                          Migrating from 3.10+
  176.                          --------------------
  177. To migrate from 3.10, it will be necessary, first, to install Electronic
  178. Teller, and, second, to run the migration utility (double-click on the
  179. Migrate object in Electronic Teller's WPS folder, or change to your
  180. Electronic Teller installation directory and enter the command:  
  181.  
  182.      migrate <Enter>
  183.  
  184. Help on using the migration utility is availabe on line.  Quickly,
  185. however, migration from 3.10+ requires the following steps:
  186.  
  187.   1) Following the installation of the current release of Electronic
  188.      Teller, double-click upon the "Migrate" object.
  189.   2) Select the appropriate option in the "Migrate from:" drop-down
  190.      combination box, for example "From 3.10 to 3.12".
  191.   4) Enter the directory in which the previous version to be migrated
  192.      resides, e.g. d:\bin\et310.
  193.   3) Click the "Migrate..." button.
  194.  
  195. That's it.
  196.  
  197.                             A CALL FOR TRANSLATORS
  198.                             ~~~~~~~~~~~~~~~~~~~~~~
  199.  
  200. Code is in place to allow Electronic Teller to display different languages, 
  201. although I don't envision translating this help file (the amount of work would 
  202. be overwhelming).   
  203.  
  204. I have received, and accepted, offers for the following languages (items with an 
  205. asterisk [*] to the right of it indicate accepted offers but no word from the
  206. translator since, so I consider them to be available still unless otherwise
  207. notified by the translator):
  208.  
  209.       French
  210.       German
  211.       Polish *
  212.       Portuguese
  213.       Russian *
  214.       Spanish
  215.  
  216. As translations become available, they will be posted to my home page.  If your
  217. particular language is not listed and you would like to donate time, drop me
  218. a line at <phcaron@home.com>.  Because Electronic Teller remains relatively 
  219. inexpensive, I'm afraid I can't provide any monetary reward.  Translators, however, 
  220. will receive a free copy of Electronic Teller, a free copy of PM PostNotes' Deluxe 
  221. Edition (which I have also written), for a combined value of $70.00 US, as well 
  222. as their name in the Product Information dialog.   
  223.  
  224. What is involved on the part of the translator is, of course, a translation of 
  225. roughly 930 lines of text.  Some of these lines are quite small -- no more than 
  226. a single word -- while others are complete sentences.  In short, any text that 
  227. appears in Electronic Teller would need doing.  In addition, I would need to be 
  228. able to get in touch with the translator easily so that additional translations 
  229. can be provided or, perhaps, changes made to existing items.  In short, this would 
  230. be an ongoing effort.   
  231.  
  232.  
  233.                                    FILES
  234.                                    ~~~~~
  235. Included in the archive are the following files.  Depending upon your
  236. needs, some may be safely deleted.  Files that are essential are prepended
  237. with an asterisk (*); runtime dynamic link libraries are not included,
  238. here:
  239.  
  240.       archives.exe       Portfolio backup / restore utility
  241.     * etacne.exe         Account creation / editing utility
  242.       etarcs.exe         Transaction archive utility
  243.     * etbook.exe         Account Book 
  244.       etbuds.exe         Budget graphs / printing 
  245.       etcalc.exe         Calculator 
  246.       etcald.exe         Reminder utility
  247.     * etcats.exe         Category management utility
  248.     * etdesk.exe         Service Desk 
  249.       etfind.exe         Transaction Search & Replace utility
  250.       etgrap.exe         Category usage graphs
  251.       etimex.exe         QIF Importer/Exporter
  252.       etprnc.exe         Cheque designer/printer
  253.     * etrecl.exe         Account reconciliation utility
  254.     * firstaid.exe       A utility to repair damaged indexes and update
  255.                          certain stored values, such as balance forward
  256.       install.exe        Installation / object creation utility
  257.       migrate.exe        Migration utility
  258.       read.me            This file
  259.       whats.new          A list of changes / additions / fixes for the
  260.                          current version
  261.       exchange.txt       A sample file used to import exchange rates
  262.       problem.txt        A bug report form
  263.       Icons\etfold0.ico  Closed ET folder icon used by the WPS
  264.       Icons\etfold1.ico  Opened ET folder icon used by the WPS
  265.       Icons\bank.ico     Bank account icon used by the WPS
  266.       Icons\credit.ico   Credit card account icon used by the WPS
  267.       Icons\cash.ico     Cash account icon used by the WPS
  268.       Icons\asset.ico    Asset account icon used by the WPS
  269.       Icons\liabil.ico   Liability account icon used by the WPS
  270.       Icons\1.ico        Icon used for user-defined transaction flag, example 1
  271.       Icons\2.ico        Icon used for user-defined transaction flag, example 2
  272.       Icons\3.ico        Icon used for user-defined transaction flag, example 3
  273.  
  274. The installation utility will selectively copy and install application, icon,
  275. and language files for you, so manual deletion is not necessary.
  276.  
  277.  
  278.                                 BUG REPORTS
  279.                                 ~~~~~~~~~~~
  280. All bug reports are to be directed to my e-mail address:
  281.  
  282.     phcaron@home.com
  283.  
  284. Please use the supplied 'problem.txt' template when reporting bugs.
  285.  
  286.  
  287.                               KNOWN PROBLEMS
  288.                               ~~~~~~~~~~~~~~
  289. Styler/2, also known as Smart Windows, causes a number of problems resulting
  290. in SYS* violations or unexpected, silent application termination.  Although
  291. some of the incompatibility problems have been fixed, permitting some
  292. basic functionality in ET, outstanding issues remain.  Having said that, 
  293. I feel that I have done all that I'm prepared to do to support a third-party 
  294. WPS enhancer.
  295.  
  296.  
  297.  
  298.                             WHERE TO TURN FOR HELP
  299.                             ~~~~~~~~~~~~~~~~~~~~~~
  300. Should have difficulty working with Electronic Teller, extensive on-line 
  301. help is available.  Most, if not all, windows and dialogs come equipped
  302. with context-sensitive help, and this can be accessed by pressing the
  303. F1 key.  A 'Help' button will generally display help for the task being
  304. performed or for the concept/usage behind the window for which help was
  305. invoked.
  306.  
  307. If you still have difficulties with a concept, e.g. the difference 
  308. between a category, subcategory, or class, explanations and examples
  309. can be found in the online help under the 'Terms and Concepts' topic.
  310.  
  311. Should a satisfactory answer not exist in the help file, I can be reached
  312. via e-mail.  Full contact information is available below.
  313.  
  314.  
  315.                              CONTACT INFORMATION
  316.                              ~~~~~~~~~~~~~~~~~~~
  317. If you experience difficulties, have question, or would like to comment
  318. generally, I can be reached at:  
  319.  
  320.    phcaron@home.com
  321.  
  322. For update information, visit my home page at:  
  323.  
  324.    http://members.home.net/phcaron
  325.