home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / system / sphinx.lzh / SPHINX2.5y / Docs / AlertChart.doc < prev    next >
Encoding:
Text File  |  1992-01-10  |  4.5 KB  |  92 lines
  1.  
  2.                   Sphinx.doc v2.5b
  3.          ⌐ 1991, Nicolas Dade. All Rights Reserved
  4.  permission is hereby granted for non-commercial duplication and distribution
  5.           doc file for the SPHINX: AmigaDOS device
  6.  last revised: June 4th, 1991
  7.  
  8.  
  9.  SPHINX Alert chart:
  10. When some sort of internal error happens in SPHINX, instead of handling it
  11. quietly on its own, and leaving you with no information about why it couldn't
  12. do something, SPHINX shows you a requestor which, with the help of this chart,
  13. helps you identify why SPHINX couldn't do something.
  14. Case is important in differentiating the codes.
  15. format of entries:
  16. CODE: code again in full. explaination. what SPHINX does once you pressed `Ok'
  17.  
  18. BllF: Bell File. the bell file was found, but its contents are not usable.
  19.     uses DisplayBeep() instead.
  20.  
  21. CfgF: Configuration File. the config file cannot be used because its contents
  22.     are wrong. shutsdown.
  23.  
  24. IFFg: Input Font Flags. same as WFFg, but involves your input font.
  25. IFNF: Input Font Not Found. same sa WFNF, but involves your input font.
  26. IFWt: Input Font Width. same as WFWd, but involves your input font.
  27.  
  28. NMem: No Memory. SPHINX couldn't find some memory it needed. Either free up
  29.     some by shutting down other tasks, etc..., or don't use SPHINX. does
  30.     different things depending on when this occurs: if during startup,
  31.     then probably shutsdown, if during other time, probably continues to
  32.     run, but in a crippled manner (drops characters, etc...)
  33.  
  34. OAud: Open Audio.device. couldn't open audio device. shutsdown.
  35. OCfg: Open Configuration file. couldn't find configuration file. shutsdown.
  36. OCon: Open Console.device. couldn't open console.device. (needs it for RawKey
  37.     Convert()). shutsdown.
  38. ODFt: Open Diskfont.library. couldn't find your font in memory, and couldn't
  39.     open the diskfont.library to search for it on disk. looks at various
  40.     other fonts to find one it can use.
  41. ODos: Open Dos.library. couldn't open dos.library. try using WB1.2 or higher.
  42.     shutsdown.
  43. OGfx: Open Graphics.library. couldn't open graphics.library. try using WB1.2
  44.     or higher. shutsdown.
  45. OTmV: Open Timer.device's Vertical Blank unit. couldn't open it. shutsdown.
  46. OTmM: Open Timer.device's Micro Hertz unit. couldn't open it. shutsdown.
  47. O1Wd: Open First Window. the first window could not be opened either because
  48.     there is not enough memory, or because the window coordinates would
  49.     have put it outside the screen. shutsdown.
  50. OMWd: Reopen Main Window. couldn't uniconize because main window couldn't be
  51.     opened (probably due to a lack of memory). tries to go back to being
  52.     iconized.
  53. OIWd: (Re)Open Iconized Window. couldn't (re)iconize because the iconized
  54.     window couldn't be opened. SPHINX goes to sleep for 2 minutes, then
  55.     tries again (and again, and again...). try freeing up some memory.
  56.  
  57. SgBt: Signal Bit. couldn't get a signal bit (AllocSignal()). shutsdown.
  58. StDC: Start Dos Calling process. couldn't start process (CreateProc),
  59.     probably due to a lack of memory. shutsdown.
  60.  
  61. TpFg: Topaz Flags. one of the fonts couldn't be found, and every alternative
  62.     SPHINX tried (all the way to Topaz.font/8) were no good. Topaz is
  63.     no good because it is the wrong type. see IFFg. shutsdown.
  64. TpNF: Topaz Not Found. Topaz.font/8 could not be found. shutsdown.
  65. TpWt: Topaz Width. same as TpFg, but topaz's problem is that its width is
  66.     listed as zero (tf_XSize). shutsdown.
  67.  
  68. WdAg: Window Arguments. the string specifying the window to open cannot be
  69.     interpreted (SPHINX:x/y/w/h/title). shutsdown.
  70. WFFg: Write Font Flags. your write font is found, but cannot be used because
  71.     its is of the wrong type. see IFFg. continues to look for a font.
  72. WFNF: Write Font Not Found. your write font cannot be found. continues to look
  73.     for a font.
  74. WFWt: Write Font Width. your write font was found, but cannot be used because
  75.     its width is listed as zero (tf_XSize). continues looking for a font.
  76.  
  77. I have used a lookup chart instead of having SPHINX tell you in full
  78. sentences what went wrong for two reasons: this makes Sphinx-Handler smaller,
  79. and, since these errors are the sort that occur rarely, and most often
  80. require you to change something so that SPHINX can run, you are probably
  81. going to have the sphinx doc files out in front of you in the first place.
  82. In opposition to this, instead of using numbers, I have used four letter
  83. codes, so that you can still (sometimes) guess as to what the error
  84. represents.
  85.  
  86. NOTE: Sphinx has no way of telling you something went wrong when it tried to
  87. open intuition.library. It does this open at startup, and if it cannot find
  88. intuition, it shutsdown. If SPHINX is shutting down without giving a reason,
  89. this could be why. Use WB1.2 or higher.
  90.  
  91.  
  92.