Debian Codegraph @

upstream/debian-unstable/man6/hack.6

raw
1 .\" Automatically generated from hack/hack.6.in. Do not edit.
2 .\" $NetBSD: hack.6,v 1.14 2004/06/01 10:10:06 wiz Exp $ -*- nroff -*-
3 .\"
4 .\" Copyright (c) 1985, Stichting Centrum voor Wiskunde en Informatica,
5 .\" Amsterdam
6 .\" All rights reserved.
7 .\"
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions are
10 .\" met:
11 .\"
12 .\" - Redistributions of source code must retain the above copyright notice,
13 .\" this list of conditions and the following disclaimer.
14 .\"
15 .\" - Redistributions in binary form must reproduce the above copyright
16 .\" notice, this list of conditions and the following disclaimer in the
17 .\" documentation and/or other materials provided with the distribution.
18 .\"
19 .\" - Neither the name of the Stichting Centrum voor Wiskunde en
20 .\" Informatica, nor the names of its contributors may be used to endorse or
21 .\" promote products derived from this software without specific prior
22 .\" written permission.
23 .\"
24 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
25 .\" IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
26 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
27 .\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
28 .\" OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
29 .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
30 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
31 .\" PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
32 .\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
33 .\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
34 .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 .\"
36 .\"
37 .\" Copyright (c) 1982 Jay Fenlason <[email protected]>
38 .\" All rights reserved.
39 .\"
40 .\" Redistribution and use in source and binary forms, with or without
41 .\" modification, are permitted provided that the following conditions
42 .\" are met:
43 .\" 1. Redistributions of source code must retain the above copyright
44 .\" notice, this list of conditions and the following disclaimer.
45 .\" 2. Redistributions in binary form must reproduce the above copyright
46 .\" notice, this list of conditions and the following disclaimer in the
47 .\" documentation and/or other materials provided with the distribution.
48 .\" 3. The name of the author may not be used to endorse or promote products
49 .\" derived from this software without specific prior written permission.
50 .\"
51 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
52 .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
53 .\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
54 .\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
55 .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
56 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
57 .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
58 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
59 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
60 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
61 .\"
62 .Dd March 31, 1985
63 .Dt HACK 6
64 .Os
65 .Sh NAME
66 .Nm hack
67 .Nd exploring The Dungeons of Doom
68 .Sh SYNOPSIS
69 .Nm
70 .Op Fl d Ar directory
71 .Op Fl n
72 .Op Fl u Ar playername
73 .Nm
74 .Op Fl d Ar directory
75 .Op Fl s
76 .Op Fl X
77 .Op Ar playername ...
78 .Sh DESCRIPTION
79 .Nm
80 is a display oriented dungeons \*[Am] dragons-like game.
81 Both display and command structure resemble rogue.
82 (For a game with the same structure but entirely different display -
83 a real cave instead of dull rectangles - try Quest.)
84 .Pp
85 To get started you really only need to know two commands.
86 The command
87 .Ic \&?
88 will give you a list of the available commands and the command
89 .Ic /
90 will identify the things you see on the screen.
91 .Pp
92 To win the game (as opposed to merely playing to beat other people's high
93 scores) you must locate the Amulet of Yendor which is somewhere below
94 the 20th level of the dungeon and get it out.
95 Nobody has achieved this yet and if somebody does, he will probably go
96 down in history as a hero among heroes.
97 .Pp
98 When the game ends, either by your death, when you quit, or if you escape
99 from the caves,
100 .Nm
101 will give you (a fragment of) the list of top scorers.
102 The scoring is based on many aspects of your behavior but a rough estimate
103 is obtained by taking the amount of gold you've found in the cave plus four
104 times your (real) experience.
105 Precious stones may be worth a lot of gold when brought to the exit.
106 There is a 10% penalty for getting yourself killed.
107 .Pp
108 The administration of the game is kept in the directory specified with the
109 .Fl d
110 option, or, if no such option is given, in the directory specified by
111 the environment variable
112 .Ev HACKDIR ,
113 or, if no such variable exists, in the current directory.
114 This same directory contains several auxiliary files such as lockfiles and
115 the list of topscorers and a subdirectory
116 .Pa save
117 where games are saved.
118 The game administrator may however choose to install hack with a fixed
119 playing ground, usually
120 .Pa /var/games/bsdgames/hack .
121 .Pp
122 The
123 .Fl n
124 option suppresses printing of the news.
125 .Pp
126 The
127 .Fl u
128 .Ar playername
129 option supplies the answer to the question "Who are you?".
130 When
131 .Ar playername
132 has as suffix one of
133 .Em -T ,
134 .Em -S ,
135 .Em -K ,
136 .Em -F ,
137 .Em -C ,
138 or
139 .Em -W ,
140 then this supplies the answer to the question "What kind of character ... ?".
141 .Pp
142 The
143 .Fl s
144 option will print out the list of your scores.
145 It may be followed by arguments
146 .Fl X
147 where X is one of the letters C, F, K, S, T, W to print the scores of
148 Cavemen, Fighters, Knights, Speleologists, Tourists or Wizards.
149 It may also be followed by one or more player names to print the scores of the
150 players mentioned.
151 .Sh AUTHORS
152 Jay Fenlason (+ Kenny Woodland, Mike Thome and Jon Payne) wrote the
153 original hack, very much like rogue (but full of bugs).
154 .br
155 Andries Brouwer continuously deformed their sources into the current
156 version - in fact an entirely different game.
157 .Sh FILES
158 .Bl -tag -width 24n -compact
159 .It Pa hack
160 The hack program.
161 .It Pa data, rumors
162 Data files used by hack.
163 .It Pa help, hh
164 Help data files.
165 .It Pa record
166 The list of topscorers.
167 .It Pa save
168 A subdirectory containing the saved games.
169 .It Pa bones_dd
170 Descriptions of the ghost and belongings of a deceased adventurer.
171 .It Pa xlock.dd
172 Description of a dungeon level.
173 .It Pa safelock
174 Lock file for xlock.
175 .It Pa record_lock
176 Lock file for record.
177 .El
178 .Sh ENVIRONMENT
179 .Bl -tag -width 24n -compact
180 .It Ev USER No or Ev LOGNAME
181 Your login name.
182 .It Ev HOME
183 Your home directory.
184 .It Ev SHELL
185 Your shell.
186 .It Ev TERM
187 The type of your terminal.
188 .It Ev HACKPAGER, PAGER
189 Pager used instead of default pager.
190 .It Ev MAIL
191 Mailbox file.
192 .It Ev MAILREADER
193 Reader used instead of default (probably
194 .Pa /usr/bin/mail ) .
195 .It Ev HACKDIR
196 Playground.
197 .It Ev HACKOPTIONS
198 String predefining several hack options (see help file).
199 .El
200 .Pp
201 Several other environment variables are used in debugging (wizard) mode,
202 like
203 .Ev GENOCIDED ,
204 .Ev INVENT ,
205 .Ev MAGIC
206 and
207 .Ev SHOPTYPE .
208 .Sh BUGS
209 Probably infinite.
210 Mail complaints to mcvax!aeb .