home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / k / projman / !ProjMan / !Help < prev    next >
Encoding:
Text File  |  1991-10-29  |  10.4 KB  |  284 lines
  1.  
  2.  
  3.                          Help for !ProjMan Version 1.03
  4.                        ----------------------------------
  5.  
  6.  
  7. Author        :    Neil Vickers (Mindwarp).
  8. Written       :    13th August,  1991.
  9. Last modified :    22nd October, 1991.
  10.  
  11.  
  12. Files included in this application :-
  13.  
  14. !Boot                 (Inoculated against the extend virus)
  15. !Help
  16. !Run
  17. !RunImage
  18. !Sprites
  19. ProjFile
  20. Sprites
  21.  
  22.  
  23. N.B.  -  You will need the shared C library version 3.66 or greater to run
  24. ----     this software.
  25.  
  26.  
  27. *****************************************************************************
  28.  
  29.  
  30.  
  31. Using the Project Manager
  32. -------------------------
  33.  
  34.  
  35.     This software was written to automate the setting up of a working
  36. environment suitable for writing software in the C programming language
  37. (although it can quite easily be used to set up environments for any sort
  38. of work).  By selecting a project from the startup window, the program will
  39. automatically change mode, open a directory, and run any applications
  40. requested, thus leaving you in the desired desktop setup for your work.
  41.  
  42.     There will now follow a functional breakdown of the project manager :-
  43.  
  44.  
  45. 1) Creating a working environment
  46. ---------------------------------
  47.  
  48.     When initially started, the project manager should be completely empty
  49. (if it isn't, then the chances are that the person you got the copy off of
  50. used the software, and so the program still has his setup installed. If this
  51. is the case, then just select the 'Clear' option from the window menu, and
  52. the project managers database will be wiped clean).
  53.  
  54.     By moving the mouse pointer over the ten empty slots in the main window,
  55. it can be seen that the slots are highlighted in orange.  Pressing the
  56. MENU button over a slot when it is highlighted causes a menu for that slot
  57. to be created.  To create a new working environment, select the 'Enter'
  58. option from the main window menu (if the enter icon is shaded, then either
  59. the project slot is already used or the mouse wasn't over a project slot
  60. when the MENU button was pressed).
  61.  
  62.     At this point you should be faced with the project entry window.  This
  63. window will allow you to specify the working environment for that project,
  64. and consists of four groups of information :-
  65.  
  66.     i  ) Mode        - This is simply the mode that the WIMP system will
  67.                        change to when the project environment is created.
  68.                        It can be entered by either typing into the icon
  69.                        containing the mode number, or by using the left and
  70.                        right arrows to decrement or increment the current
  71.                        mode number respectively.
  72.  
  73.     ii ) Title        - This is the text string that will appear in the
  74.                         project slot in the main window of the project
  75.                         manager. It is entered by typing the title into the
  76.                         icon supplied.
  77.  
  78.     iii) Directory    - This is the directory that will be opened and
  79.                         changed to when the project environment is created.
  80.                         By dropping a directory into the box provided, that
  81.                         directory will be entered into the project manager
  82.                         database.  If a file is dropped into the box, then
  83.                         the directory that the file is from will be entered
  84.                         into the database.  Clicking SELECT on this icon will
  85.                         have the effect of opening and changing to any
  86.                         directory contained within it.  Clicking ADJUST will
  87.                         clear the directory stored in the box.
  88.  
  89.     iv ) Applications - The five boxes in the applications section are there
  90.                         to have applications (actually any executable files
  91.                         e.g. Obey, Sprite, Text, Templates as well as 
  92.                         true applications) dropped into them. When the
  93.                         project environment is created these applications
  94.                         will be executed in the order of left to right.  If
  95.                         the application box has a Text file in it, !Edit will
  96.                         run and automatically run and load the specified text
  97.                         file (similarly a sprite file will run !Paint etc.).
  98.                         Clicking SELECT on any of the application boxes will
  99.                         run the application stored in it (if there is one).
  100.                         Clicking ADJUST on a box will clear any application
  101.                         stored inside it.
  102.  
  103.  
  104.     After entering all of the above information, click on the OK button to
  105. enter it into the project manager's database (click the Cancel button if you
  106. do not wish the information to be entered).
  107.  
  108.  
  109. 2) Editing a previously entered environment
  110. -------------------------------------------
  111.  
  112.  
  113.     This is simply done by clicking the MENU button over the slot containing
  114. the project environment you wish to edit, and selecting the 'Edit' option
  115. from the main window menu.  A window identical to the environment entry
  116. window will appear with the environment information already present in it.
  117. By changing this information, then clicking SELECT on the OK button, the
  118. environment details may be edited.
  119.  
  120.  
  121. 3) Starting the project timer
  122. -----------------------------
  123.  
  124.  
  125.     By opening the main window fully, it can be seen that each project slot
  126. has associated with it a 'Start date', a 'Finish date' and a 'Duration' box.
  127. When you start work on a project, click the MENU button over the project slot
  128. in the main window and select the 'Start' option.  This will start the
  129. automatic project timer (as will be seen by the current date being inserted
  130. into the 'Start date' box).  Note that you cannot re-start the timer on a
  131. project which has been completed (i.e. finished).
  132.  
  133.  
  134. 4) Stopping the project timer
  135. -----------------------------
  136.  
  137.  
  138.     Click the MENU button over the project slot in the main window and select
  139. the 'Finish' option.  This will stop the automatic project timer running for
  140. that project (as will be seen by the current date being inserted into the
  141. 'Finish date' box and the duration box having an entry placed in it).  This
  142. facility is an added extra to the Project Management system, and will provide
  143. the user with a record of how many hours elapsed between the start of the
  144. project and it's completion.  Note that you cannot stop a project timer
  145. unless it has been previously started.
  146.  
  147.  
  148. 5) Deleting a project environment
  149. ---------------------------------
  150.  
  151.  
  152.     Simply press the MENU button over a project slot and select the 'Delete'
  153. option.
  154.  
  155.  
  156. 6) Clearing the database
  157. ------------------------
  158.  
  159.  
  160.     Press the MENU button over the main window, and select the 'Clear'
  161. option.
  162.  
  163.  
  164. 7) Executing an environment
  165. ---------------------------
  166.  
  167.  
  168.     Move the mouse pointer so that it is pointing at the required project
  169. slot in the main window (the slot will be highlighted orange) and click the
  170. SELECT button.  The environment will then be created.
  171.  
  172.  
  173. Notes
  174. -----
  175.  
  176.  
  177.     As always with the smaller applications, the best way to learn how to use
  178. them is to fall back on the 'suck it and see' principle.  The program has
  179. been written so that it uses Acorns '!Help' application to the full, and so
  180. should be relatively easy to use.
  181.  
  182.     I hope that you will find this program of use.
  183.  
  184.  
  185.  
  186. *****************************************************************************
  187.  
  188.  
  189.  
  190. Application history
  191. -------------------
  192.  
  193.  
  194. 1.00  Fully operating version.                       13th  August, 1991.
  195. 1.01  Project timer installed.                       17th  August, 1991.
  196. 1.02  '!Help' support added.                         18th  August, 1991.
  197.  
  198. 1.03  Program crashes if the ColourTrans module
  199.       isn't installed (many thanx to MUFTI for
  200.       pointing this out!).  This bug has been
  201.       corrected.  Also, the program now needs
  202.       20k less to execute.                           22nd October, 1991.
  203.                       
  204.  
  205. Other titles by the author
  206. --------------------------
  207.  
  208.  
  209. !Multi-acc        (1.20)      Recursive file access.
  210. !Encoder          (1.20)      Simple file encoder.
  211. !Decoder          (1.20)      File decoder for above application.
  212. VNR Ray Tracer    (1.00)      Ray Tracer (Co-author Jason Reading).
  213.  
  214.  
  215. Currently under development :
  216.  
  217. !MultiUtil                    All you would ever want from a file utility.
  218.  
  219. !LogBook                      Keep track of time spent working on projects.
  220.  
  221. TabModule                     A module to give the Archimedes proper TAB's.
  222.  
  223. !TrashCan                     An intelligent dustbin. (Currently available,
  224.                               but written in C.  I'm re-writing it in machine
  225.                               code to make the application smaller.  If
  226.                               anyone wants the C version, mail me.)
  227.  
  228.  
  229.           
  230. Conditions of Use (for what they're worth)
  231. ------------------------------------------
  232.  
  233.  
  234. i  ) This application is supplied free for general use "as is", so I cannot
  235.      guarantee that it is free from bugs or give any warranty about its
  236.      suitability for use (If you notify me of any problems, I'll see what I
  237.      can do).
  238.  
  239. ii ) You have my permission to give this program to anyone you please via
  240.      any medium, provided it is delivered with ALL the original files.
  241.  
  242. iii) I expressly forbid anybody to supply this program on a disc which
  243.      is being charged for (If you bought this program then please contact
  244.      me immediately).
  245.  
  246. iv ) If you want to sell this program, or any part of this program then my
  247.      acceptance must be sought in writing.
  248.  
  249. v  ) I maintain copyright on all the material supplied with this program 
  250.      and reserve the right to change these conditions in cases where I
  251.      deem misuse.
  252.  
  253. vi ) I reserve copyright on all parts of this application.
  254.                               
  255.  
  256.  
  257. How to contact me
  258. -----------------
  259.  
  260.  
  261.     To contact me about bugs or suggested improvements to this piece of
  262. software, please use the E-mail address if you can, as I will be able to
  263. respond to your comments quicker.  For information about this or any other
  264. programs that I have written, or just for a chat about computing in general,
  265. use the address given below (or E-mail if you wish).
  266.  
  267.  
  268.  
  269. Snail mail :                     E-mail :
  270.  
  271.  
  272. Neil Vickers,                    mindwarp@dcs.qmw.ac.uk
  273. 222 Perry Street,                
  274. Billericay,
  275. Essex, CM12 ONZ.
  276.  
  277.  
  278.  
  279. © Mindwarp Enterprises, 1991.
  280.  
  281.  
  282. P.S.  -  I know that this application doesn't conform to Acorn's RISC-OS
  283. ----     style guide, but I think that it looks pretty, so there!    :->
  284.