From 2d4731dab90c0ae2a785dd7141fdb2f18d1d8b44 Mon Sep 17 00:00:00 2001 From: jwalz Date: Sat, 5 Jan 2002 21:05:55 +0000 Subject: [PATCH] *** empty log message *** --- sys/mac/MacHelp | 167 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 sys/mac/MacHelp diff --git a/sys/mac/MacHelp b/sys/mac/MacHelp new file mode 100644 index 000000000..e8b1aa3b1 --- /dev/null +++ b/sys/mac/MacHelp @@ -0,0 +1,167 @@ + Macintosh-specific help file for NetHack 3.3 + +The following are options, features, or concerns specific to the +Macintosh port of NetHack 3.3. Bug reports, suggestions, comments, +and so on, should be addressed to: + + To: nethack-bugs@nethack.org + Subject: Mac NetHack 3.3 + +or you can use our on-line bug reporting form at + + http://www.nethack.org + +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.3 is packaged in a Dungeon Folder which includes: + NetHack - the application file itself. + NetHack Defaults - text file for default option settings. + license - licensing terms for nethack. + Guidebook - description of the game in long format. + Recover - the application to restore save files from crashed games. + Previous versions had a large number of data files in the Dungeon + Folder. These are now packaged as resources inside the application + file and will no longer appear in the Dungeon Folder. + + 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: + background: - black or white + 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] + use_stone:# - use a background pattern for the dungeon. + + large_font is currently a pre-game option and has no effect + after the Dungeon Map window is created. + + use_stone is also a pre-game option. The number parameter + specifies which pattern to use. If the number is 0 or + greater than the number of available patterns, it has no + effect. + + Default options may be set by editing the NetHack Defaults text + file (using SimpleText or your favorite editor). The following + notation is used: + + 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 Explore (aka Discover) mode or + Debug (aka Wizard) 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 role, race, gender, + alignment, and name, of course. + + Starting in Explore 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 Explore 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 Debug 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.