Added three printable files (contact, key changes, quickstart) and put them

into the new pdf/ directory. The corresponding tex files are in source/utils/
(feel free to rename the files, or move them to better locations).


git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@6416 c06c8d41-db1a-0410-9941-cceddc491573

6 files changed, 493 insertions, 0 deletions

diff --git a/crawl-ref/pdf/contact.pdf b/crawl-ref/pdf/contact.pdf
new file mode 100644
index 0000000000..7455d45de2
--- /dev/null
+++ b/crawl-ref/pdf/contact.pdf
diff --git a/crawl-ref/pdf/key_changes.pdf b/crawl-ref/pdf/key_changes.pdf
new file mode 100644
index 0000000000..c439fd607a
--- /dev/null
+++ b/crawl-ref/pdf/key_changes.pdf
diff --git a/crawl-ref/pdf/quickstart.pdf b/crawl-ref/pdf/quickstart.pdf
new file mode 100644
index 0000000000..43ffcff327
--- /dev/null
+++ b/crawl-ref/pdf/quickstart.pdf
diff --git a/crawl-ref/source/util/contact.tex b/crawl-ref/source/util/contact.tex
new file mode 100644
index 0000000000..9b158810c4
--- /dev/null
+++ b/crawl-ref/source/util/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/key_changes.tex b/crawl-ref/source/util/key_changes.tex
new file mode 100644
index 0000000000..b19b9c6928
--- /dev/null
+++ b/crawl-ref/source/util/key_changes.tex
@@ -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/quickstart.tex b/crawl-ref/source/util/quickstart.tex
new file mode 100644
index 0000000000..ac28e17b70
--- /dev/null
+++ b/crawl-ref/source/util/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}