            MSDOS specific help file for NetHack 3.1.3

Copyright (c) NetHack PC Development Team 1993
NetHack may be freely distributed.  See license for details.

The MSDOS port of NetHack supports some additional or enhanced commands
as well as some NetHack.cnf file options specific to configuration choices 
used during the building of PC NetHack.  Listed below are those commands
and NetHack.cnf file options.

Recognized MSDOS specific NetHack.cnf entries are outlined below.

Boolean Options:

        IBMgraphics             Use IBM extended characters for the dungeon
                                Default: [FALSE]

Boolean options if DGK was set at compile time:

        BIOS                    Allow the use of IBM ROM BIOS calls
                                Default: [FALSE]
        rawio                   Allow the use of raw I/O (may only be set
                                on startup)
                                Default: [FALSE]

Color Options:

OPTIONS=!color

		Players will need this if they have a real, true, (old)
		monochrome adapter, and they are seeing underlined,
		and flashing, and reverse-video characters on the
		screen. Or they find that some things are missing from
		the display.  This means that the auto-detection
		for monochromes has failed.  The color support
		stuff is active in video.c, but may be (will have
		to be) overridden by adding an OPTIONS=nocolor to
		NetHack.cnf.

VIDEOSHADES
		(NetHack.cnf only)
		Players may wish to add this option because one of their
		shades of gray is difficult to read on their video
		display hardware.  Allows a level of intensity to be
		assigned to the 3 possible shades of gray in NetHack,
		those being BLACK, GRAY, WHITE.  To each of those
		shades, the player may assign a DARK, NORMAL, or LIGHT value.
		Here is the default if not specified:

		ie. VIDEOSHADES=dark normal light

		Anytime the same intensity value (DARK NORMAL LIGHT) is used
		for more than one shade of gray, it will not be possible
		to visually distinguish those two shades from each
		other.

		ie. VIDEOSHADES=normal normal light

		This, while eliminating the dark shade normally used for
		displaying black items, means that the player won't be
		able to distinguish black items and creatures from gray
		items and creatures visually.

		Note also that the controversial gray schema used in
		pl 3.1.2 as the default, corresponded to:

		VIDEOSHADES=normal dark normal

		This is NOT the default in pl 3.1.3, so many people will
		probably not even need to use this option, and will find
		the default just fine. The maps are built using gray,
		and in pl 3.1.3, that is mapped to normal by default. In
		3.1.2, it was mapped to dark (as above).

VIDEOCOLORS
		(NetHack.cnf only)
		This option is only provided because some people on
		r.g.h mentioned how they liked to modify the color
		values from the default ANSI.SYS behaviour, and were
		"upset" to find out that they could no longer do so
		under 3.1.2.  The color map is as accurate as possible
		on standard PC video hardware as it stands, and any
		deviation from the default, will mean that people
		are mapping blue to green for example.  The option is
		available to provide as much flexibility as possible,
		but it is not encouraged to be used.

		One possible use might be for the dark blue in
		fountains.  On video hardware that has trouble
		displaying blacks, there may also be problems displaying
		the darker blue used in fountains.  If that is the case
		then the default map:

		VIDEOCOLORS = 4 2 6 1 5 3 15 12 10 14 9 13 11

		could be changed to the following to map blue to br.
		blue:

		VIDEOCOLORS = 4 2 6 9 5 3 15 12 10 14 9 13 11

		The order for the options:

			red, green, brown, blue, magenta, cyan
			br.white, br.red, br.green, yellow, br.blue,
			br.magenta, br.cyan

		The PC hardware uses the following values:

		red	= 04
		green	= 02
		brown	= 06
		blue	= 01
		magenta	= 05
		cyan	= 03
		B.white	= 15
		B.red	= 12
		B.green	= 10
		yellow	= 14
		B.blue	= 09
		B.mag.	= 13
		B.cyan	= 11



The following options are NOT currently recognized under the MSDOS
port of PC NetHack:

        LEVELS=                 Where to store/create per level
                                data files.
        SAVE=                   Where to save games.
        BONES=                  Where to store bones files.




MSDOS Additional/Enhanced Commands:

While playing NetHack under MSDOS you can press the ALT key in combination 
with another key to execute an extended command as an alternative method
to pressing the # key combination:

Alt-a    adjust    - adjust inventory letters.
Alt-c    chat      - talk to someone.
Alt-d    dip       - dip an object into something.
Alt-f    force     - force a lock.
Alt-i    invoke    - invoke an object's powers.
Alt-j    jump      - jump to a location.
Alt-l    loot      - loot a box on the floor.
Alt-m    monster   - use a monster's special ability.
Alt-n    name      - name an item or type of object.
Alt-o    offer     - offer a sacrifice to the gods.
Alt-p    pray      - pray to the gods for help.
Alt-r    rub       - rub a lamp.
Alt-s    sit       - sit down.
Alt-t    turn      - turn undead.
Alt-u    untrap    - untrap something.
Alt-v    version   - list compile time options for this version of NetHack.
Alt-w    wipe      - wipe off your face.
Alt-?    ?         - get this list of extended commands.


