home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / sillies / makearpc / !MakeARPC / !Help < prev    next >
Text File  |  1998-03-03  |  14KB  |  331 lines
  1. _____________________________________________________________________________
  2.  
  3.                         ‘ M a k e - A - R i s c P C ’
  4.  
  5.              Hours of wholesome entertainment for bored people.
  6.  
  7.                 by Dave Thomas and Justin Fletcher, © 1995-6
  8.                      Original Sprites by Dominic Esplen
  9.  
  10.                          version 1.11 (09 Jun 1996)
  11. _____________________________________________________________________________
  12.  
  13.  
  14.  Introduction _____________________________________________________________
  15.  
  16.   Make-A-Risc PC is a very jolly program for constructing yourself an on-
  17. screen fantasy Risc PC out of small components.  It needs a ‘square pixel’
  18. screen mode to operate in, such as mode 27 or 22. :-)
  19.  
  20.   In your fantasy Risc PC you can have :
  21.  
  22.   • 14- or 17-inch monitor
  23.   • Vertical or horizontal slices
  24.   • Keyboard and mouse
  25.   • Silly stuff, like a toaster slice, a microwave oven slice and
  26.     extra-wide slices.
  27.  
  28.   Make-A-Risc PC is guaranteed free of Lead, E-numbers and dangerous bits of
  29. spikey metal.  It is also guaranteed to not be a fire risk which is more than
  30. can be said of certain Acorn products...
  31.  
  32.  
  33.  Usage ____________________________________________________________________
  34.  
  35.   Load Make-A-Risc PC by double-clicking on its icon in a filer window, it
  36. will install on the right-hand side of the iconbar.  Comprehensive
  37. Interactive Help is available throughout this application, you should use
  38. that in preference to this documentation to find your way about.
  39.  
  40.   Open the main window by clicking Select on the iconbar icon.  This window
  41. consists of an indented ‘depot’ full of parts at the top and a ‘workbench’
  42. area below.  Drag a component part from the depot to the workbench area to
  43. place it.  Once a component is on the workbench it can be moved about by
  44. dragging-and-dropping it.  Components can be duplicated by holding down Shift
  45. and drag-dropping.  Unwanted components can be removed from the workbench by
  46. dragging them anywhere outside the workbench area, typically this means back
  47. onto the depot.  You can also remove components by clicking on the component
  48. you want removed with Adjust.
  49.  
  50.   Construct you fantasy Risc PC by dragging the components to your desired
  51. location and dropping them where they match up.  Build the biggest Risc PC
  52. you can, be the envy of major governments.
  53.  
  54.  
  55.  Menus ____________________________________________________________________
  56.  
  57.   Clicking Menu while over the work area will give you a menu with four
  58. options :
  59.  
  60.   Save  ->    It would be a pity to have to quit this wonderful program
  61.               without keeping a record of how you spent your time wouldn’t
  62.               it ?
  63.               The sub-menu will allow you to save the file in one of two
  64.               formats - Description or Image.  The description file can be
  65.               reloaded by Make-A-Risc PC, and you can look at it in a text
  66.               editor, adding comments if you wish.  The image file is a
  67.               Sprite created using a very crude routine.  This can be used
  68.               in all manner of programs to advertise your machine.
  69.  
  70.   Wire...     This option opens up a small window which contains various
  71.               pieces of cabling which you can use to connect components or
  72.               machines together.  You use this window in the same way as you
  73.               use the depot - just drag the required cable sections from the
  74.               window and drop them onto the workbench.
  75.              
  76.               These cable sections can be used for making fantasy Risc PC
  77.               networks. :-)
  78.  
  79.   Clear       This option simply clears the whole workbench area of
  80.               components.  It doesn’t (yet) ask for confirmation, so be
  81.               careful to not select it before saving your latest
  82.               masterpiece.
  83.  
  84.   Comments... This entry will send the comments section of the Description
  85.               file for the current image to a text editor for editing, so
  86.               you can add comments to your description file.  This only
  87.               works if you are using an editor which supports the ‘External
  88.               Editing’ protocol, such as StrongEd or Zap.
  89.               
  90.               This function is also available by Adjust-clicking on the
  91.               iconbar icon.  Note that the file on disc (if any) is not
  92.               updated, so you must save your description file to update the
  93.               comments.
  94.  
  95.  
  96.  The menu available from the iconbar icon offers these options :
  97.  
  98.   Info    ->  Who wrote this program ?  Just some craaazy guys!
  99.  
  100.   Choices ->  A couple of choices affecting Make-A-Risc PC’s behavior :
  101.  
  102.     Shadows   If set, the parts you drag around the screen will cast
  103.               shadows.  If unset, they don’t... simple innit ?
  104.  
  105.     Locking   If set, when you release a component it will lock to nearby
  106.               components.  This is still very rudimentary, but should
  107.               suffice for most purposes.
  108.  
  109.     Save      Saves the state of the above options to a file called
  110.               ‘Choices’ inside the application directory.
  111.  
  112.   Quit        Removes Make-A-Risc PC from memory.  You won’t be warned if
  113.               you have unsaved data in memory.
  114.  
  115.  
  116.  Components _______________________________________________________________
  117.  
  118.   The components shown in the parts depot (moving from left to right and
  119. bottom to top) are :
  120.  
  121.         - 17-inch monitor, 14-inch monitor
  122.         - Keyboard, Mouse
  123.         - Vertical base slice, slice and top cover
  124.         - Horizontal base slice, slice and top cover
  125.         - Double-width base slice, slice and top cover
  126.         - Microwave oven slice, Toaster slice (yay!)
  127.         - Fish tank, fish
  128.         - Plutonium-powered Amplifier (with graphic equaliser)
  129.         - Dual tape deck
  130.         - Programmer’s Reference Manual slice, Acorn C/C++ slice
  131.         - Tea, Coffee, Orange Juice
  132.         - A precarious stacked pile of discs.
  133.  
  134.   Er, that’s it, now go away.
  135.  
  136.  
  137.  Internationalisation _____________________________________________________
  138.  
  139.   Make-A-Risc PC has been written with multiple language operation in mind.  
  140. By altering the Message and Template files, you can enable Make-A-Risc PC to
  141. run in all languages which RISC OS supports.
  142.  
  143.   If you do create such alternative Message and Template files, we would be
  144. very pleased to hear from you.  We will also include your alterations in the
  145. master versions.
  146.  
  147.  
  148.  Bugs _____________________________________________________________________
  149.  
  150.  • Try putting two toasters on top of a wide slice with locking on...
  151.    Doesn’t work does it ? That’s what you get when you let Justin write some
  152.    code - tut tut... (Justin)
  153.  
  154.  • Seems to leave bits of the Sprites lying around in Mode 22. I think it’s
  155.    a Window Manager problem, rather than one of mine. (Justin)  Yeah, I
  156.    think it’s just a case of the DragASprite blues. ;-) (Dave)
  157.  
  158.  
  159.  History __________________________________________________________________
  160.  
  161.   Yes, there really are people who care about historical notes... and I’m
  162. one of them. :-)  (Justin)
  163.  
  164. Version 1.00 - Dave Thomas (27 Dec 1995)
  165. (Released)   • Main program and Sprites released into PD on web page.
  166.              • Problems with the pane meant that sometimes - very rarely -
  167.                the pane got stuck where it shouldn’t.
  168.  
  169. Version 1.01 - Justin Fletcher (20 Jan 1995)
  170.              • Pane bug fixed, Sprite save added by clicking Menu on the
  171.                workspace.
  172.  
  173. Version 1.02 - Justin Fletcher (21 Jan 1995)
  174.              • Save as text added, and attached to a save box on Menu.
  175.  
  176. Version 1.03 - Dave Thomas (24 Jan 1995)
  177.              • Massive changes to the internals to get rid of all the naff
  178.                code Justin added :-)
  179.              • File type &142 now used to save textual descriptions with
  180.                jazzy Sprite.
  181.              • Part codes used now correct in part (sorta ;-).
  182.              • New Acorn style save box added
  183.              • Menu added - ooohh ! - with option for shadowing during drags
  184.              • Juice and aquarium added. (plus a hidden fish :-)
  185.  
  186. Version 1.04 - Justin Fletcher (29 Jan 1996)
  187.              • Help compliant routines added.
  188.              • Templates re-aligned, and option added to menu for locking.
  189.              • Stack of discs and wire added. (plus a hidden AKF18... grrr)
  190.              • amp and tapedeck
  191.              • Docs updated.
  192.  
  193. Version 1.05 - Dave Thomas (30 Jan 1996)
  194. (Released)   • Added in the auto-load of description file, which I forgot to
  195.                add in last time.
  196.              • Fish unhidden. “Run fwee widdle fishie!”
  197.              • Window & pane enlarged for new parts, amp and tapedeck which
  198.                I also redesigned from Justin’s originals.
  199.              • ‘Structured’ the whole program -- eek!
  200.              • Rewrote some bits of the docs, yuk, yuk, yuk, I hate writing
  201.                docs... ;-)
  202.              • !RunImage is now BasCompressed, saving 16K, I fink.
  203.  
  204. Version 1.06 - Dave Thomas (02 Mar 1996)
  205.              • In a flash of inspiration I thought how much easier it would
  206.                be if my PRMs and C/C++ boxes had their own slices.  Then I
  207.                remembered about this program... :-)
  208.              • Altered the application’s sprite to reflect changes that have
  209.                been made to the parts.
  210.  
  211. Version 1.07 - Justin Fletcher (02 Mar 1996 at some ridiculous time)
  212.              • Added help data for Dave’s new sprites
  213.              • Added Clear option on menu
  214.              • Reorganised the menu structure to include a Options submenu
  215.              • Added Heap management routines to cope with possibility of
  216.                adding and editing comments
  217.              • Made the Messages and Templates language sensitive
  218.              • Added External Edit routines to cope with altering the
  219.                comment
  220.              • Went to send this straight off to Dave, even though it is 25
  221.                to Seven now...
  222.  
  223. Version 1.08 - Dave Thomas (04 Mar 1996)
  224.              • Added the ‘wire’ component, which is handy for fantasy Risc
  225.                PC networks. :-)
  226.              • Changes to Messages file.
  227.  
  228. Version 1.09 - Justin Fletcher (11/12 Mar 1996)
  229.              • External Edits fixed.
  230.              • Checking for quit when modified, new window.
  231.  
  232. Version 1.10 - Dave Thomas (15/16 Mar 1996)
  233. (Released)   • MessageTrans menus implemented.
  234.              • ‘Clear’ now removes comments.
  235.              • prog_info altered, more space basically.
  236.              • Justin’s quit-when-modified window adjusted - new button
  237.                sizes, and the buttons slab to grey.
  238.              • Internationalisation section added above.
  239.              • Upgraded HelpFile reader (1.02).
  240.  
  241. Version 1.11 - Dave Thomas (03 Jun 1996)
  242. (Released)   • Changes to the Messages1 file :
  243.                - Use of "/" between tokens for many-to-one entries. e.g. the
  244.                  wire ones.
  245.                - Addition of lintilla.foobar.co.uk for Dom Esplen's Help
  246.                  entry.
  247.                - Change of URL to http://prompt.essex... for Gerph's entry.
  248.              • Replaced the other 'really?' dbox with a new RO3.5-style one.
  249.              • Minor adjustments to the savebox & prog_info.
  250.              • Feet on the vertical slices.
  251.              • Adjustments to the 'depot' and 'wire' icon sizes.
  252.              • New Plug part in the wire window.
  253.              • 'Glint' pixel added to all the screen parts.
  254.              • 'Clear' now clears the filename, so that the chance of
  255.                overwriting a previous save is reduced.
  256.              • A new and exciting addition, which I'm not going to tell you
  257.                about... You'll have to ask me. ;-)
  258.  
  259.  
  260.  Copyright ________________________________________________________________
  261.  
  262.   This software is the copyrighted work of David Thomas and Justin Fletcher,
  263. it is supplied to you, the user, “as is”; you use this application entirely
  264. at your own risk.  I make no warranty as to the fitness of this software for
  265. any purpose.
  266.  
  267.   You are free to distribute this application to anyone you please via any
  268. medium, as long as you are not supplying it for personal or commercial gain
  269. and it is delivered with all the supplied files unaltered.  If you wish to
  270. supply this software as part of a commerical venture, then contact one of us
  271. to discuss the details.
  272.  
  273.   If you have any comments, bug reports, suggestions for future versions or
  274. anything else don’t hesitate to contact one of us at one of the addresses
  275. below.
  276.  
  277.  
  278.  Contacting the Authors ___________________________________________________
  279.  
  280.  Dave Thomas :
  281.  
  282.     · Dave created this application, drawing the sprites from the originals
  283.       on Dominic Esplen’s RPC Slices page.  He is also to blame for
  284.       structuring the whole thing.  He can often be found in Computer Lab C
  285.       of Liverpool John Moores University, swearing at Windows for not being
  286.       able to run more than four programs at the same time without crashing.
  287.  
  288.     Mr D.P. Thomas
  289.     20 Rosebery Avenue
  290.     Waterloo
  291.     Liverpool
  292.     L22 2BH
  293.  
  294.     E-mail: dpt@tristone.co.uk
  295.     WWW   : http://www.tristone.co.uk/davespace/
  296.     IRC   : #acorn as Spanners
  297.  
  298.  
  299.  Justin Fletcher :
  300.  
  301.     · Justin took the original no-saving version and added the spiffy save
  302.       code in Description and Image formats.  He designed the disc stack,
  303.       exploding monitor and coil of wire parts.  He is a poor student who
  304.       has to work on a TV at the moment after his A5000’s monitor decided to
  305.       do a log fire impersonation.  Send him your spare cash.
  306.  
  307.     Justin Fletcher
  308.     “Galadriel”
  309.     17b Cromwell Road,
  310.     Weeting,
  311.     Brandon,
  312.     Suffolk.
  313.     IP27 0QT
  314.  
  315.     E-mail: Gerph@innocent.com
  316.     WWW   : http://users.essex.ac.uk/users/gerph/
  317.     IRC   : #acorn as Gerph
  318.  
  319.  
  320.  Dominic Esplen :
  321.  
  322.     · Dom’s Home Pages include the legendary ‘Risc PC Slice Ideas’ page
  323.       which provided the inspiration for this application.  Cheers Dom. ;-)
  324.  
  325.     E-mail: se2de@dmu.ac.uk
  326.     WWW   : http://www.cms.dmu.ac.uk/~se2de/
  327.          or http://lintilla.foobar.co.uk/ (evenings)
  328.  
  329. ____________________________________________________________________________
  330.  
  331.