home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -in_the_mag- / reader_requests / whyguru / whyguru.doc < prev    next >
Text File  |  1998-05-02  |  12KB  |  283 lines
  1. =================================================================
  2. = v2.00                   WhyGuru                     15-May-97 =
  3. =================================================================
  4.  
  5.  
  6. (1) Introduction
  7.  
  8. You certainly have already got one of this nasty red blinking bo-
  9. xes to inform you that your computer has crashed. This is the ti-
  10. me where you hate your Amiga.  But what you perhaps don't know is
  11. that she tries to tell you something.
  12. Unfortunately, she does this by giving you the coded cause of the
  13. crash,  coded in an 8-digit-hexadecimal.  But who knows all these
  14. different codes in mind?  So you have to use either a book  where
  15. you look for the specified code or a program  which does the same
  16. for you. Such a program is WhyGuru.
  17.  
  18. Since the first version in  February '96  I have tried to improve
  19. and to expand this program. Unfortunately :(( version 1.3 got the
  20. victim of a bad disk read/write error  before I have been able to
  21. publish it.
  22. This  version  has  been totally rewritten as the code of earlier
  23. versions has been  (a) a little bit ugly and (b) a little (?) bit
  24. buggy and non-system-conform (except version 1.3).
  25.  
  26. I would say  you read the manual even  if you are already used to
  27. an older version of WhyGuru since it isn't still the same.
  28.  
  29.  
  30. (2) How to start WhyGuru
  31.  
  32. Running WhyGuru is an easy thing.  Just double-click it's icon on
  33. the workbench or enter its name in a CLI-window.  WhyGuru runs on
  34. any Amiga with at least  512kB RAM and KS1.3 (??), although I had
  35. not the chance to get it tested on other models than my A12oo.
  36.  
  37. (I doubt that it runs any longer under OS1.3 ??? If anybody could
  38. test this and inform me I would be very pleased.)
  39.  
  40.  
  41. (3) The window
  42.  
  43. You've either the choice to run WhyGuru in a  window or a  shell.
  44. By  using  an  Intuition  window,  the layout looks  a little bit
  45. better. The layout's been created with David Benn's ReqEd.  Using
  46. a shell will give you the same informations (ooops, without s; if
  47. my English teacher would see this ;-),  but just as text. In  the
  48. former case  you need the  thinpaz.font in your FONTS: directory.
  49.  
  50.  
  51. (4) Options and tooltypes.
  52.  
  53. I tried to make  WhyGuru  as  comfortable  to use as possible. As
  54. said above, version 1.3 has been "killed", so many functions have
  55. been gone again ;-(
  56. I  will  try  to add them again in the next version  if anyone is
  57. interested (font sensitivity, set window location, ...).
  58.  
  59. At the moment there are only three options/tooltypes:
  60.  
  61.  (a) Only start if there has        CLI : AUTO
  62.      been a guru                    WB  : AUTO=ON/OFF
  63.  
  64.  This option is for including  WhyGuru  in  your StartUp-Sequence
  65.  or in your WBStartUp drawer,  since it will check  whether there
  66.  was an alert and if there has been none it won't start.
  67.  Furthermore,  WhyGuru  overwrites the last alert code with zeros
  68.  when finished (but _only_ when using "AUTO")  since  if  you are
  69.  going to do a reset via CTRL-LA-RA,  the last code will still be
  70.  in memory and Whyguru would explain it again. By overwriting the
  71.  code this problem is fixed.
  72.  
  73.  (b) Toggle display                 CLI : WINDOW
  74.                                     WB  : -
  75.  
  76.  If  WhyGuru  has been launched from a shell,  no  window will be
  77.  opened  but a text will be printed. By using WINDOW WhyGuru will
  78.  not do that but will open the same intuition window as if it has
  79.  been launched from WB.
  80.  
  81.  (c) Sensitive mode                 CLI : SENSITIVE
  82.                                     WB  : SENSITIVE=ON
  83.  
  84.  It may be  that you get regularly  crashes  you don't want to be
  85.  shown (i.e. after having made a reset, guru 14041004 [trackdisk.
  86.  device can't open a device]  appears  within  WhyGuru,  although
  87.  EXEC didn't show this guru. This does happen on my 12oo.)
  88.  So you have the possibility to create a file called  WhyGuru.not
  89.  in your  S:  directory where you can specify an unlimited number
  90.  of  guru codes  which won't be displayed anymore  when using the
  91.  sensitive mode.
  92.  The  file's  structure  is  easy.  Lines  starting  with a # are
  93.  comments. A guru number is specified by beginning a new line and
  94.  typing the 8 numbers of it.  There  MUST  be  NO space after the
  95.  number,  otherwise  it  is  ignored.  Just save the file than as
  96.  S:WhyGuru.not and it will be ready for use.
  97.  
  98.  P.S. : Make sure that there's a free line at the end of the data
  99.         file.
  100.  
  101.  P.S.S. : When using the SENSITIVE mode and a guru appeared which
  102.           is specified in s:WhyGuru.not, WhyGuru won't start  (as
  103.           if no guru occured and the ALWAYS mode is on).
  104.  
  105. (6) Known bugs
  106.  
  107. This bug is no bug (but could lead to misunderstandings):  If you
  108. press the right mouse button  or do a warm reset  when your Amiga
  109. displays an alert, it might be that the guru number is lost !!!!!
  110. Do always "answer" an alert by pressing the left mouse button!
  111.  
  112. I was told  that the bottom lines of the bevelboxes are sometimes
  113. destroyed.  This did NOT happen on my A5oo  but since I am having
  114. my new 12oo :-))))) I have also been able to watch this -> fixed.
  115.  
  116. Another problem could be the position of the guru number in memo-
  117. ry. It should be in ExecBase->LastAlert. Curious, but this is not
  118. the case on my A12oo. Here it is at $100 (interrupt vector). This
  119. version  does  read its value from $100  as I have not heard  any
  120. complaint until now  (1.x versions got it from $100 as well).  If
  121. WhyGuru does not work on your machine, please, contact me!
  122.  
  123. As to my knowledge  there are no more bugs,  but one can never be
  124. sure. So if you find one -> my address can be found below.
  125.  
  126.  
  127.  
  128.  
  129. (7) Future features
  130.  
  131. Well,  I'd like to hear YOUR ideas  and I want your help.  If you
  132. have any idea,  suggestion  or even bug reports,  improvements or
  133. adding or better explanations for alert codes  please contact me.
  134.  
  135. And what  I really need are texts for a <Detailed>¹ function.  So
  136. if you can explain an alert code in no more words than fitting on
  137. a HiRes screen  with Topaz 8,  perhaps with some typical examples
  138. which cause such a guru in ACE, Assembler and/or C PLEASE!!! tell
  139. me!
  140.  
  141.                                     ¹ I thought of a button which
  142.                                       will deliver more! than one
  143.                                       line of explanation. When I
  144.                                       have enough texts, I'll add
  145.                                       this feature.
  146.  
  147.  
  148. (8) History
  149.  
  150. version  date      description
  151. -----------------------------------------------------------------
  152. 1.00     16-02-96  first try
  153.          18-02-96  finished
  154. 1.10     20-02-96  removed 2 awful bugs : in the developed source
  155.                    I forgot a }  and all hexadecimal codes in the
  156.                    data lines were handled as decimal :(
  157. 1.20     12-03-96  created window layout with ReqEd1.11s by David
  158.                    Benn, so that WhyGuru can now be launched from
  159.                    the workbench.
  160. 1.21     16-03-96  How could that happen!?  I have just found out
  161.                    that there is _again_ an awful bug: instead of
  162.                    the subsystem the detailed explanation code is
  163.                    printed :((( Fixed.
  164.          17-03-96  Added feature to change the font for  display-
  165.                    ing the explanation texts
  166. 1.22     13-05-96  Added 39 (!) new explanations. Found in books'
  167.          14-05-96  appendices and in other guru programs.
  168. 1.30     15-05-96  Created new layout
  169.          19-05-96  added the "new alert code" gadget but had some
  170.          20-05-96  problems converting the input
  171.          26-05-96  fixed also some problems with the graphics
  172.          27-05-96  optimizing
  173.          28-05-96  wrote manual
  174.          29-05-96  lost the whole source -> the only survivors
  175.                    were the manual and the ReqEd file :-(
  176.                    Perhaps I should not have used NoName disks ?
  177.                    I am happy to have a harddisk now :-))
  178. 2.00     28-03-97  Rewrote the whole source
  179.          31-03-97  After having had a nice Easter weekend I fixed
  180.                    some bugs and wrote the manual.  Furthermore I
  181.                    added some more (30) alert codes ;-)
  182.          04-04-97  Added the AUTO function
  183.          05-04-97  Fixed a bug when reading the tooltypes
  184.          03-05-97  Fixed a bug.
  185.          05-05-97  Fixed a bug  (actually a bug in  NAP  but this
  186.                    lead to some unprocessed defines  and ACE just
  187.                    put some random value in these "variables")
  188.          08-05-97  Added the sensitive function.
  189.          15-05-97  Fixed a bug in the sensitive function.
  190.  
  191. (9) Copyright / Disclaimer
  192.  
  193. This program is  fully copyrighted  by the author (see below) and
  194. NO changes are allowed to made, neither in the program itself, in
  195. the source code or in any further file  belonging to the official
  196. program package.
  197. It is allowed to copy the program freely² but you are not allowed
  198. to sell it  alone  or together with other programs  on a disk for
  199. more than  5,00 DM  or the same in any other currency  (20 SEK or
  200. 3 US$ or £2 or ...).  The author of this program is reserving the
  201. right to forbid special persons or even firms  to sell or to dis-
  202. tribute this program in any form and in any way       (as of now:
  203. military organisations and non-democratic persons / firms, ... do
  204. NOT have the right to use WhyGuru  [although I can not image  why
  205. they should like to do this ? ])
  206.  
  207.                       ² before that I'd like to hear from you how
  208.                         you like WhyGuru, if possible.
  209.  
  210. Furthermore, this program is distributed without any warranty. If
  211. you lose datas or get anything damaged, ...  by the direct or in-
  212. direct influence / activity of this program  the author cannot be
  213. made responsible in any kind. Even as the program has been tested
  214. detailed as it has been possible you use it on your own risk !!!!
  215.  
  216. As of version 2.0  the  source  code is no longer included.  Dis-
  217. assembling is of course strongly forbidden. If anyone is interes-
  218. ted in the source code s/he can send me 5,00 DM (20 SEK, 3 US$ or
  219. £2) in cash and I'll E-Mail the code.
  220.  
  221. (A) Thanks ...
  222.  
  223. My thanks goes to ...
  224.  
  225.   ... David Benn for having developed ACE and ReqEd 1.11, as well
  226.       as the WBarg submodule
  227.   ... Herbert Breuer  for his  advanced help in  programming  the
  228.       Amiga.
  229.   ... all the people who invented and developed the Amiga.  Great
  230.       work!
  231.  
  232.  
  233. (B) Contacting the author
  234.  
  235. My name is Daniel Seifert and I'm born in 1978. At the moment I'm
  236. studying  at  the  "1st  Grammar  School  Hellersdorf"  (Leonard-
  237. Bernstein-Gymnasium) whereas Hellersdorf is the eastermost suburb
  238. of Berlin, which is the capital of Germany, as you probably know,
  239. don't you? ;-))
  240. My favourite subjects are Maths, English and,  of course,  compu-
  241. ting.
  242.  
  243. If you want to contact me, there are three possibilities:
  244.  
  245.  (a) E-Mail (preferred)
  246.  
  247.      You can reach me at my school: dseifert@hell1og.be.schule.de
  248.      Please  give  me  some  time to answer -> holidays, exams or
  249.      problems with the school computer (no Amiga :-(
  250.  
  251.      After June '98 this EMail address might have gone (hm, well,
  252.      if not I'll  have a little problem ;-) so use the snail mail
  253.      address instead to ask for my  new address  (or look out for
  254.      new programs by me ;-)
  255.  
  256.      WWW
  257.  
  258.      Well, as  of  now  I do not have my own home page :-( But if
  259.      you are interested in a (German) math corner, which I helped
  260.      to create, take a look at :
  261.             http://members.aol.com/fuzzymathe/index.htm
  262.  
  263.  
  264.  (b) snail mail
  265.  
  266.      Please do only expect an answer if you enclose  some  money
  267.      for my costs (postage, ...). I am a little bit out of money
  268.      (aren't student always ? ;-)) so I just don't want to spend
  269.      my money on this.
  270.      (Err, I almost forgot my address ;)
  271.  
  272.               Daniel Seifert
  273.               Elsenborner Weg 25
  274.               12621 Berlin
  275.               GERMANY
  276.  
  277.  (c) telephone
  278.  
  279.      Well,  I  cannot  imagine  that anybody wants to contact me
  280.      this way. But anyway: call  (+49) ([0]30) 5669471  and  ask
  281.      for Daniel.                       ^ Berlin
  282.                                  ^ Germany (check this!)
  283.