home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / math / godel / guru.hxt < prev    next >
Text File  |  1993-06-29  |  16KB  |  368 lines
  1. #P01         THE GURU - A HyperText Help facility for the ST (v1.0)
  2.  
  3. The Guru is a simple yet powerful HyperText desk accessory for the ST.
  4. You just called the Guru by selecting the Guru item from the desk accessory
  5. menu.  The Guru window can be resized, moved etc in the normal fashion, or
  6. just left on the desktop whilst you continue with your other tasks.
  7.  
  8. The Guru is included here to provide an online help system for #L05Godel#E.
  9.  
  10. The Guru displays information as a series of cards.  This is the first card.  
  11. You can move through the stack of cards by pressing 'N' (next card), 'P' 
  12. (previous card) or 'F' (first card).  Some words are printed in bold script.  
  13. This means that these words are linked to other cards.  If you move the mouse 
  14. pointer over a word written in bold script and click you will move to the 
  15. linked card.  You can return by pressing 'P', or continue onwards as you wish.
  16. Pressing 'R' will provide you with a dialog box to load a new HyperText file,
  17. or 'W' for information about WoolleySoft.
  18.  
  19. This demonstration contains information on the following:
  20.               #L021.     More about The Guru and WoolleySoft#E
  21.               #L042.     Constructing your own HyperText documents#E
  22.               #L053.     Godel Help System#E
  23. #N02
  24. #P02                                 SHAREWARE!!
  25.  
  26. The Guru is shareware.  It is supplied in two versions - a PD version 
  27. distributed to public domain libraries which may be copied freely so long
  28. as the GURU.HXT, GURU.DOC and GURU.ORD files are included (this version will 
  29. remind you to register every time you use the mouse pointer to link to a card),
  30. and a registered users version, which omits the reminder but is tagged to
  31. identify the user who received the registed copy.
  32.  
  33. Any Hypertext documents created for The Guru may be distributed freely without
  34. restriction of any kind.
  35.  
  36. Registered users will be entitled to updates at nominal cost, together with
  37. discounts on other WoolleySoft products.
  38.  
  39. To receive your registered copy of The Guru send Ten Pounds Sterling to
  40.  
  41.                          WoolleySoft
  42.                          Humblesknowe Cottage,
  43.                          Ramoyle,
  44.                          Dunblane,
  45.                          Perthshire,
  46.                          Scotland
  47.                          FK15 0BA
  48.  
  49. If possible please use the order form supplied as the ORDER.DOC file
  50. #N03
  51. #P03                                WoolleySoft
  52.  
  53. WoolleySoft is a shareware software house supplying software for the more
  54. serious side of the Atari ST and IBM PC computers.  To date (1/1/92) we
  55. supply the following products :-
  56.  
  57.        Hype!     : A comprehensive HyperMedia facility for the ST computer.  
  58.                    Includes text, graphics and sound capabilities.  Demo disk 
  59.                    available for three pounds (please specify Mono or Colour). 
  60.                    Registration twenty pounds.
  61.  
  62.  
  63.        DataStore : Database for the ST computer.  Includes label printing and
  64.                    advanced report writing capabilities.  Demo three pounds.
  65.                    Registration seven pounds.
  66.  
  67.        The Guru  : HyperText help facility for the ST and PC.  Demo three
  68.                    pounds.  Registration ten pounds.
  69.  
  70.        Godel     : A mathematics processor: does arithematic, solves equations,
  71.                    plots graphs, does calculus.  Demo three pounds. Registration
  72.                    ten pounds.
  73. #N01
  74. #P04                  Creating HyperText documents for The Guru
  75.  
  76. HyperText documents used by The Guru should be created as standard ASCII files
  77. using any suitable text editor.  On booting the ST The Guru will attempt to 
  78. load a file called GURU.HTX from the boot directory (ie A:\ on most systems).
  79. A different file can be loaded later if required by pressing R for reload.
  80.  
  81. The Guru considers all documents to be made up of pages.  Each page can be up 
  82. to 30 lines in length.  The start of a page is identified in the ASCII file by
  83. the characters #Pxx, where xx is any number from 00 to 99.  A page is
  84. considered to continue until the next #Pxx string is found.
  85.  
  86. Each page should contain a #Nxx string.  This indicates the page to which the 
  87. system will move when N (next page) is pressed.  Again xx is any number from
  88. 00 to 99.
  89.  
  90. Within each page link strings (which will be displayed a bold) should be
  91. surrounded by the characters #Lxx (which starts the link text) and #E (which
  92. ends it).  Again xx represents any number from 00 to 99.  When the mouse is
  93. clicked on the link text the system will move to the page indicated.
  94.  
  95. And that's it!  Simple, but extremly powerful.
  96. #N01
  97. #P05      ****************************************************************
  98.       *** GODEL - The intelligent maths processor for the Atari ST *** 
  99.       ****************************************************************
  100.  
  101. ** Contents **
  102.  
  103. #L061.  Introduction#E
  104.  
  105. #L072.  Getting Started#E
  106.  
  107. #L083.  Conventions#E
  108.     3.1.  Numeric Formats
  109.     3.2.  Unknowns
  110.     3.3.  Powers
  111.     3.4.  Brackets
  112.     3.5.  Equations and expressions
  113.     3.6.  Errors
  114.     3.7.  Timings
  115.  
  116. 4.  Functions
  117.     #L094.1.  DESK#E
  118.           4.1.1.  About Godel
  119.  
  120.     #L094.2.  FILE#E
  121.           4.2.1.  Quit
  122.  
  123.     #L104.3.  ALGEBRA#E
  124.           4.3.1.  Define Constants
  125.           4.3.2.  Enter Expression
  126.           4.3.3.  Display Function
  127.           4.3.4.  Summation
  128.           4.3.5.  Differentiate
  129.           4.3.6.  Integrate
  130.           4.3.7.  Show Working
  131.           4.3.8.  Save Working
  132.           4.3.9.  Erase Working
  133.           4.3.10. Print Working
  134.  
  135.     #L114.4.  GRAPHS#E
  136.           4.4.1.  Set Parameters
  137.           4.4.2.  Plot Graph
  138.           4.4.3.  Erase Graph
  139.           4.4.4.  Print Graph
  140.  
  141.     #L124.5.  WOOLLEYSOFT#E
  142.           4.5.1.  Using Godel
  143.           4.5.2.  About WOOLLEYSOFT
  144.           4.5.3.  Shareware
  145.  
  146. #L135.  The Tool Palette#E
  147.  
  148. #N06
  149. #P061.  Introduction **
  150.  
  151. Godel is an intelligent mathematics processor which can do arithmetic, solve
  152. equations, plot graphs and even knows calculus!
  153.  
  154. Why waste time doing your maths homework when Godel will do it for you, and let
  155. you get back to the serious business of beating the latest computer game!
  156.  
  157. Godel is the latest Shareware product from #L03WOOLLEYSOFT#E.  The PD version is
  158. fully functional, with the following exceptions
  159.  
  160. a.   The 'Show Working' function has been turned OFF.  This means that you will
  161.      not be able to see the working required to produce the final answer when 
  162.      simplifying expressions or solving equations.  
  163.  
  164. b.   The program will not process any equation whose final form after 
  165.      simplification includes a power of x greater greater than 1.  For example 
  166.      Godel will process 5 = 2x-3 or y = 1/2x, but not 6 = x(x+2) or y = 1/x^2.
  167.      However expressions will be processed - so for instance (x+2)(2x-3) will
  168.      be simplified to give 2x^2 + x - 6.
  169.  
  170. If you register with us (a mere 10 pounds, a registration form is included on 
  171. this disk) we will supply you with the latest full version which gives you the 
  172. intermediate steps in the working out and no restrictions on equation 
  173. processing.
  174.  
  175. #N07
  176. #P072.  Getting Started **
  177.  
  178. Godel runs in either high or medium resolutions.  If you are running on a
  179. colour monitor or TV in low resolution you should reset to medium using the
  180. SET PREFERENCES item in the OPTIONS menu.  You will need both GODEL.PRG and
  181. GODEL.RSC in the folder from which you are running.  GODEL uses the standard 
  182. GEM environment.
  183.  
  184. Kick off the program in the usual way by double clicking on the GODEL.PRG icon.
  185. The PD version will present you with a dialog warning you about the PD 
  186. restrictions, and after clicking on EXIT you will then enter the program proper.
  187.  
  188. Godel uses three windows.  The WORKING window is, as you might expect, the work 
  189. pad.  Godel writes information here about the expression or equation being 
  190. processed.  The PLOT GRAPH window is used to plot graphs for equations, and the 
  191. #L13TOOL PALETTE#E window contains a tool kit (all the functions on this are also 
  192. available through the menu).
  193.  
  194. We'll go through the details of the program later, but for now lets try 
  195. entering first an expression to simplify, then an solving an equation and 
  196. plotting it's graph.
  197.  
  198. Click on the f(x) icon in the #L13TOOL PALETTE#E window (top left), or chose the 
  199. "Enter expression" item from the #L10ALGEBRA#E menu heading.  A dialog box appears
  200. for you to enter an expression.  Type in "(2x-3)(x+5)" (omitting the quotes),
  201. and click on OK when done.  The dialog box will disappear and the program will
  202. write the following to the work window:
  203.  
  204.         Processing (2x-3)(x+5)
  205.         2x^2 + 7x - 15
  206.  
  207. (note that the carat sign ^ is used in this document to indicate a power both 
  208. where Godel would print a power directly, or where you need to enter one).
  209.  
  210. Now lets try an equation.  Click on the f(x) icon again and enter "3 = 2(x-1)".
  211. The following appears in the WORKING window.
  212.  
  213.         Processing 3 = 2(x-1)
  214.         Solving for linear equation
  215.         solution = 5/2
  216.         Q.E.D.
  217.  
  218. Now to plot this equation.  Go to the #L11GRAPHS#E menu heading and choose the 
  219. PLOT GRAPH item.  The graph will now be plotted in the PLOT window.  You
  220. can view this graph by expanding the window in the usual way.
  221.  
  222. #N08
  223. #P083.  Conventions  **
  224.  
  225.     3.1.  Numeric Formats
  226.           Godel processes integers and fractions.  It does not understand 
  227.           decimals.  All numbers should be entered in the format n, n/d or
  228.           i/n/d.  Thus the following are all valid: 1, -45, 1/6, 24/78, -7/21,
  229.           2/1/2 (this last is read as two and a half).  Within any expression 
  230.           a number is assumed to be a fraction where possible :- for instance
  231.           1/2x will be interpreted as one half times x, and NOT 1 over 2x.
  232.           The latter should be entered as 1/(2x).
  233.  
  234.     3.2.  Unknowns
  235.           Godel will only accept x as an unknown.  It understands all the
  236.           usual mathmatical conventions, so that the following are all valid
  237.           expressions: x, 2x, 2(x+1), x(x+1).
  238.           Two clarify the display of reciprical unknows (i.e. 1/x etc) the 
  239.           following convention is used:  1/6x should be read as 1 divided by 
  240.           6 times x, and 1/6.x should be read as one sixth times x.
  241.  
  242.     3.3.  Powers
  243.           Where possible Godel will print out powers as superscripts in the
  244.           usual way.  Where not possible, and where powers must be entered
  245.           from the keyboard, Godel understands the ^ symbol as indicating that
  246.           the next number is a power (i.e. x^2 is x squared).  All powers must 
  247.           be positive whole numbers less than 5.  The following expressions 
  248.           are therefore all valid: x^2, 2x^2, (2x+1)^3.
  249.  
  250.     3.4.  Brackets
  251.           Godel understands the usual conventions.  Furthermore Godel computes
  252.           using infix conventions, i.e. it works out the contents of brackets 
  253.           from the inside out - normally!  Any number of brackets may be nested.
  254.           The full shareware version displays the working out for each set of 
  255.           brackets.
  256.  
  257.     3.5.  Equations and expressions
  258.           Simply, expressions do not contain an equals sign, equations do.  
  259.           Equations may be in one of two forms: solvable, such as 3 = 2x-1,
  260.           and non-solvable, such as y = 2x - 1 (Godel only accepts the term
  261.           "y =" on the left hand side of an equation, and it must be in 
  262.           precisely this format - i.e. "2y =" would not be valid.  Godel will 
  263.           always attempt to solve the first, but will just simplify the second 
  264.           as far as possible.  Godel will only plot, summate, or perform 
  265.           calculus on equations.
  266.  
  267.     3.6.  Errors
  268.           Godel will report on any detected errors in the WORKING window, and
  269.           if sufficiently serious, will halt the computation.
  270.  
  271.     3.7.  Timings
  272.           Godel may appear to 'hang' if you enter an expression which gives an 
  273.           intermediate of a high order with large multiplicands 
  274.           (ie 1/(2x-6) * (x^3+x-1)/(2x-5)).  This is because the program will
  275.           be looking for all possible simplifications - and this could take a 
  276.           while.  Go away and make a cup of coffee! (The final answer is
  277.           (x^3+x-1)/(4x^2-22x+30).
  278.  
  279. #N09
  280. #P094.  Functions **
  281.  
  282.     4.1.  DESK
  283.           4.1.1.  About Godel
  284.           This prings up a dialog box displaying basic information about 
  285.           version, release date and author.
  286.  
  287.     4.2.  FILE
  288.           4.2.1.  Quit
  289.           Quits Godel
  290. #N10
  291. #P10    4.3.  ALGEBRA
  292.           4.3.1.  Define Constants
  293.           Godel allows you to define up to seven constants.  Enter the constant
  294.           and it's value using this dialog.  A constant can be any valid string,
  295.           for example you could define A as: 2, 22/7, x+1, 2(x-1).  
  296.  
  297.           4.3.2.  Enter Expression
  298.           Use this dialog box to enter an expression or equation.
  299.  
  300.           4.3.3.  Display Function
  301.           The last equation or expression entered is considered to be the 
  302.           current function (in it's simplified or solved format).  This item 
  303.           displays the current function.
  304.  
  305.           4.3.4.  Summation
  306.           Only available for equations.  Works out the value of the equation 
  307.           for all integer values between the maxiumum and minimum (inclusive) 
  308.           entered by the displayed dialog box.
  309.  
  310.           4.3.5.  Differentiate
  311.           Only available for equations.  Differentiates the current function.
  312.  
  313.           4.3.6.  Integrate
  314.           Only available for equations.  Integrates the current function
  315.           (note that the constant of integration is ignored).
  316.  
  317.           4.3.7.  Show Working
  318.           When turned on displays details of the computation in the WORKING
  319.           window.  Not available in the PD version.
  320.  
  321.           4.3.8.  Save Working
  322.           Writes the current contents of the WORKING window to a file.
  323.  
  324.           4.3.9.  Erase Working
  325.           Erases the current contents of the WORKING window.
  326.  
  327.           4.3.10. Print Working
  328.           Sends the current contents of the WORKING window to the printer.
  329. #N11
  330. #P11    4.4.  GRAPHS
  331.           4.4.1.  Set Parameters
  332.           Only available for equations.  Displays a dialog box that allows you
  333.           to set the x and y range to be plotted, and an optional graph title.
  334.           Initially set to no title and x and y ranges of -10 to +10.
  335.  
  336.           4.4.2.  Plot Graph
  337.           Only available for equations.  Plots the current function.
  338.  
  339.           4.4.3.  Erase Graph
  340.           Only available for equations.  Erases the current plot and resets
  341.           the parameters to the defaults.
  342.  
  343.           4.4.4.  Print Graph
  344.           Only available for equations.  Sends the current contents of the
  345.           PLOT GRAPH  window to the printer.
  346. #N12
  347. #P12    4.5.  WOOLLEYSOFT
  348.           4.5.1.  Using Godel
  349.           Displays some information about Godel.
  350.  
  351.           4.5.2.  About WOOLLEYSOFT
  352.           Displays some information about WOOLLEYSOFT.
  353.  
  354.           4.5.3.  Shareware
  355.           Displays some information about the shareware status of Godel.
  356. #N13
  357. #P135.  The Tool Palette.
  358.  
  359. All the functions on the tool palette may be accessed through the menus.  The
  360. functions are placed on the palette as follows.
  361.  
  362.  Enter     | Sum      | Differentiate | Show    | Erase   | Plot       | Erase  
  363.  function  |          |               | Working | Working | Graph      | Graph
  364.  -----------------------------------------------------------------------------
  365.  Set       | Show     | Integrate     | Save    | Print   | Set Graph  | Print
  366.  Constants | Function |               | Working | Working | Parameters | Graph
  367. #N05
  368.