From c0bdfd7fc7c9e8878e4e6d30b81ee7762ca2e2f8 Mon Sep 17 00:00:00 2001 From: dploog Date: Sun, 6 Jul 2008 00:37:36 +0000 Subject: Added the screen files necessary for quickstart.tex, and moved the whole bunch into source/utils/docs/ git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@6417 c06c8d41-db1a-0410-9941-cceddc491573 --- crawl-ref/source/util/contact.tex | 146 ------------------ crawl-ref/source/util/docs/contact.tex | 146 ++++++++++++++++++ crawl-ref/source/util/docs/key_changes.txt | 111 ++++++++++++++ crawl-ref/source/util/docs/quickstart.tex | 236 +++++++++++++++++++++++++++++ crawl-ref/source/util/docs/screen.eps | 130 ++++++++++++++++ crawl-ref/source/util/docs/screen.fig | 21 +++ crawl-ref/source/util/docs/screen.pdf | Bin 0 -> 1672 bytes crawl-ref/source/util/key_changes.tex | 111 -------------- crawl-ref/source/util/quickstart.tex | 236 ----------------------------- 9 files changed, 644 insertions(+), 493 deletions(-) delete mode 100644 crawl-ref/source/util/contact.tex create mode 100644 crawl-ref/source/util/docs/contact.tex create mode 100644 crawl-ref/source/util/docs/key_changes.txt create mode 100644 crawl-ref/source/util/docs/quickstart.tex create mode 100644 crawl-ref/source/util/docs/screen.eps create mode 100644 crawl-ref/source/util/docs/screen.fig create mode 100644 crawl-ref/source/util/docs/screen.pdf delete mode 100644 crawl-ref/source/util/key_changes.tex delete mode 100644 crawl-ref/source/util/quickstart.tex diff --git a/crawl-ref/source/util/contact.tex b/crawl-ref/source/util/contact.tex deleted file mode 100644 index 9b158810c4..0000000000 --- a/crawl-ref/source/util/contact.tex +++ /dev/null @@ -1,146 +0,0 @@ -\documentclass[a4paper,10pt]{article} - -\usepackage{palatino} -\usepackage{mathpazo} % optional [sc] fuer real small caps -\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} - -\usepackage{graphicx} - -\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores -\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined - -\newcommand{\crawl}{\textsc{Crawl}} -\newcommand{\dungeon}{\textsc{Dungeon}} - -\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} -\newcommand{\para}{\vspace{1.5ex}} -\setlength{\parindent}{0em} - -\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} - -\newcounter{abccounter} -\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} - {\usecounter{abccounter} - \setlength{\topsep}{0ex} - \setlength{\partopsep}{0ex} - \setlength{\listparindent}{0ex} - \setlength{\itemsep}{0ex} - \setlength{\parsep}{0ex} - \setlength{\leftmargin}{2em} - \setlength{\labelwidth}{2em} - \setlength{\parskip}{0ex} - } - }{\end{list}} - -\pagestyle{empty} - -\begin{document} - - -\begin{center}\textbf{\LARGE -\dungeon\ \crawl: Files and Contact -}\end{center} - -This is the reference sheet for the roguelike game \dungeon\ \crawl, -specifically for the current version of the \textsc{Stone Soup} branch. -\crawl\ is a game of dungeon exploration, fighting and magic that is -renowned for its intricate skills and religion systems. Success requires -tactics, strategy, and perseverance. Though \crawl's reputation is -close to devilish, victories were reported\dots - -\para - -This page explains the various important files. The next page lists a -number of important changes introduced in version 0.4. The last two -pages give a very brief introduction to the game, which should be -enough to get you started. If you are completely new to this type of -game and still want to plunge right in, start up a new game and select -a tutorial (press \key{T} when asked for a species). - -\para\para - -\sex{The most important files} - -\para - -\begin{minipage}[t]{7cm} -The file \key{crawl.exe} in \crawl's main folder starts the game. -\\ \\ -The \sex{settings/} directory contains \key{init.txt}, the options file for -\crawl\ (on linux systems there may also be a \key{.crawlrc} in your home -directory). Since the defaults are well suited for playing, you can ignore -these at first. -\\ -This folder also contains \key{macro.txt}, a list of redefined key -bindings and macros. These make playing \crawl\ even more convenient. -You will probably not need to redefine key mappings until after you have -spent some time playing the game. -\end{minipage} -% -\spacecolumn -% -\begin{minipage}[t]{7cm} -The following files in the \sex{docs/} directory may be helpful: -\\ -\key{crawl\_manual.txt} is the full manual. It explains all races, classes, -item types etc. If you do not delight in manuals, you can put off the -reading this file until later. You can browse the manual while playing -(press \key{?}). -\\ -\key{options\_guide.txt} describes all the options in minute detail. While -tweaking these can improve your \crawl\ experience, you will probably prefer -to skip this at first. -\\ -\key{crawl\_macros.txt} explains macros and key bindings. You should probably -ignore this at first, too. - % (Unless you experience serious problems with some keys, in which case should - % look at the keymaps section.) -\end{minipage} - -\para\para - -\sex{Contact} - -\para - -If you have questions concerning the game, or think you have found a bug, -there are several places to contact the developers. First, there is the -newsgroup \key{rec.games.roguelike.misc}. Since other games are -discussed there as well, it is polite to flag your post with \key{-crawl-}. -If you are not familiar with Usenet netiquette, you might want to check -that first, too. -Also try to maintain netiquette to the benefit of your addresses. -\\ -Next, you are encouraged to file bug reports and feature requests on the -\crawl\ homepage at \key{http://crawl-ref.sourceforge.net}. From there, you -can also download the most recent version (both binaries or source, for -Unix, Windows, OS X, and DOS). -\\ -Finally, you can use the mailing list -\key{crawl-ref-discuss@lists.sourceforge.net} -to discuss specific details of the game's design and implementation. - -\para \para - -\sex{Internet play} - -\para - -You can play \crawl\ online, both competing with other players and watching -them. Check the homepage \key{crawl.akrasiac.org} for details, including -information about additional servers. You just need a \texttt{ssh} or -\texttt{telnet} console; on Windows, the \texttt{PuTTY} program works very -well. Read \key{ssh\_guide.txt} in the \key{docs} folder for a step by step -guide on how to set this up. - -\para \para - -\sex{Tiles} - -\para - -\crawl\ features an alternative to the classical ASCII display; Tile-based -Crawl is often easier accessible by new players. Tiles are available for -Linux, Windows and OS X. -Unfortunately, it is not yet possible to combine tiles and internet play. -\end{document} diff --git a/crawl-ref/source/util/docs/contact.tex b/crawl-ref/source/util/docs/contact.tex new file mode 100644 index 0000000000..9b158810c4 --- /dev/null +++ b/crawl-ref/source/util/docs/contact.tex @@ -0,0 +1,146 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Files and Contact +}\end{center} + +This is the reference sheet for the roguelike game \dungeon\ \crawl, +specifically for the current version of the \textsc{Stone Soup} branch. +\crawl\ is a game of dungeon exploration, fighting and magic that is +renowned for its intricate skills and religion systems. Success requires +tactics, strategy, and perseverance. Though \crawl's reputation is +close to devilish, victories were reported\dots + +\para + +This page explains the various important files. The next page lists a +number of important changes introduced in version 0.4. The last two +pages give a very brief introduction to the game, which should be +enough to get you started. If you are completely new to this type of +game and still want to plunge right in, start up a new game and select +a tutorial (press \key{T} when asked for a species). + +\para\para + +\sex{The most important files} + +\para + +\begin{minipage}[t]{7cm} +The file \key{crawl.exe} in \crawl's main folder starts the game. +\\ \\ +The \sex{settings/} directory contains \key{init.txt}, the options file for +\crawl\ (on linux systems there may also be a \key{.crawlrc} in your home +directory). Since the defaults are well suited for playing, you can ignore +these at first. +\\ +This folder also contains \key{macro.txt}, a list of redefined key +bindings and macros. These make playing \crawl\ even more convenient. +You will probably not need to redefine key mappings until after you have +spent some time playing the game. +\end{minipage} +% +\spacecolumn +% +\begin{minipage}[t]{7cm} +The following files in the \sex{docs/} directory may be helpful: +\\ +\key{crawl\_manual.txt} is the full manual. It explains all races, classes, +item types etc. If you do not delight in manuals, you can put off the +reading this file until later. You can browse the manual while playing +(press \key{?}). +\\ +\key{options\_guide.txt} describes all the options in minute detail. While +tweaking these can improve your \crawl\ experience, you will probably prefer +to skip this at first. +\\ +\key{crawl\_macros.txt} explains macros and key bindings. You should probably +ignore this at first, too. + % (Unless you experience serious problems with some keys, in which case should + % look at the keymaps section.) +\end{minipage} + +\para\para + +\sex{Contact} + +\para + +If you have questions concerning the game, or think you have found a bug, +there are several places to contact the developers. First, there is the +newsgroup \key{rec.games.roguelike.misc}. Since other games are +discussed there as well, it is polite to flag your post with \key{-crawl-}. +If you are not familiar with Usenet netiquette, you might want to check +that first, too. +Also try to maintain netiquette to the benefit of your addresses. +\\ +Next, you are encouraged to file bug reports and feature requests on the +\crawl\ homepage at \key{http://crawl-ref.sourceforge.net}. From there, you +can also download the most recent version (both binaries or source, for +Unix, Windows, OS X, and DOS). +\\ +Finally, you can use the mailing list +\key{crawl-ref-discuss@lists.sourceforge.net} +to discuss specific details of the game's design and implementation. + +\para \para + +\sex{Internet play} + +\para + +You can play \crawl\ online, both competing with other players and watching +them. Check the homepage \key{crawl.akrasiac.org} for details, including +information about additional servers. You just need a \texttt{ssh} or +\texttt{telnet} console; on Windows, the \texttt{PuTTY} program works very +well. Read \key{ssh\_guide.txt} in the \key{docs} folder for a step by step +guide on how to set this up. + +\para \para + +\sex{Tiles} + +\para + +\crawl\ features an alternative to the classical ASCII display; Tile-based +Crawl is often easier accessible by new players. Tiles are available for +Linux, Windows and OS X. +Unfortunately, it is not yet possible to combine tiles and internet play. +\end{document} diff --git a/crawl-ref/source/util/docs/key_changes.txt b/crawl-ref/source/util/docs/key_changes.txt new file mode 100644 index 0000000000..b19b9c6928 --- /dev/null +++ b/crawl-ref/source/util/docs/key_changes.txt @@ -0,0 +1,111 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Important changes in 0.4 +}\end{center} + +In DCSS 0.4, for better ergonomics, many key bindings were changed. Also, +a small number of new commands were introduced. The tables below list all +of these. If you have been playing an older version and want to restore +the old key set, do so by adding this line to the +\texttt{init.txt} file: \\ +\texttt{additional\_macro\_file = 034\_command\_keys.txt} + +\para + +The command for examining items (was \key{v}) is gone. Bring up the +inventory and press the key matching an item's slot in order to examine it. + +When chopping up a single corpse on the ground, there is no longer any +prompt. You will only be prompted if there are two or more corpses. When +answering this prompt, you can use the following shortcuts: \key{c} means +yes, so you can press \key{cccc}\dots to chop up all corpses in one place, +or you can just hit \key{a} to butcher of corpses on a square. + +The \key{* Direction} and \key{Ctrl-Direction} keys now both open and close +doors. + +\para\para + +\begin{center} +\begin{tabular}{lll} +key & new command \\ \hline +\key{\_} & \mc{read message (only used for online play)} \\ +\key{!} & \mc{annotate level (read annotations with \key{Ctrl-O};} \\ + & \mc{annotations with an ! prompt when entering the level)} \\ +\key{(} & \mc{cycle ammunition} \\ +\key{Q} & \mc{quiver item} \\ +\key{`} & \mc{redo previous command} \\ +\key{0} & \mc{repeat next command} \\ +\key{Ctrl-T} & \mc{toggle ally pickup mode (only for permanent allies)} \\ +\key{Ctrl-D} & \mc{add macro (a new synonym for \key{$\sim$})} \\ +\\ +\\ +new key & command & old key \\ \hline +\key{G} & auto-travel & was \key{Ctrl-G} \\ +\key{z} & cast spell & was \key{Z} \\ +\key{Z} & zap wand & was \key{z} \\ +\key{o} & auto-explore & was \key{Ctrl-O} \\ +\key{Ctrl-O} & dungeon overview\phantom{xxx} & was \key{O} \\ +\key{O} & open door & was \key{o} \\ +\key{C} & close door & was \key{c} \\ +\key{c} & chop up & was \key{D}, dissect \\ +\key{E} & show experience & was \key{C} \\ +\key{v} & evoke & was \key{E} \\ +\key{F} & manually throw & was \key{t} \\ +\key{t} & tell/yell & was \key{!} \\ +\key{Ctrl-V} & Tiles settings & was \key{Ctrl-Q} \\ +\key{Ctrl-Q} & quit & was \key{Q} +\end{tabular} +\end{center} + +There are additional changes to the targeting interface: \\ +The functions of \key{!} and \key{.} have been swapped. So firing with +\key{.} will now stop at the target, whereas \key{!} will shoot further +if the target was missed (and \key{Enter}, \key{Del}, \key{Space} still +behave as in 0.3.4). \\ +You can now target using the monster list as well; \key{Ctrl-L} toggles +this option.\\ +You may quiver an item, meaning that you will preferably fire this +ammunition (and keep doing so even if you run out of it temporarily). +Quivering is done via \key{Q} (quiver the currently fired item) or +\key{fi} (choose an item and quiver it) or also by using \key{(} (cycling +appropriate ammunition) and then firing. \key{F} also lets you select an +item to be thrown, but this command does not affect the quiver. +\end{document} diff --git a/crawl-ref/source/util/docs/quickstart.tex b/crawl-ref/source/util/docs/quickstart.tex new file mode 100644 index 0000000000..ac28e17b70 --- /dev/null +++ b/crawl-ref/source/util/docs/quickstart.tex @@ -0,0 +1,236 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Very short introduction} +\end{center} + +Crawl is a large and very random game of subterranean exploration in a fantasy +world of magic and frequent violence. Your quest is to travel into the depths +of the Dungeon (which is different each time you play) and retrieve the Orb of +Zot. + +\para + +Crawl is a game of the 'roguelike' type, one of the descendants of Rogue. Its +graphics are simple but highly informative, designed to be understood at a +glance, and control is exercised largely through one-keystroke commands. + +\para\para + +\sex{Starting Out} \para + +After starting the program you will be greeted with a message asking for your +name. Don't spend too much time over this, as your first character will +\emph{not} last very long (sorry, but it's true). + +\para + +Next you are given menus of species and character classes from which to +choose. A dwarf, orc, ogre, or troll Fighter is a good bet. Elves are quite +fragile, humans are pretty average at everything, and the weirder species are +mostly too tricky for beginning players. Finally, you may be given a choice of +weapons. I suggest an axe (axes are fun). + +\para + +\begin{minipage}{10cm} +Now you are in the game. The game screen has three parts: \\ +The \textbf{Map} takes up the upper left part of the screen. In its very +centre is the \key{@} sign which represents You. The coloured parts of the map +is the area you can see, while places that you have visited before but cannot +currently see are shown in grey. \\ +The \textbf{Message box} is the large part of the screen below the map. It +describes all events as they happen. \\ +The \textbf{Stats area} contains information about your character. +\end{minipage} +\begin{minipage}{1cm} +\phantom{xx} +\end{minipage} +\begin{minipage}{4cm} +\includegraphics[scale=0.4]{screen} +\end{minipage} +\para\para + +\sex{Exploring} \para + +Try walking around, using either the numeric keypad (try numlock off and on) +or the \key{hjklyubn} keys. To move in a given direction until you reach +something interesting or see a hostile creature, press \key{Shift-direction}. + +If you want to know what a certain character on the screen represents, use the +\key{x} (examine) command to get a short description. Climb staircases with +the \key{<} (up) and \key{>} (down) commands. Doors are opened simply by +moving into them. Sometimes doors are hidden, and must be searched out by +standing next to walls and resting (a number of commands do the same thing: +\key{5} or \key{Shift-numpad-5} rest/search for a while, whereas \key{s} and +\key{.} (period) do so for just a single turn). + +The Dungeon gets more dangerous (but more interesting!) as you go down. If you +get lost, you can access a map of the whole level you are on with the \key{X} +command, which uses the whole screen. + +\para\para + +\sex{Items} \para + +After walking around for a while, you will no doubt come across some items +laying around (you may come across some monsters as well; for help in dealing +with them skip to the Monsters section). This table lists the most basic item +types that appear and typical commands to use them: + +\para + +\begin{tabular}{cll} +\sex{Symbol} & \sex{Item type (typical commands)} & \sex{Comments} \\ +\key{(} & Weapons (\key{w}ield) & Move into monsters to attack them.\\ +\key{)} & Missiles (\key{f}ire) & Wield a bow to fire arrows. Press \key{f?} for help.\\ +\key{[} & Armour (\key{W}ear and \key{T}ake off) & Can be cursed, like weapons and jewellery. \\ +\key{\%} & Food, corpses (\key{e}at and \key{c}hop up) & Dangerous chunks are coloured. \\ +\key{\$} & Gold & There are shops down below. \\ +\key{?} & Scrolls (\key{r}ead) & Scrolls mostly affect your environment.\\ +\key{!} & Potions (\key{q}uaff) & Potions affect you, in good or bad ways. \\ +\key{=} & Rings (\key{P}ut on and \key{R}emove) & Rings can be helpful as well as malignant. \\ +\key{"} & Amulets (\key{P}ut on and \key{R}emove) & Amulets can be even subtler than rings. \\ +\key{/} & Wands (\key{Z}ap) & Identify these by zapping at monsters. \\ +\key{+} & Books (\key{r}ead, \key{M}emorise and \key{z}ap) & Press \key{z?} for information on spells.\\ +\key{$\backslash$} & Staves and rods (\key{w}ield and e\key{v}oke) \hspace{0.2em} + & Rods carry spells but they are very rare. +%\key{\}} & Miscellaneous items (e\key{v}oke) & These will turn up only later. \\ +\end{tabular} + +\para + +Some vital commands are given next. For a full list of commands, press \key{??}. +Don't be scared by the abundance of commands, you will only need a handful at +the beginning. + +\para + +\begin{minipage}[t]{7cm} +\sex{Most basic commands for new players} \\ +\key{i} lists inventory \\ +\key{d} drops items \\ +\key{g} or \key{,} pick up items from the ground \\ +\key{gg} or \key{,,} for pickup menu \\ +\key{x} examines a seen monster (has help on \key{?}) \\ +\key{X} looks at the whole level (has help on \key{?}) \\ +\key{>} goes deeper one level \\ +\key{S} saves the game \\ +\key{?} prints the help screen +\end{minipage} +% +\spacecolumn +% +\begin{minipage}[t]{7cm} +\sex{Somewhat advanced commands} \\ +\key{p} prays (press \key{\^} for god information) \\ +\key{Ctrl-P} shows previous messages \\ +\key{Ctrl-F} searches for items dungeon-wide \\ +\key{G} provides automated travel between levels \\ +\key{o} provides automated exploration \\ +\key{\#} dumps character to the file \texttt{name.txt} \\ +\key{=} reassigns inventory or spell letters \\ +\key{m} checks your current skills \\ +\key{Ctrl-D} saves macros and key maps +\end{minipage} + +\para + +You will often want to get information on a particular item. If it is on the +ground, use the \key{x} command. If it is in your inventory, press \key{i}, +followed by the item's slot key. + +\para\para + +\sex{Monsters} \para + +You will also run into monsters (most of which are represented by letters of +the alphabet). You can attack a monster by trying to move into the square it +is occupying. +When you are wounded, you lose Health (displayed near the top of the stats +list); these return gradually over time through the natural process of +healing. If you lose all of your Health, you die. +To survive, you will need to develop a few basic tactics: \\ + +\begin{minipage}{7cm} +\begin{abcliste} +\item[$\bullet$] + Never fight more than one monster at a time if you can help it. Back + into a corridor so that they fight you one-on-one. +\item[$\bullet$] + If you are badly wounded, you can run away from monsters to buy some time. + Try losing them in corridors, or as a very last resort find a place where + you can run around in circles to heal while the monster chases you. +\end{abcliste} +\end{minipage} +\spacecolumn +\begin{minipage}{7cm} +\begin{abcliste} +\item[$\bullet$] + Remember to use projectiles before engaging monsters in close combat. +\item[$\bullet$] + Rest between encounters. Pressing \key{Shift-numpad-5} or \key{5} make + you rest for a while (you will stop resting when fully healed). +\item[$\bullet$] + Learn when to run away from things you can't handle --- this is important! + Often, it is wise to skip a dangerous level. +\end{abcliste} +\end{minipage} + + +\para\para + +\sex{Death} \para + +Before long, you'll probably end up dead. +Death in Crawl is permanent; you cannot just reload a saved game and start again +where you left off. The \key{S} (save) command exists only to let you leave a game +part-way through and come back to it later. + +\para + +Well, that's it for the quick-start guide. This should help you through your +first few games, but Crawl is extremely (some would say excessively) complex +and cannot be adequately described in so short a document. So when you feel +ready to start playing with magic, skills, and religions, browse the manual. + +\para + +Happy Crawling! +\end{document} diff --git a/crawl-ref/source/util/docs/screen.eps b/crawl-ref/source/util/docs/screen.eps new file mode 100644 index 0000000000..d66f62ab45 --- /dev/null +++ b/crawl-ref/source/util/docs/screen.eps @@ -0,0 +1,130 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%Title: screen.fig +%%Creator: fig2dev Version 3.2 Patchlevel 5-alpha5 +%%CreationDate: Fri Nov 24 15:15:41 2006 +%%For: ploog@a2 (David Ploog,,31/12/2008) +%%BoundingBox: 0 0 319 206 +%Magnification: 1.0000 +%%EndComments +/$F2psDict 200 dict def +$F2psDict begin +$F2psDict /mtrx matrix put +/col-1 {0 setgray} bind def +/col0 {0.000 0.000 0.000 srgb} bind def +/col1 {0.000 0.000 1.000 srgb} bind def +/col2 {0.000 1.000 0.000 srgb} bind def +/col3 {0.000 1.000 1.000 srgb} bind def +/col4 {1.000 0.000 0.000 srgb} bind def +/col5 {1.000 0.000 1.000 srgb} bind def +/col6 {1.000 1.000 0.000 srgb} bind def +/col7 {1.000 1.000 1.000 srgb} bind def +/col8 {0.000 0.000 0.560 srgb} bind def +/col9 {0.000 0.000 0.690 srgb} bind def +/col10 {0.000 0.000 0.820 srgb} bind def +/col11 {0.530 0.810 1.000 srgb} bind def +/col12 {0.000 0.560 0.000 srgb} bind def +/col13 {0.000 0.690 0.000 srgb} bind def +/col14 {0.000 0.820 0.000 srgb} bind def +/col15 {0.000 0.560 0.560 srgb} bind def +/col16 {0.000 0.690 0.690 srgb} bind def +/col17 {0.000 0.820 0.820 srgb} bind def +/col18 {0.560 0.000 0.000 srgb} bind def +/col19 {0.690 0.000 0.000 srgb} bind def +/col20 {0.820 0.000 0.000 srgb} bind def +/col21 {0.560 0.000 0.560 srgb} bind def +/col22 {0.690 0.000 0.690 srgb} bind def +/col23 {0.820 0.000 0.820 srgb} bind def +/col24 {0.500 0.190 0.000 srgb} bind def +/col25 {0.630 0.250 0.000 srgb} bind def +/col26 {0.750 0.380 0.000 srgb} bind def +/col27 {1.000 0.500 0.500 srgb} bind def +/col28 {1.000 0.630 0.630 srgb} bind def +/col29 {1.000 0.750 0.750 srgb} bind def +/col30 {1.000 0.880 0.880 srgb} bind def +/col31 {1.000 0.840 0.000 srgb} bind def + +end +save +newpath 0 206 moveto 0 0 lineto 319 0 lineto 319 206 lineto closepath clip newpath +-138.3 414.4 translate +1 -1 scale + +/cp {closepath} bind def +/ef {eofill} bind def +/gr {grestore} bind def +/gs {gsave} bind def +/sa {save} bind def +/rs {restore} bind def +/l {lineto} bind def +/m {moveto} bind def +/rm {rmoveto} bind def +/n {newpath} bind def +/s {stroke} bind def +/sh {show} bind def +/slc {setlinecap} bind def +/slj {setlinejoin} bind def +/slw {setlinewidth} bind def +/srgb {setrgbcolor} bind def +/rot {rotate} bind def +/sc {scale} bind def +/sd {setdash} bind def +/ff {findfont} bind def +/sf {setfont} bind def +/scf {scalefont} bind def +/sw {stringwidth} bind def +/tr {translate} bind def +/tnt {dup dup currentrgbcolor + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add + 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} + bind def +/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul + 4 -2 roll mul srgb} bind def +/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def +/$F2psEnd {$F2psEnteredState restore end} def + +$F2psBegin +10 setmiterlimit +0 slj 0 slc + 0.06299 0.06299 sc +% +% Fig objects follow +% +% +% here starts figure with depth 54 +/Helvetica ff 381.00 scf sf +5850 4050 m +gs 1 -1 sc (Stats) col0 sh gr +/Helvetica ff 381.00 scf sf +5850 4500 m +gs 1 -1 sc (Area) col0 sh gr +/Helvetica ff 381.00 scf sf +2880 6210 m +gs 1 -1 sc (Message Box) col0 sh gr +/Helvetica ff 381.00 scf sf +3150 4635 m +gs 1 -1 sc (The Map) col0 sh gr +% here ends figure; +% +% here starts figure with depth 50 +% Polyline +0 slj +0 slc +60.000 slw +n 2250 6525 m 2250 3375 l 7200 3375 l 7200 6525 l + 2250 6525 l cp gs col0 s gr +% Polyline +n 2250 5625 m + 7200 5625 l gs col0 s gr +% Polyline +n 5625 3375 m + 5625 5400 l gs col0 s gr +% Polyline +n 5625 5625 m + 5625 5400 l gs col0 s gr +% here ends figure; +$F2psEnd +rs +showpage +%%Trailer +%EOF diff --git a/crawl-ref/source/util/docs/screen.fig b/crawl-ref/source/util/docs/screen.fig new file mode 100644 index 0000000000..fa6d48896b --- /dev/null +++ b/crawl-ref/source/util/docs/screen.fig @@ -0,0 +1,21 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha5 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +2 1 0 5 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 6525 2250 3375 7200 3375 7200 6525 2250 6525 +2 1 0 5 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 2250 5625 7200 5625 +2 1 0 5 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5625 3375 5625 5400 +2 1 0 5 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5625 5625 5625 5400 +4 0 0 54 -1 4 24 0.0000 0 300 945 5850 4050 Stats\001 +4 0 0 54 -1 4 24 0.0000 0 300 855 5850 4500 Area\001 +4 0 0 54 -1 4 24 0.0000 0 390 2475 2880 6210 Message Box\001 +4 0 0 54 -1 4 24 0.0000 0 390 1605 3150 4635 The Map\001 diff --git a/crawl-ref/source/util/docs/screen.pdf b/crawl-ref/source/util/docs/screen.pdf new file mode 100644 index 0000000000..8de34e64d1 Binary files /dev/null and b/crawl-ref/source/util/docs/screen.pdf differ diff --git a/crawl-ref/source/util/key_changes.tex b/crawl-ref/source/util/key_changes.tex deleted file mode 100644 index b19b9c6928..0000000000 --- a/crawl-ref/source/util/key_changes.tex +++ /dev/null @@ -1,111 +0,0 @@ -\documentclass[a4paper,10pt]{article} - -\usepackage{palatino} -\usepackage{mathpazo} % optional [sc] fuer real small caps -\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} - -\usepackage{graphicx} - -\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores -\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined - -\newcommand{\crawl}{\textsc{Crawl}} -\newcommand{\dungeon}{\textsc{Dungeon}} - -\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} -\newcommand{\para}{\vspace{1.5ex}} -\setlength{\parindent}{0em} - -\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} - -\newcounter{abccounter} -\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} - {\usecounter{abccounter} - \setlength{\topsep}{0ex} - \setlength{\partopsep}{0ex} - \setlength{\listparindent}{0ex} - \setlength{\itemsep}{0ex} - \setlength{\parsep}{0ex} - \setlength{\leftmargin}{2em} - \setlength{\labelwidth}{2em} - \setlength{\parskip}{0ex} - } - }{\end{list}} - -\pagestyle{empty} - -\begin{document} - -\begin{center}\textbf{\LARGE -\dungeon\ \crawl: Important changes in 0.4 -}\end{center} - -In DCSS 0.4, for better ergonomics, many key bindings were changed. Also, -a small number of new commands were introduced. The tables below list all -of these. If you have been playing an older version and want to restore -the old key set, do so by adding this line to the -\texttt{init.txt} file: \\ -\texttt{additional\_macro\_file = 034\_command\_keys.txt} - -\para - -The command for examining items (was \key{v}) is gone. Bring up the -inventory and press the key matching an item's slot in order to examine it. - -When chopping up a single corpse on the ground, there is no longer any -prompt. You will only be prompted if there are two or more corpses. When -answering this prompt, you can use the following shortcuts: \key{c} means -yes, so you can press \key{cccc}\dots to chop up all corpses in one place, -or you can just hit \key{a} to butcher of corpses on a square. - -The \key{* Direction} and \key{Ctrl-Direction} keys now both open and close -doors. - -\para\para - -\begin{center} -\begin{tabular}{lll} -key & new command \\ \hline -\key{\_} & \mc{read message (only used for online play)} \\ -\key{!} & \mc{annotate level (read annotations with \key{Ctrl-O};} \\ - & \mc{annotations with an ! prompt when entering the level)} \\ -\key{(} & \mc{cycle ammunition} \\ -\key{Q} & \mc{quiver item} \\ -\key{`} & \mc{redo previous command} \\ -\key{0} & \mc{repeat next command} \\ -\key{Ctrl-T} & \mc{toggle ally pickup mode (only for permanent allies)} \\ -\key{Ctrl-D} & \mc{add macro (a new synonym for \key{$\sim$})} \\ -\\ -\\ -new key & command & old key \\ \hline -\key{G} & auto-travel & was \key{Ctrl-G} \\ -\key{z} & cast spell & was \key{Z} \\ -\key{Z} & zap wand & was \key{z} \\ -\key{o} & auto-explore & was \key{Ctrl-O} \\ -\key{Ctrl-O} & dungeon overview\phantom{xxx} & was \key{O} \\ -\key{O} & open door & was \key{o} \\ -\key{C} & close door & was \key{c} \\ -\key{c} & chop up & was \key{D}, dissect \\ -\key{E} & show experience & was \key{C} \\ -\key{v} & evoke & was \key{E} \\ -\key{F} & manually throw & was \key{t} \\ -\key{t} & tell/yell & was \key{!} \\ -\key{Ctrl-V} & Tiles settings & was \key{Ctrl-Q} \\ -\key{Ctrl-Q} & quit & was \key{Q} -\end{tabular} -\end{center} - -There are additional changes to the targeting interface: \\ -The functions of \key{!} and \key{.} have been swapped. So firing with -\key{.} will now stop at the target, whereas \key{!} will shoot further -if the target was missed (and \key{Enter}, \key{Del}, \key{Space} still -behave as in 0.3.4). \\ -You can now target using the monster list as well; \key{Ctrl-L} toggles -this option.\\ -You may quiver an item, meaning that you will preferably fire this -ammunition (and keep doing so even if you run out of it temporarily). -Quivering is done via \key{Q} (quiver the currently fired item) or -\key{fi} (choose an item and quiver it) or also by using \key{(} (cycling -appropriate ammunition) and then firing. \key{F} also lets you select an -item to be thrown, but this command does not affect the quiver. -\end{document} diff --git a/crawl-ref/source/util/quickstart.tex b/crawl-ref/source/util/quickstart.tex deleted file mode 100644 index ac28e17b70..0000000000 --- a/crawl-ref/source/util/quickstart.tex +++ /dev/null @@ -1,236 +0,0 @@ -\documentclass[a4paper,10pt]{article} - -\usepackage{palatino} -\usepackage{mathpazo} % optional [sc] fuer real small caps -\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} - -\usepackage{graphicx} - -\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores -\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined - -\newcommand{\crawl}{\textsc{Crawl}} -\newcommand{\dungeon}{\textsc{Dungeon}} - -\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} -\newcommand{\para}{\vspace{1.5ex}} -\setlength{\parindent}{0em} - -\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} - -\newcounter{abccounter} -\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} - {\usecounter{abccounter} - \setlength{\topsep}{0ex} - \setlength{\partopsep}{0ex} - \setlength{\listparindent}{0ex} - \setlength{\itemsep}{0ex} - \setlength{\parsep}{0ex} - \setlength{\leftmargin}{2em} - \setlength{\labelwidth}{2em} - \setlength{\parskip}{0ex} - } - }{\end{list}} - -\pagestyle{empty} - -\begin{document} - -\begin{center}\textbf{\LARGE -\dungeon\ \crawl: Very short introduction} -\end{center} - -Crawl is a large and very random game of subterranean exploration in a fantasy -world of magic and frequent violence. Your quest is to travel into the depths -of the Dungeon (which is different each time you play) and retrieve the Orb of -Zot. - -\para - -Crawl is a game of the 'roguelike' type, one of the descendants of Rogue. Its -graphics are simple but highly informative, designed to be understood at a -glance, and control is exercised largely through one-keystroke commands. - -\para\para - -\sex{Starting Out} \para - -After starting the program you will be greeted with a message asking for your -name. Don't spend too much time over this, as your first character will -\emph{not} last very long (sorry, but it's true). - -\para - -Next you are given menus of species and character classes from which to -choose. A dwarf, orc, ogre, or troll Fighter is a good bet. Elves are quite -fragile, humans are pretty average at everything, and the weirder species are -mostly too tricky for beginning players. Finally, you may be given a choice of -weapons. I suggest an axe (axes are fun). - -\para - -\begin{minipage}{10cm} -Now you are in the game. The game screen has three parts: \\ -The \textbf{Map} takes up the upper left part of the screen. In its very -centre is the \key{@} sign which represents You. The coloured parts of the map -is the area you can see, while places that you have visited before but cannot -currently see are shown in grey. \\ -The \textbf{Message box} is the large part of the screen below the map. It -describes all events as they happen. \\ -The \textbf{Stats area} contains information about your character. -\end{minipage} -\begin{minipage}{1cm} -\phantom{xx} -\end{minipage} -\begin{minipage}{4cm} -\includegraphics[scale=0.4]{screen} -\end{minipage} -\para\para - -\sex{Exploring} \para - -Try walking around, using either the numeric keypad (try numlock off and on) -or the \key{hjklyubn} keys. To move in a given direction until you reach -something interesting or see a hostile creature, press \key{Shift-direction}. - -If you want to know what a certain character on the screen represents, use the -\key{x} (examine) command to get a short description. Climb staircases with -the \key{<} (up) and \key{>} (down) commands. Doors are opened simply by -moving into them. Sometimes doors are hidden, and must be searched out by -standing next to walls and resting (a number of commands do the same thing: -\key{5} or \key{Shift-numpad-5} rest/search for a while, whereas \key{s} and -\key{.} (period) do so for just a single turn). - -The Dungeon gets more dangerous (but more interesting!) as you go down. If you -get lost, you can access a map of the whole level you are on with the \key{X} -command, which uses the whole screen. - -\para\para - -\sex{Items} \para - -After walking around for a while, you will no doubt come across some items -laying around (you may come across some monsters as well; for help in dealing -with them skip to the Monsters section). This table lists the most basic item -types that appear and typical commands to use them: - -\para - -\begin{tabular}{cll} -\sex{Symbol} & \sex{Item type (typical commands)} & \sex{Comments} \\ -\key{(} & Weapons (\key{w}ield) & Move into monsters to attack them.\\ -\key{)} & Missiles (\key{f}ire) & Wield a bow to fire arrows. Press \key{f?} for help.\\ -\key{[} & Armour (\key{W}ear and \key{T}ake off) & Can be cursed, like weapons and jewellery. \\ -\key{\%} & Food, corpses (\key{e}at and \key{c}hop up) & Dangerous chunks are coloured. \\ -\key{\$} & Gold & There are shops down below. \\ -\key{?} & Scrolls (\key{r}ead) & Scrolls mostly affect your environment.\\ -\key{!} & Potions (\key{q}uaff) & Potions affect you, in good or bad ways. \\ -\key{=} & Rings (\key{P}ut on and \key{R}emove) & Rings can be helpful as well as malignant. \\ -\key{"} & Amulets (\key{P}ut on and \key{R}emove) & Amulets can be even subtler than rings. \\ -\key{/} & Wands (\key{Z}ap) & Identify these by zapping at monsters. \\ -\key{+} & Books (\key{r}ead, \key{M}emorise and \key{z}ap) & Press \key{z?} for information on spells.\\ -\key{$\backslash$} & Staves and rods (\key{w}ield and e\key{v}oke) \hspace{0.2em} - & Rods carry spells but they are very rare. -%\key{\}} & Miscellaneous items (e\key{v}oke) & These will turn up only later. \\ -\end{tabular} - -\para - -Some vital commands are given next. For a full list of commands, press \key{??}. -Don't be scared by the abundance of commands, you will only need a handful at -the beginning. - -\para - -\begin{minipage}[t]{7cm} -\sex{Most basic commands for new players} \\ -\key{i} lists inventory \\ -\key{d} drops items \\ -\key{g} or \key{,} pick up items from the ground \\ -\key{gg} or \key{,,} for pickup menu \\ -\key{x} examines a seen monster (has help on \key{?}) \\ -\key{X} looks at the whole level (has help on \key{?}) \\ -\key{>} goes deeper one level \\ -\key{S} saves the game \\ -\key{?} prints the help screen -\end{minipage} -% -\spacecolumn -% -\begin{minipage}[t]{7cm} -\sex{Somewhat advanced commands} \\ -\key{p} prays (press \key{\^} for god information) \\ -\key{Ctrl-P} shows previous messages \\ -\key{Ctrl-F} searches for items dungeon-wide \\ -\key{G} provides automated travel between levels \\ -\key{o} provides automated exploration \\ -\key{\#} dumps character to the file \texttt{name.txt} \\ -\key{=} reassigns inventory or spell letters \\ -\key{m} checks your current skills \\ -\key{Ctrl-D} saves macros and key maps -\end{minipage} - -\para - -You will often want to get information on a particular item. If it is on the -ground, use the \key{x} command. If it is in your inventory, press \key{i}, -followed by the item's slot key. - -\para\para - -\sex{Monsters} \para - -You will also run into monsters (most of which are represented by letters of -the alphabet). You can attack a monster by trying to move into the square it -is occupying. -When you are wounded, you lose Health (displayed near the top of the stats -list); these return gradually over time through the natural process of -healing. If you lose all of your Health, you die. -To survive, you will need to develop a few basic tactics: \\ - -\begin{minipage}{7cm} -\begin{abcliste} -\item[$\bullet$] - Never fight more than one monster at a time if you can help it. Back - into a corridor so that they fight you one-on-one. -\item[$\bullet$] - If you are badly wounded, you can run away from monsters to buy some time. - Try losing them in corridors, or as a very last resort find a place where - you can run around in circles to heal while the monster chases you. -\end{abcliste} -\end{minipage} -\spacecolumn -\begin{minipage}{7cm} -\begin{abcliste} -\item[$\bullet$] - Remember to use projectiles before engaging monsters in close combat. -\item[$\bullet$] - Rest between encounters. Pressing \key{Shift-numpad-5} or \key{5} make - you rest for a while (you will stop resting when fully healed). -\item[$\bullet$] - Learn when to run away from things you can't handle --- this is important! - Often, it is wise to skip a dangerous level. -\end{abcliste} -\end{minipage} - - -\para\para - -\sex{Death} \para - -Before long, you'll probably end up dead. -Death in Crawl is permanent; you cannot just reload a saved game and start again -where you left off. The \key{S} (save) command exists only to let you leave a game -part-way through and come back to it later. - -\para - -Well, that's it for the quick-start guide. This should help you through your -first few games, but Crawl is extremely (some would say excessively) complex -and cannot be adequately described in so short a document. So when you feel -ready to start playing with magic, skills, and religions, browse the manual. - -\para - -Happy Crawling! -\end{document} -- cgit v1.2.3-54-g00ecf