From cde8c3628fabe4305b737dac6f7885965515368b Mon Sep 17 00:00:00 2001
From: Malin Freeborn <malinfreeborn@posteo.net>
Date: Sat, 21 Jan 2023 22:54:18 +0100
Subject: [PATCH] expand docs

---
 docs.tex | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git a/docs.tex b/docs.tex
index 44d51442..4201906b 100644
--- a/docs.tex
+++ b/docs.tex
@@ -27,7 +27,7 @@ The next one might look like this:
 
 \dragon
 
-If you find it hard to tell the difference between all the dragons, you can give them names in square brackets with the {\tt\textbackslash NPC command}, like this:
+If you find it hard to tell the difference between all the dragons, you can give them names in square brackets with the {\tt\textbackslash npc command}, like this:
 
 {\tt\textbackslash dragon[\textbackslash npc\{\textbackslash M\}\{Bob the dragon\}] }
 
@@ -35,9 +35,8 @@ Which then makes a male dragon called ``Bob'':
 
 \dragon[\npc{\M}{Bob the Dragon}]
 
-The first field can also indicate a female with an {\tt\textbackslash F} (\F), a team of people with a {\tt\textbackslash T} (\T), or undead with \textbackslash D (\D).
-
-With a little study, you can summon dozens of monsters, including {\tt\textbackslash humansoldier}, {\tt\textbackslash basilisk}, and {\tt \textbackslash ghoul}.
+You can summon dozens of monsters, including {\tt\textbackslash humansoldier}, {\tt\textbackslash basilisk}, and {\tt \textbackslash ghoul}
+(see {\tt monsters.tex} for all the examples).
 
 \subsection{Individual NPCs}
 
@@ -74,6 +73,25 @@ Individual characters can be created by using the {\tt\textbackslash npc} comman
 {\longsword, adventuring equipment}% EQUIPMENT
 {}
 
+\subsubsection{Bestiary}
+
+Statblocks in a bestiary chapter (or any space for examples).
+You can set an example chapter by writing {\tt\textbackslash settoggle\{bestiarychapter\}\{true\}}
+
+Then the {\tt \textbackslash humansoldier} command turns from this:
+
+\humansoldier
+
+\settoggle{bestiarychapter}{true}
+
+\ldots into this:
+
+\humansoldier
+
+This second soldier is still partly random.
+
+\subsection{Boxes}
+
 You can add things for these people to say with a {\tt\textbackslash begin\{speechtext\}} command:
 
 \begin{speechtext}
@@ -84,7 +102,7 @@ You can add things for these people to say with a {\tt\textbackslash begin\{spee
 
 \end{speechtext}
 
-\subsection{And now for something completely different}
+\subsection{Magical items}
 
 This is a magical item.
 
-- 
GitLab