view rogue3/rogue.6.in @ 310:827441d05b3e

Advanced Rogue family: fix some potential buffer overflows. Some code for determining the score file location assumed that PATH_MAX would be less than 1024, which cannot be guaranteed. Advanced Rogue 5 and 7, and XRogue, have had the buffers for the file name enlarged. UltraRogue never called the functions, so the code has been deleted instead.
author John "Elwin" Edwards
date Mon, 03 May 2021 19:05:37 -0400
parents c191a735f811
children
line wrap: on
line source

.TH ROGUE 6
.UC
.SH NAME
rogue \- Exploring The Dungeons of Doom
.SH SYNOPSIS
.B @PROGRAM@
[ -s ]
[
.I save_file
]
[ -n
.I playername
]
.SH DESCRIPTION
.PP
.I Rogue
is a computer fantasy game with a new twist.  It is crt oriented and the
object of the game is to survive the attacks of various monsters and get
a lot of gold, rather than the puzzle solving orientation of most computer
fantasy games.
.PP
To get started you really only need to know two commands.  The command
.B ?
will give you a list of the available commands and the command
.B /
will identify the things you see on the screen.
.PP
To win the game (as opposed to merely playing to beat other people's high
scores) you must locate the Amulet of Yendor which is somewhere below
the 20th level of the dungeon and get it out.  Nobody has achieved this
yet and if somebody does, they will probably go down in history as a hero
among heros.
.PP
When the game ends, either by your death, when you quit, or if you (by
some miracle) manage to win,
.I rogue
will give you a list of the top-ten scorers.  The scoring is based entirely
upon how much gold you get.  There is a 10% penalty for getting yourself
killed.
.PP
For more detailed directions, read the document
.I "A Guide to the Dungeons of Doom."
.SH OPTIONS
.PP
If a
.I save_file
argument is given,
.I rogue
will attempt to load a previously saved game from that file.
.PP
With the
.B -n
option,
.I rogue
will load a game with the name
.I playername
from a location defined at compile time.  If no such game exists, it will 
start one.
.PP
The
.B -s
option prints the top-ten scores list and exits.

.SH FILES
.ta 2i
@SCOREFILE@   Score file
.br
~/rogue3.save                           Default save file
.br
@SAVEDIR@   System savefiles
.DT
.SH SEE ALSO
Michael C. Toy,
.I "A Guide to the Dungeons of Doom"
.SH BUGS
.PP
Probably infinite.  Currently known bugs are: Sometimes you are still hungry
even after you eat food and sometimes you get a monster on the screen in
reverse video which may or may not cause a core dump.
.SH COPYRIGHT
Rogue: Exploring the Dungeons of Doom
.br
Copyright (C) 1980, 1981 Michael Toy, Ken Arnold and Glenn Wichman
.br
All rights reserved.
.br
License: 3-clause BSD, see LICENSE.txt for details.