home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / mint / mint095b / readme.1st < prev    next >
Encoding:
Text File  |  1993-08-03  |  4.3 KB  |  92 lines
  1. MiNT is Not TOS: A Multitasking Operating System Extension for the Atari ST
  2.  
  3. Copyright 1990,1991,1992 Eric R. Smith. All rights reserved. See the file
  4. "copying" for conditions of redistribution.
  5.  
  6. MiNT COMES WITH ABSOLUTELY NO WARRANTY, NOR WILL I BE LIABLE FOR ANY
  7. DAMAGES INCURRED FROM THE USE OF IT. USE ENTIRELY AT YOUR OWN RISK!!!
  8. ---------------------------------------------------------------------
  9. OK, some of you don't want to read docs (even when there's a whole
  10. directory full of them). So here's the brief version of how to make
  11. MiNT run. For a list of new features in this version of MiNT, see the
  12. file "readme.new".
  13.  
  14. (1) put mint.prg in the AUTO folder of your boot disk. Make sure it's the
  15. last thing in the folder -- anything after MiNT won't run.
  16.  
  17. (2) copy toswin.acc, toswin.rsc, and toswin.cnf to the root directory of
  18. the boot disk. copy emacs.mnu to wherever you keep your EMACS editor (if
  19. you have one). copy top.mnu and mintshel.mnu to wherever you keep your
  20. MiNT utility programs (if you have any).
  21.  
  22. (3) reboot
  23.  
  24. Simple, huh? Now, there are some things you can do to customize your
  25. system:
  26.  
  27. (4) You can customize the way MiNT boots (for example, set what program
  28. should be run at boot time, or automatically set up symbolic links) by
  29. editing the file "mint.cnf" with an ordinary ASCII text editor.
  30.  
  31. (5) If you want MiNT to run something other than GEM, you can
  32. tell MiNT to do this by providing a line like:
  33.     INIT=c:\mintshel.ttp
  34. in mint.cnf; this tells MiNT to run "c:\mintshel.ttp" as its first
  35. process rather than GEM. Any non-GEM program should work as an
  36. INIT program. (mintshel.ttp is available with the MiNT utilities
  37. in the file "mntutl95.zoo").
  38.  
  39. (6) If you have TOS 1.2 or higher, you can install a new drive (drive
  40. U:) on the desktop. This has all other drives as subdirectories,
  41. plus some special subdirectories:
  42.     U:\DEV shows all BIOS devices available under MiNT
  43.     U:\PROC shows all processes that are active; deleting
  44.         a process will (usually) kill it.
  45.  
  46. (7) While MiNT is running, there are some special keys available:
  47.  
  48. CTRL-ALT-C: kills all processes that are reading from/writing to the
  49.     screen. Useful for getting out of hung programs.
  50. CTRL-ALT-\ or CTRL-ALT-UNDO: similar to CTRL-ALT-C, but somewhat more
  51.     fatal (fewer programs choose to catch the signal these keys
  52.     raise)
  53. CTRL-ALT-DEL: resets the computer, as in TOS 1.4 and higher
  54. CTRL-ALT-F1: raises the "debug level" of MiNT. Pressing this key once
  55.     causes a message to be printed whenever an error occurs;
  56.     pressing it twice causes a detailed trace of system calls.
  57.     This key can be *very*, *very* useful in tracking down problems
  58.     with any program!
  59. CTRL-ALT-F2: lowers the debugging level -- press it as many times as
  60.     you pressed CTRL-ALT-F1 to turn off all debugging
  61. CTRL-ALT-F3: controls where debugging output goes; press it once and
  62.     output goes to the printer, press it again and it is sent
  63.     to the RS232 port, press it again and it goes to MIDI.
  64. CTRL-ALT-F4: resets debugging output to the console
  65. CTRL-ALT-F5: shows all memory being used in the system
  66. CTRL-ALT-F6: shows all active processes in the system
  67.  
  68. CTRL-Z: suspends processes reading from/writing to the screen if the
  69.     keyboard is not in "raw" mode. Use this key only if you're
  70.     running a shell that, like you, understands job control.
  71. CTRL-ALT-Z: suspends processes reading from/writing to the screen
  72.     no matter what. The warning with CTRL-ALT-Z applies doubly here!
  73.  
  74. (8) It has been reported that MiNT works much better under TOS 1.0
  75. if FATSPEED.PRG is in the AUTO folder before it.
  76.  
  77. Other Docs:
  78.  
  79. "readme" contains a general introduction to MiNT
  80. "readme.new" summarizes the new features of this version of MiNT
  81. "copying" says under what conditions you can make copies of MiNT
  82. "toswin.doc" contains information about the background program accessory
  83. "mint.doc" contains more detailed information about MiNT, including
  84.    information of interest to programmers
  85. "features" is a list of areas where MiNT is deliberately incompatible with
  86.    TOS
  87. "bugs" is a list of known bugs in MiNT -- read this one! Also, remember that
  88.    there are lots of unknown bugs in MiNT as well.
  89. "problems" is an (incomplete) list of programs that are known to have
  90.    problems working under MiNT
  91. "faq" answers some frequently asked questions about MiNT.
  92.