home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / w3_apps / tdlv11.arj / READ.ME < prev    next >
Text File  |  1992-02-12  |  7KB  |  199 lines
  1. Program    Name    -    Equinox/TDL (To Do List)
  2.  
  3.  
  4.      Version    -    1,1
  5.        Dated    -    February 1992
  6.       Author    -    Steve Higginson
  7.  
  8.  
  9.  
  10. Introduction
  11.  
  12. Thank you for downloading my To Do List.  It is a very simple program
  13. that is  my first  true (and  useful)  programming  assignment  under
  14. Visual Basic of the differences between me  and other VB programmers,
  15. is that I've had a quick look at the  license  agreement for  the DLL 
  16. file and have discovered that you can freely copy it. Therefore, I've 
  17. include it here in the ZIP file.
  18.  
  19. The program  was developed on an Apricot Qi 900. This is a i486 based
  20. system. It had  8Mb RAM and  an 80Mb SCSI  hard  disk.  I chose  this 
  21. system because I find that  the screen redraw of  VB is a little slow
  22. in the development environment (even on a i486 based system).
  23.  
  24. I speak  about  my little(?) computer in the past tense  because I no
  25. longer work for the  company that  owned it.  Any further  updates to
  26. the program will have to be done on my own 386SX system (Arrgh!).
  27.  
  28. The program makes  use of only 3 files.  These are the  main database
  29. file itself (TO_LIST.DAT), a work file (~TO_WRK.TMP) which you should
  30. never  see (unless the system  terminates during a delete & re-org of 
  31. the main  file,  and a parameters  file (TO_INI.DAT) that  is used to
  32. store the parameters for printing.  Unfortunately,  because I haven't
  33. included the  reports in this version,  there's no point  in you even
  34. using it (but it's worth a look).
  35.  
  36.  
  37.  
  38. Installation
  39.  
  40. The program should  be copied  to your hard disk into the appropriate
  41. directory.  The VBRUN100.DLL file  shoud  be copied to your Windows/3
  42. directory  unless the  directory TDL is resident in  is also  in your
  43. search path.
  44.  
  45. Install the  program in your required  group by using  the 'File New'
  46. option in Program Manager. The system should now be ready to use.
  47.  
  48.  
  49.  
  50. Using the program
  51.  
  52. When  you first load TDL, it will not find the datafile and will ask
  53. you  if  you want  to create a  new  one.  Answering  'Yes'  to this
  54. question will create a new file.
  55.  
  56. You will then  be presented  with an empty 'To Do List' and with the
  57. Add/Delete/Edit  command  keys.  There are  shortcut keys (discussed
  58. later in this document) but these are not functional if there are no
  59. projects to handle.
  60.  
  61.  
  62.  
  63. Adding a Project
  64.  
  65. This procedure will  display the entry  form and allow you to  enter
  66. the relevant details into the correct fields.  A simple line of help
  67. at the bottom of the screen explains what each field is for.  If you
  68. wish to add the project to the  database,  select the OK button.  To
  69. disregard the entry, select cancel.
  70.  
  71. Selecting OK will write the record to the database and include it in
  72. the list box on the main form.
  73.  
  74.  
  75.  
  76. Deleting a project
  77.  
  78. This procedure  will remove a  project from  the database.  It  will 
  79. first confirm that you  really want to  remove the selected project.
  80. If  you  do,  it  will  re-organise  the  file  on  completion.  The 
  81. project will also be removed from the listbox on the main form.
  82.  
  83.  
  84.  
  85. Editing a Project
  86.  
  87. Selecting this  button will  simply bring up  the currently selected
  88. project  and  allow you  to modify  its  details.  Selecting OK will 
  89. re-write the project and update the listbox on the main form.
  90.  
  91.  
  92.  
  93. Shortcut Keys
  94.  
  95. The following shortcut keys apply to the system providing that there
  96. are entries in the database:
  97.  
  98. --------------------------------------------------------------------
  99. Keyboard    ShortCut        Description
  100. --------------------------------------------------------------------
  101. Alt+A        Ctrl + Left Mouse     Add a new Project.
  102.  
  103. Alt+E        Shift + Right Mouse    Edit selected project.
  104.  
  105. Alt+D        Ctrl + Right Mouse    Delete Selected project.
  106.  
  107. -        Right Mouse only    View Details of selected
  108.                     project.
  109.  
  110.  
  111.  
  112. Other Editing Information
  113.  
  114. The entry fields can be reached in a number of ways. Either by using
  115. the TAB key to cycle around the fields, using the mouse and clicking
  116. in the field, or by  selecting the Alt key and the underlined letter
  117. in the field description (eg: Alt+C for the Phone Call flag).
  118.  
  119. The Details field can  have multiple lines within it. All the normal
  120. Windows/3 editing facilities  apply.  To set up tabs  in the details
  121. field,  use the Ctrl+TAB  key  instead of  the normal TAB key (which
  122. will move the cursor to the next field)
  123.  
  124.  
  125.  
  126. The following is a plan of upgrade for the Equinox/TDL program:
  127.  
  128. --------------------------------------------------------------------
  129. Version            Details
  130. --------------------------------------------------------------------
  131.  
  132. Version 1.0        Licensed to my old company.
  133.  
  134. Version 1.1        (This  Version)   Shareware  release of  the
  135.             program.
  136.  
  137. Version 1.2        Inclusion  of general  reports (Detailed and
  138.             summary). Also better error handling & field
  139.             validation. I will also  include a Windows/3
  140.             help file  (If  I can  get hold of  the help
  141.             development system).
  142.  
  143. Version 2.0    -    ADVANCED VERSION.  More detailed information
  144.             about  the project including client name and
  145.             contact fields, assignment fields as well as
  146.             history and  personnel stats.  Also includes
  147.             more detailed reporting.
  148.  
  149.             This release of    the  program  would be ideal
  150.             for  Technical supervisors and managers.
  151.  
  152.  
  153.  
  154.  
  155. Known problem associated with TDL (or Visual Basic)
  156.  
  157. I have noticed only one problem in the day to day usage of TDL. This
  158. is  when you  close  the program using  either Alt+F4 (or  the close
  159. option on the control menu). You should use the File+Exit  option to
  160. ensure correct closure  of the program. Alt+F4 will 'sometimes' (and
  161. I mean very rarely ) leave the  program running  although  you can't
  162. see the  window.  This  means that  the main  database file is still
  163. open and assigned exclusively to the rogue TDL program.
  164.  
  165. This can be  annoying if your  a Windows addict like  me (everything
  166. has to be just so or else!) but shouldn't cause any real problems. I
  167. need to speak to Microsoft (the hold music is nice) to see if it's a
  168. VB bug or something I'm not doing correctly. If the system generates
  169. a file problem then  check for other copies of the  program by using
  170. the Task Manager (TDL File+Run).  You will be able  to terminate the
  171. rogue program from Task Manager as well, and then gain access to the
  172. database file.
  173.  
  174.  
  175.  
  176. Other information
  177.  
  178. I would appreciate any criticisms or suggestions for TDL. It is one
  179. of my first VB programs but I'm suitably proud of it and would like
  180. to see it take off. I don't ask for any royalties or  donations for
  181. the use of it - I'm a true tecky and do it for the challenge.
  182.  
  183. As I'm a player in the Apricot game, you should be  able to leave a 
  184. message for me on  their Technical BBS  (Tel: 021 717 0444  if  you
  185. don't already know it).
  186.  
  187.  
  188.  
  189. And Finally ...
  190.  
  191. I'll have to say  that the Apricot BBS is one of the BEST in the UK
  192. or the technical staff there will  gather together  in small groups
  193. and whisper about me.
  194.  
  195.  
  196.  
  197. Regards
  198. Steve Higginson
  199.