            Macintosh-specific help file for NetHack 3.2

The following are options, features, or concerns specific to the
Macintosh port of NetHack 3.2.  Bug reports, suggestions, comments,
and so on, should be addressed to:

	To: nethack-bugs@linc.cis.upenn.edu
	Subject: Mac NetHack 3.2

Please include your machine-type, system software version and other
relevant information (i.e. system extensions, monitor, accelerators
and so on).


=== Configuration of a playground
    NetHack 3.2 is packaged in a Dungeon Folder which includes:
        NetHack - the application file itself.
        NetHack Defaults - text file for default option settings.
        Miscellaneous text files - Record and logfile.  logfile
            will be created if it doesn't exist.
        Various special level files (with a ".lev" suffix).
        Various help and other utility NetHack documents.
        Recover - the application to restore save files from crashed games.

    During play another file type appears:
        Player level files (labelled "iName.n", i is a constant number,
            Name is the player name and n is the dungeon level).

    Two other types of files will appear in the Dungeon Folder
    as a result of playing NetHack:
        Bones files (of previously deceased players).
        Saved games (labelled "save/iName", i is a number, same as above,
            and Name is the player name).

    The following files or file types may be thrown away:
        logfile - if it becomes too large.  A new one will be generated.
        Player level files _not_ belonging to a game in progress.
            Alternatively, these files may be processed by Recover,
            which may be able to restore a save file from the level files.
            Old bones files and saved games.

=== Resuming a saved game
    Double-click (or open) the desired saved game file or open NetHack
        and answer the "Who are you?" dialog with the player name of
        the saved game in the Dungeon Folder.

=== Windows
    The Dungeon Map and Message windows are the essential windows used
        during window-mode play.  During tty-mode play there is only one
        window which displays the map, messages, lists and other info.
        For window-mode play, lists (e.g. the list of objects that may
        be wielded) and special info windows appear as needed.  Windows
        may be closed in the normal ways (i.e. clicking their close box,
        choosing 'Close' from the File menu or typing the command
        equivalent for 'Close', cmd-W) and the list windows may also be
        dismissed by hitting the space bar (or Return or Enter Keys).
        Hitting the ESCape key will dismiss special windows without
        scrolling to the end.

    The command "Reposition" on the File menu may be used to restore the
        the startup sizes and locations of the various windows.  The
        window positions are saved in a file labelled "NetHack Windows"
        in the appropriate preferences folder.

=== Default options
    The following options are specific to the Macintosh port:
    MACgraphics  - use enhanced dungeon map symbols [TRUE]
    large_font   - use 12 point font instead of 9 point font [FALSE]
    popup_dialog - use real dialogs for question prompts [FALSE]
    page_wait    - display  --MORE--  after messages [TRUE]

    large_font is currently a pre-game option and has no effect
        after the Dungeon Map window is created.

    Default options may be set by editing the NetHack Defaults text
        file (possibly using TeachText or your favorite editor).
        Unix(tm)-style notation is used, as in:
    OPTIONS=name:Arnold,time,!tombstone

    It should also be mentioned here that there are two graphic
    interface modes available: 'mac' and 'tty'.  Choosing between
    these interfaces is accomplished by the option:
    window:mac - the default multi-window Macintosh(tm) interface.
    window:tty - traditional Unix(tm)-style TTY window interface.

    See option help (?f or ?g) for more details.

=== Movement by mouse
    The shape (direction) of the cursor over the Dungeon Map window,
    typically, indicates the direction that you desire to move in when
    the mouse is clicked.  Modifier keys affect mouse-movement in the
    same way that they affect keyboard movement.  Clicking on yourself
    means rest one turn and Shift-clicking on yourself means "open door"
    in the subsequently indicated direction.

=== Sounds
    Real sounds (resources) have been added for various instruments.
    The option "silent" [FALSE] controls whether or not a sound will
    be heard when an instrument is applied.

=== Explore and Debug Modes
    As of version 3.1.2, you can enter Discover (aka Explore) mode or
    Wizard (aka Debug) mode by choosing the appropriate entries on the
    'Mode' popup-menu section of the "Who are you?" startup dialog.
    This same dialog allows you to specify your sex, role and name,
    of course.

    Starting in Discover mode is essentially the same as playing in
    Regular mode except that if you are killed then you are given an
    opportunity to override your death.  Because of this advantage,
    your Discover mode scores are not entered on the scoreboard record.
    You also get a wand of wishing in your starting inventory and can
    see your intrinsic abilities using the command ctl-X (also available
    on the 'Explore' submenu on the File menu).

    Starting in Wizard mode is only intended for developers and others
    interested in characterizing bugs.  Using this mode for other
    purposes will have confusing results and eliminate your enjoyment
    of the game!

=== Menus
    As of version 3.1.2, the menus have been reworked to provide access
    to all the NetHack commands and a special 'Kbd' menu was added to
    facilitate play using only the mouse.  In some cases, a command may
    appear on more than one menu.  In general, the commands have been
    grouped to appear on an appropriate menu:
    File  - commands related to windows, start mode and play control.
    Help  - info commands generally not related to a specific game (i.e.
            (key descriptions, version info, internal option editor).
    Info  - commands that are generally game-specific (i.e. inventory
            related, describe features seen on the map or name things).
    Equip - commands related to things you might wield or wear.
    Act   - commands for actions that you might do alone (i.e. wait,
            jump) or do with another dungeon denizen (i.e. pay, chat).
    Magic - commands for things that you might do with items (drop,
            eat, read) or spell-related.
    Bits  - commands for things you might do to dungeon pieces (i.e.
            open door, loot chest, engrave on the floor, climb stairs).

    The key related to a command generally appears to the left of the
    menu entry for that command (i.e. w for wield and W for wear). A
    leftmost # denotes an extended command (without a related key) and
    a left cloverleaf or command symbol denotes a command that requires
    either a control or command key modifier (i.e. holding down the
    control or command key while hitting the related key).

===
The members of the Macintosh NetHack port team hope you enjoy this game.
