File:  [Atari MiNT] / MiNT / readme.1st
Revision (vendor branch): download - view: text, annotated - select for diffs
Tue Apr 24 17:55:35 2018 UTC (3 years, 7 months ago) by root
Branches: mint, MAIN
CVS tags: mint095, HEAD
MiNT 0.95 pl13

MiNT is Not TOS: A Multitasking Operating System Extension for the Atari ST

Copyright 1990,1991,1992 Eric R. Smith. All rights reserved. See the file

"copying" for conditions of redistribution.




OK, some of you don't want to read docs (even when there's a whole

directory full of them). So here's the brief version of how to make

MiNT run. For a list of new features in this version of MiNT, see the

file "".

(1) put mint.prg in the AUTO folder of your boot disk. Make sure it's the

last thing in the folder -- anything after MiNT won't run.

(2) copy toswin.acc, toswin.rsc, and toswin.cnf to the root directory of

the boot disk. copy emacs.mnu to wherever you keep your EMACS editor (if

you have one).

(3) reboot

Simple, huh? Now, there are some things you can do to customize your


(4) You can customize the way MiNT boots (for example, set what program

should be run at boot time, or automatically set up symbolic links) by

editing the file "mint.cnf" with an ordinary ASCII text editor.

(5) If you want MiNT to run something other than GEM, you can

tell MiNT to do this by providing a line like:


in mint.cnf; this tells MiNT to run "c:\mintshel.ttp" as its first

process rather than GEM. Any non-GEM program should work as an

INIT program. (mintshel.ttp is available with the MiNT utilities

in the file "mntutl95.zoo").

(6) If you have TOS 1.2 or higher, you can install a new drive (drive

U:) on the desktop. This has all other drives as subdirectories,

plus some special subdirectories:

	U:\DEV shows all BIOS devices available under MiNT

	U:\PROC shows all processes that are active; deleting

	    a process will (usually) kill it.

(7) While MiNT is running, there are some special keys available:

CTRL-ALT-C: kills all processes that are reading from/writing to the

	screen. Useful for getting out of hung programs.

CTRL-ALT-\ or CTRL-ALT-UNDO: similar to CTRL-ALT-C, but somewhat more

	fatal (fewer programs choose to catch the signal these keys


CTRL-ALT-DEL: resets the computer, as in TOS 1.4 and higher

CTRL-ALT-F1: raises the "debug level" of MiNT. Pressing this key once

	causes a message to be printed whenever an error occurs;

	pressing it twice causes a detailed trace of system calls.

	This key can be *very*, *very* useful in tracking down problems

	with any program!

CTRL-ALT-F2: lowers the debugging level -- press it as many times as

	you pressed CTRL-ALT-F1 to turn off all debugging

CTRL-ALT-F3: controls where debugging output goes; press it once and

	output goes to the printer, press it again and it is sent

	to the RS232 port, press it again and it goes to MIDI.

CTRL-ALT-F4: resets debugging output to the console

CTRL-ALT-F5: shows all memory being used in the system

CTRL-ALT-F6: shows all active processes in the system

CTRL-Z: suspends processes reading from/writing to the screen if the

	keyboard is not in "raw" mode. Use this key only if you're

	running a shell that, like you, understands job control.

CTRL-ALT-Z: suspends processes reading from/writing to the screen

	no matter what. The warning with CTRL-ALT-Z applies doubly here!

(8) It has been reported that MiNT works much better under TOS 1.0

if FATSPEED.PRG is in the AUTO folder before it.

Other Docs:

"readme" contains a general introduction to MiNT

"" summarizes the new features of this version of MiNT

"copying" says under what conditions you can make copies of MiNT

"toswin.doc" contains information about the background program accessory

"mint.doc" contains more detailed information about MiNT, including

   information of interest to programmers

"features" is a list of areas where MiNT is deliberately incompatible with


"bugs" is a list of known bugs in MiNT -- read this one! Also, remember that

   there are lots of unknown bugs in MiNT as well.

"problems" is an (incomplete) list of programs that are known to have

   problems working under MiNT

"faq" answers some frequently asked questions about MiNT.