Merge branch 'vendor/DIFFUTILS'
[dragonfly.git] / games / larn / larn.6
1 .\" Copyright (c) 1990 The Regents of the University of California.
2 .\" All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
11 .\"    documentation and/or other materials provided with the distribution.
12 .\" 3. Neither the name of the University nor the names of its contributors
13 .\"    may be used to endorse or promote products derived from this software
14 .\"    without specific prior written permission.
15 .\"
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 .\" SUCH DAMAGE.
27 .\"
28 .\"     @(#)larn.6      5.5 (Berkeley) 12/30/93
29 .\" $FreeBSD: src/games/larn/larn.6,v 1.6.2.3 2001/07/22 11:01:22 dd Exp $
30 .\" $DragonFly: src/games/larn/larn.6,v 1.4 2008/05/02 02:05:03 swildner Exp $
31 .\"
32 .Dd December 30, 1993
33 .Dt LARN 6
34 .Os
35 .Sh NAME
36 .Nm larn
37 .Nd exploring the caverns of Larn
38 .Sh SYNOPSIS
39 .Nm
40 .Op Fl r
41 .Op Fl H Ar number
42 .Op Fl n
43 .Op Fl h
44 .Op Fl o Ar optsfile
45 .Sh DESCRIPTION
46 .Nm Larn
47 is a fantasy games in which your child has contracted
48 a strange disease, and none of your home remedies
49 seem to have any effect.  You set out to find a remedy in a limited
50 amount of time, and to collect gold along the way of course!
51 .Pp
52 The options are:
53 .Bl -tag -width flag
54 .It Fl r
55 The
56 .Fl r
57 option restores a checkpointed game after it has died.
58 .It Fl H
59 The
60 .Fl H
61 option sets the hardness of the game.
62 .It Fl n
63 The
64 .Fl n
65 option suppresses the welcome message at start up, putting you directly
66 into the game.
67 .It Fl h
68 The
69 .Fl h
70 option prints the command line options.
71 .It Fl o
72 The
73 .Fl o
74 option specifies a different options file than
75 .Pa ~/.larnopts .
76 .El
77 .Sh COMMANDS
78 These are the movement commands:
79 .Bl -column "v print program version" "g give present pack weight"
80 .It h move to the left  H run left      . stay here
81 .It j move down J run down      Z teleport yourself
82 .It k move up   K run up        c cast a spell
83 .It l move to the right L run right     r read a scroll
84 .It y move northwest    Y run northwest q quaff a potion
85 .It u move northeast    U run northeast W wear armor
86 .It b move southwest    B run southwest T take off armor
87 .It n move southeast    N run southeast w wield a weapon
88 .It ^ identify a trap   g give present pack weight      P give tax status
89 .It d drop an item      i inventory your pockets        Q quit the game
90 .It v print program version     S save the game D list all items found
91 .It ? this help screen  A create diagnostic file        e eat something
92 .It     (wizards only)
93 .El
94 .Sh OPTIONS FILE
95 The file
96 .Pa ~/.larnopts
97 may be used to set a few options for
98 .Nm Larn .
99 A sequence of words terminated by whitespace is used to specify options.
100 .Pp
101 .Bl -tag -width "savefile: xsave-file-namex" -compact
102 .It Sy "        Word
103 .Sy "   Meaning
104 .Pp
105 .It bold-objects
106 Select bold display of objects.
107 .It inverse-objects
108 Select inverse video display of objects.
109 .It no-introduction
110 Do not display intro message.
111 .It enable-checkpointing
112 Turn on periodic checkpointing.
113 .It no-beep
114 Disable beeping of the terminal.
115 .It male
116 Choose your sex to be a man.
117 .It female
118 Choose your sex to be a woman.
119 .It name: \*qyour name\*q
120 Choose your playing name.
121 .It monster: \*qmonst name\*q
122 Choose a name for a monster.
123 .It savefile: \*qsave-file-name\*q
124 Define what the savegame filename will be.
125 .El
126 .Pp
127 Your name and monster names must be enclosed in double quotation marks and may
128 be up to 34 characters long.  Longer names are truncated.
129 Anything enclosed in quotation marks is considered one word, and must be
130 separated from other words by whitespace.
131 .Sh SPECIAL NOTES
132 When
133 .Sy dropping gold ,
134 if you type '*' as your amount, all your gold gets dropped.
135 In general, typing in '*' means all of what you are interested in.
136 This is true when visiting the bank, or when contributing at altars.
137 .Pp
138 You can get out of the store, trading post, school, or home by hitting
139 .Sy <esc> .
140 .Pp
141 When casting a spell, if you need a list of spells you can cast, type \fBD\fP
142 as the first letter of your spell.  The available list of spells will be shown,
143 after which you may enter the spell code.  This only works on the 1st letter
144 of the spell you are casting.
145 .Sh FILES
146 .Bl -tag -width "/var/games/larn/lscore12.0" -compact
147 .It Pa /var/games/larn/lscore12.0
148 Score file.
149 .It Pa /var/games/larn/llog12.0
150 Log file.
151 .It Pa ~/.larnopts
152 Options file.
153 .El
154 .Sh AUTHORS
155 .An Noah Morgan