home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / EXPA / README.TXT < prev    next >
Encoding:
Text File  |  1993-02-03  |  5.6 KB  |  132 lines
  1.                              
  2.                        EXPENSES  V. 1.0
  3.  
  4.                              By
  5.                      Julius K. Bjornsson
  6.                          72500,456
  7.                       julkb@rhi.hi.is
  8.  
  9.  
  10. Introduction:
  11. --------------
  12. Here is my first OPL application for the S3, called EXPENSES.  This is a 
  13. simple application which keeps track of some types of expenses,
  14. i.e. money, distances (milage) and hours.  I wrote it to keep track of 
  15. these things for myself, in such a way that I could keep all related records
  16. together in one file.  I therefore keep one file for each activity, or each 
  17. job, and can then print out a summary for each type of activity for certain
  18. periods of time.  
  19.  
  20.  
  21. Installation:
  22. -------------
  23. The archive contains three files:
  24.  
  25.         EXPE.OPA    Program   
  26.         SAMPLE.EXP    Sample datafile
  27.         READ.ME      (this file)
  28.  
  29. In order to install the program, you must create a \exp directory on any 
  30. drive, and copy the EXPE.OPA file to any \APP directory.  Thereafter you can
  31. install the program onto the system screen in the usual way, with APPS->
  32. INSTALL APPLICATION.
  33.  
  34. Use:
  35. ----
  36. All data files should appear under the program icon, and can be started
  37. in the usual PSION manner, by simply choosing the file to use.  Only one 
  38. datafile can be open at a time, as the application is a TYPE 2 OPA.
  39.  
  40. The program starts with an intro (about) screen, which is removed by pressing
  41. ENTER, and then the main menu appears.  This menu has the following structure:
  42.  
  43.  
  44. FILE
  45.  NEW FILE     Create new datafile
  46.  OPEN FILE    Open an existing file.  A status line shows which file 
  47.               is currently open.
  48.  SAVE AS      Save a datafile under a new name, or copy it from e.g. 
  49.               a flash card to RAM.  (this is really a compress).
  50.  DELETE FILE  Delete a datafile. (only closed files).
  51.  
  52. EDIT
  53. NEW RECORD    Enter a new record.  This opens a dialog where you can enter
  54.               some explanatory text, date and choose the type of data you
  55.               want to register.  This is done by using the arrows or by
  56.               using TAB to open a small menu.  Ths choices are money,
  57.               distances and hours.
  58.               Finally the amount can be entered, as a floating point number,
  59.               and here it is possible to enter negative as well as positive
  60.               numbers.
  61.    UPDATE     With this option you can choose a record to edit.  When this
  62.               option is chosen, a browse window opens, where you can browse
  63.               through all the records in the file.  The browse window opens
  64.               with the first record current, but you can move in the window
  65.               with the up and down arrows, PgUp and PgDn, in addition to being
  66.               able to jump to the beginning and the end of the file, with HOME
  67.               and END.  It is also possible to jump about in the file pro-
  68.               portionally, by using the 1,2,3,4,5,6,7,8,9 keys, where e.g. the
  69.               1 key positions you below approximately 10% of all records in 
  70.               the file, the 9 key positions you approximately below 90% of all
  71.               records and the 5 key positions you in the middle of the file.
  72.               It is thus possible to quickly jump all over the file, even if
  73.               if has become big.  When you have found the record you want to 
  74.               edit, simply highlight it, and press enter, and the editing
  75.               dialog will open.  The status line shows the current record 
  76.               number.
  77.    REMOVE     This option removes the chosen record, via the browser.
  78.  
  79. BROWSE          This option in the top menu does not do anything than let
  80.               you browse the file.
  81.  
  82. REPORTS
  83.    SUMMARY    This is the main report of the system, allowing you to
  84.               generate a simple list of records for a certain period
  85.               of time and of a certain type.  In addition you can choose
  86.               whether the reports goes to the screen or directly to a
  87.               printer, which must then of course be connected and ready.
  88.               Otherwise you will get an error message.  If you choose 
  89.               to view the report on-screen then the text fields will
  90.               be trimmed to 15 characters, but generating the report
  91.               directly to the printer, will show all 30 characters of
  92.               text allowed in the input.  The report additionally generates
  93.               a summary of the type of data chosen.
  94.  
  95. SPECIAL
  96.    ABOUT      This option show some info about the program/author.
  97.    SETTINGS   Here you can choose which units of distance and currency
  98.               you want to use.  This will be saved in a small file on 
  99.               your \EXP directory, called exp.cnf, which the program
  100.               checks for each time it starts.
  101.  
  102. EXIT          Finally, this is where you go, when you have had enough of
  103.               the program.
  104.  
  105.     
  106.  
  107.      Finally.  All shortcut keys on the menus should work directly, and I 
  108.      hope that the program is reasonably well-behaved, as I have tried to
  109.      follow the rules for a type 2 OPA.
  110.  
  111.      Any suggestions for improvements, and better ways of doing things,would
  112.      be appreciated, along with any bug reports.
  113.      
  114.     Planned enhancements.
  115.     
  116.     1.  Speed up the browse window.
  117.     2.  An export module, in order to export files or parts of them to
  118.         e.g. the spreadsheet or the database. (work in progress)
  119.  
  120.  
  121.                 Written in ICELAND, in the middle of a winter storm
  122.  
  123.                 Julius K. Bjornsson
  124.                 Nordurtun 9
  125.                 225 Bessastadahreppur
  126.                 ICELAND
  127.  
  128.                 CIS:72500,456
  129.  
  130.  
  131.  
  132.