Format chapter 8

chapters/chap08-military.rst

@@ -2,21 +2,23 @@
 Soldiers and your army
 ######################
 
-.. note::
+.. warning::
 
     This information is for an old version of the game.  Don't take it
     too seriously until it's updated.
 
-While you’re exploring and digging around (see Tutorial 9) how about we
+    See :wiki:`Military` for up-to-date information.
+
+While you’re exploring and digging around (see chapter 7), how about we
 set up a military? You’re going to need one, goblins are pesky bastards
 and likely to bother you more and more (if they haven’t already).
 Soldiers can be a bit fiddly to manipulate, but once you get the hang
 of it you’ll find it second nature.
 
-Drafting some dwarfs
-====================
-The first thing you will need to do, fairly obviously, is draft some
-dwarfs into your military. There are a few different strategies for
+Drafting some dwarves
+=====================
+The first thing you will need to do is draft some
+dwarves into your military. There are a few different strategies for
 this. First up, you can pick complete newbies and let them work up
 their skills and strength through sparing. Another strategy is to have
 some peasants work on screw pumps to quickly build up their strength
@@ -29,56 +31,57 @@ soldiers. When they give birth it’s not uncommon to see them running
 into battle carrying a baby. This is both somewhat alarming and
 somewhat risky as you’re going to have potentially dead babies on your
 hands due to combat, something that might cause a lot of emo among your
-dwarfs.
+dwarves.
 
 For this tutorial we’re not going to worry about detail to much and
 we’re just going to grab 6 peasants – which is 10% of my current
 fortress population. Something similar will work for you for now. So
 here’s what we’ll do:
 
-* Hit “m” for the “military” screen.
+* Hit :kbd:`m` for the :guilabel:`military` screen.
 
-You’ll note this screen is not unlike the “u”, “units” screen. The
-difference is that there are a few different commands at the bottom of
+You’ll note this screen is not unlike the :kbd:`u`, :guilabel:`units` screen.
+The difference is that there are a few different commands at the bottom of
 the panel. Primarily, this screen lets you organise your squads and it
 lets you set squad weapons. We’re going to aim for two squads of three
-dwarfs. Smaller squads helps your response time to enemy threat and
+dwarves. Smaller squads helps your response time to enemy threat and
 gives you a bit more control. Lets get on with it:
 
-* Scroll to one of your no-life peasant dwarfs, hit “enter”. Now when
+* Scroll to one of your no-life peasant dwarves, hit :kbd:`Enter`. Now when
   you move your arrow you will see the peasant is marked and there’s an
   arrow to chose another dwarf. Chose another pleb, hit enter.
 * Scroll, chose another dwarf, and hit enter again.
 * Hit space to stop promoting. We’ve created our first squad.
 * Chose another spare peasant, hit enter to promote and then choosing
-  two more dwarfs, create squad two.
+  two more dwarves, create squad two.
 
-You will now note that the dwarfs in the same squad are now sharing the
-same squad name, “The Relieved Irons” and “The Muscular Palaces” for
+You will now note that the dwarves in the same squad are now sharing the
+same squad name, 'The Relieved Irons' and 'The Muscular Palaces' for
 me, awesome! But they’re not doing anything yet, they’re assigned to
 squads but aren’t active doing soldierly stuff, so:
 
-* Scroll to the first squad leader, hit “a” for activate.
-* Scroll to the second squad leaders and “a” activate him as well.
+* Scroll to the first squad leader, hit :kbd:`a` for activate.
+* Scroll to the second squad leaders and :kbd:`a` activate him as well.
 * Scroll to the top of your military list, your squads are now up there
   with their names in grey.
-* On the first squad leader, hit “v” for view squad.
-* If the squad is “on duty” hit “t”  to stand them down.
-* Hit “f” for “Food carried” and they’ll go get backpacks and put a
-  stock of food in them for long duties.
+* On the first squad leader, hit :kbd:`v` for view squad.
+* If the squad is :guilabel:`on duty` hit :kbd:`t`  to stand them down.
+* Hit :kbd:`f` for :guilabel:`Food carried` and they’ll go get backpacks
+  and put a stock of food in them for long duties.
 * Leave other settings and repeat for squad two.
 
-Our dwarfs are now soldiers and are going to go do soldierly things.
+Our dwarves are now soldiers and are going to go do soldierly things.
 What’s that you ask? Well, drink, eat and hang around the barracks
 sparing mostly. But shouldn’t we give them some weapons and armor?
 Maybe, is the answer, lets show you how:
 
-* With the military screen up, hit “w” for weapons.
+* With the military screen up, hit :kbd:`w` for weapons.
 * You now have a field you can move around using the arrow keys and
-  cycle using “enter”. Leave the dwarfs unarmed.
-* Scroll to the first “A”, which is for “armor” and hit “enter” until
-  the field shows “Lth” for leather. Then go to the next column and hit
-  “enter” until you see “Shd” for shield.
+  cycle using :kbd:`Enter`. Leave the dwarves unarmed.
+* Scroll to the first :kbd:`A`, which is for :guilabel:`armor` and hit
+  :kbd:`Enter` until the field shows :guilabel:`Lth` for leather.
+  Then go to the next column and hit :kbd:`Enter` until you see
+  :guilabel:`Shd` for shield.
 * If you look further down your weapons list you may note how
   woodcutters are armed with an axe. And note that any you’ve told to be
   woodcutters who don’t have an axe won’t cut wood… although they might
@@ -90,37 +93,38 @@ each. You did remember to make a bunch of armor as instructed earlier,
 right? They will then go to the barracks and spar. Why do we want them
 to spar unarmed? A few reasons:
 
-#. Sparring unarmed trains “Wrestling” which is very handy, as it
+#. Sparring unarmed trains the wrestling skill, and
    builds the key stats (like all training) but also trains quickly.
-   Wrestling Hammer weapon skill is the skill used by crossbow dwarfs when
+   Hammer weapon skill is the skill used by crossbow dwarves when
    out of bolts. Yes, they bash the enemy to death with their crossbows.
    We can train hammering latter.
-#. Wrestling helps when an enemy disarms your dwarfs as they have to
+#. Wrestling helps when an enemy disarms your dwarves as they have to
    fight unarmed then, and yes, a few enemies can disarm your lads.
-#. Finally, picture newby dwarfs with no skill training with razor
+#. Finally, picture newby dwarves with no skill training with razor
    sharp steel battleaxes. Yes, picture a few graves. Wrestling gets them
    tough enough to spar with decent weapons without a lot of weapon access
    micromanagement in the stocks screen (ie. forcing them to pick up
    wooden weapons and later on dropping them in favour of proper weapons).
 
 One thing you might want to think about is providing food and drink and
-somewhere to eat close to your military dwarfs. That way they will
+somewhere to eat close to your military dwarves. That way they will
 hopefully spend more time training and less time walking! Here’s how I
 set up a small dining room and a small food stockpile. Note, the whole
 area is outside – I’m hoping that some regular exposure to the sun
 while the soldiers eat will prevent them getting too cave adapted. I’ve
 had to roof over the bit with the tables and chairs though, those need
-to be placed inside. You can “b”, “C” construct a ramp in the outdoors
-area and then “b”, “C” construct a floor to cover the area (you go up a
+to be placed inside. You can :kbd:`b`, :kbd:`C` construct a ramp in
+the outdoors area and then :kbd:`b`, :kbd:`C` construct a floor to
+cover the area (you go up a
 level, build a floor over the space, and it thus becomes a roof). But
 we will cover some of this in another tutorial as well.
 
-.. image:: images/dftutorial9909.png
+.. image:: images/08-barracks.png
    :align: center
 
-…hmm, actually, I have so many bloody dwarfs I’m going to put each
-squad up to four members each. That means we’ll have up to 8 dwarfs
-sparing at once, good stuff. To add more dwarfs, go to the military
+…hmm, actually, I have so many bloody dwarves I’m going to put each
+squad up to four members each. That means we’ll have up to 8 dwarves
+sparing at once, good stuff. To add more dwarves, go to the military
 screen again, hit enter on the leader and then chose a dwarf to add to
 the squad.
 
@@ -129,7 +133,7 @@ by accidentally making the boss of one squad the boss of another squad.
 This is annoying and pointless, as far as I can tell. To fix it, chose
 the problematic squad or person, hit enter on them, and then hit enter
 again. Hopefully that will remove them back up the chain of command.
-Or, hit enter on the boss and then enter on the dwarfs 2 steps down,
+Or, hit enter on the boss and then enter on the dwarves 2 steps down,
 that will pull them back up to being directly under the boss’s command.
 
 While the boys are sparring go to your leather workshop and make sure
@@ -141,40 +145,41 @@ get them into leather, and yes, armor does stack later.
 War Puppies!
 ============
 A nice addition to your military are some war dogs. How do you get war
-dogs? Easy! Find a space in your workshop and “b” build a “k” kennel.
-Note, this is a big building, so you may have to free up some space to
+dogs? Easy! Find a space in your workshop and :kbd:`b` build a :kbd:`k`
+kennel. This is a large building, so you may have to free up some space to
 place it. Then ensure you have someone with the animal training labour
 on (so it gets built and so you will be training animals).
 
-Then, go to the kennels using “q” and hit “a” for add task and then “w”
-for “Train War Dog”. Hit “r” to set the task on repeat. Hopefully all
+Then, go to the kennels using :kbd:`q` and hit :kbd:`a` for add task
+and then :kbd:`w` for :guilabel:`Train War Dog`. Hit :kbd:`r` to set
+the task on repeat. Hopefully all
 the adult dogs will now go about being trained. You’ll soon start
-getting messages like “An animal has become a stray war dog”. Good!
+getting messages like :guilabel:`An animal has become a stray war dog`. Good!
 
 How can these help us? Well, we can either assign them to restraints we
-build (using “b” and then “v” and choosing either a rope or a chain and
-then once placed, using “q” to assign an animal to the restraint) or we
+build - use :kbd:`b`, :kbd:`v` and choose either a rope or a chain;
+once placed use :kbd:`q` to assign an animal to the restraint - or we
 can assign them to soldiers. Lets assign one to each soldier:
 
-* Hit “m” to bring up your military.
-* Hit “c” to look at a soldier.
-* Hit “p” for “preferences”.
-* Hit “e” for “Work Dogs”.
-* Hit “r” to assign a dog to that dwarf. Once you have enough trained,
+* Hit :kbd:`m` to bring up your military.
+* Hit :kbd:`c` to look at a soldier.
+* Hit :kbd:`p` for :guilabel:`Preferences`.
+* Hit :kbd:`e` for :guilabel:`Work Dogs`.
+* Hit :kbd:`r` to assign a dog to that dwarf. Once you have enough trained,
   assigned one each.
 
 You can also train hunting dogs at a kennels and they are quite handy
-for hunters, since they too have the “ambush” skill that Hunters use. I
-don’t usually bother with hunter dwarfs so wardogs is all I want!
+for hunters, since they too have the ambush skill that Hunters use. I
+don’t usually bother with hunter dwarves so wardogs is all I want!
 Hordes of the buggers! Oh, a note on caged animals. Cages, when built
-(“b”, “j”), allow the assigning of animals to them, and can be set as a
-zoo room. Dwarfs enjoy relaxing in Zoos and looking at animals they
+(:kbd:`b`, :kbd:`j`), allow the assigning of animals to them, and can be
+used as a zoo. dwarves enjoy relaxing in Zoos and looking at animals they
 like (happy thoughts). Consider building a zoo near the dining room.
-When placing cages, if you already have animals in them, hit “x” to
+When placing cages, if you already have animals in them, hit :kbd:`x` to
 expand the view and chose the exact cage you want to place. Here’s my
 zoo, where the old housing used to be before we moved it all down stairs.
 
-.. image:: images/dftutorial9910.png
+.. image:: images/08-zoo.png
    :align: center
 
 Right, where were we!?
@@ -182,8 +187,8 @@ Right, where were we!?
 Get tough, little guys!
 =======================
 So your boys are training, putting each other in arm bars and whatnot.
-If you use “v” and look around your soldiers, hitting “g” for General,
-you should see their skills climbing. Use “alt”+”arrows” to see the
+If you use :kbd:`v` and look around your soldiers, hitting :kbd:`g` for General,
+you should see their skills climbing. Use :kbd:`=` to see the
 full range.
 
 Let them keep this up until they become champions or heroes. At this
@@ -211,15 +216,15 @@ right? Good!
 But before we assign the weapons we want to make sure our soldiers
 don’t pick up the wrong armor, right? So this is what we do:
 
-* Go to your stocks menu under “z”. You should now see all your stocks
+* Go to your stocks menu under :kbd:`z`. You should now see all your stocks
   updated by your bookkeeper, handy!
-* Find the “weapons” first. Scroll through and look for any other sort
-  of hammer. Chances are “steel hammers” are all you have. For good
+* Find the :guilabel:`weapons` first. Scroll through and look for any other
+  hammers. Chances are :guilabel:`steel hammers` are all you have. For good
   measure, set everything that looks useless (ie, not an axe or a pick)
-  to “m” for melt. Or put that trash into weapon traps.
-* Go to the “armor” list (and subsequent clothing lists) and look for
-  chainmail. Any chain item that isn’t steel chainmail set to “forbid”
-  using “f”. Now your boys won’t go picking up the rubbish when you
+  to :kbd:`m` for melt. Or put that trash into weapon traps.
+* Go to the :guilabel:`armor` list (and subsequent clothing lists) and look for
+  chainmail. Any chain item that isn’t steel chainmail set to :guilabel:`forbid`
+  using :kbd:`f`. Now your boys won’t go picking up the rubbish when you
   change their armor setting. Make sure you’ve got enough suits of
   chainmail armor, steel shields, helms, etc, to equip your lads. Or near
   enough.
@@ -227,9 +232,10 @@ don’t pick up the wrong armor, right? So this is what we do:
   to no armor and once they’ve dumped all their items, go back through
   the equiping process again.
 
-Now, you can go to the “m” military menu and hit “w” for the weapons
-and change them from “Lth” to “Chn” and the weapon to “Ham”. Your
-dwarfs will rush off, grab a warhammer and throw some steel chainmail
+Now, you can go to the :kbd:`m` military menu and hit :kbd:`w` for the weapons
+and change them from :guilabel:`Lth` to :guilabel:`Chn` and the
+weapon to :guilabel:`Ham`. Your
+dwarves will rush off, grab a warhammer and throw some steel chainmail
 on top of their leather armor, great! If a few of them get to be
 awesome armor users you can change them to plate and they will even put
 the plate on top of their chain on top of their leather. A tiny, cute,
@@ -237,19 +243,19 @@ drunk, ball of fury!
 
 MAD: Mutually Assured Dwarfiness
 ================================
-How do you use your dwarfs then? Well, when they aren’t mucking about
+How do you use your dwarves then? Well, when they aren’t mucking about
 your barracks working on their skills they can be out fighting bad
 guys! How I do it, when invaded is:
 
-* Hit “m”.
-* Go to a squad leader, hit “v” (NOT “a”, that turns them back to
-  peasants – but “a” again will turn them back to squadies).
-* Hit “t” to make the squad respond to orders.
-* hit “z” to zoom to the commander.
+* Hit :kbd:`m`.
+* Go to a squad leader, hit :kbd:`v` (*not* :kbd:`a`, that turns them back to
+  peasants – but :kbd:`a` again will turn them back to squadies).
+* Hit :kbd:`t` to make the squad respond to orders.
+* hit :kbd:`z` to zoom to the commander.
 * I then go to the level and place I want the squad to go.
-* Hit “s” to station the soldiers there, or hit “p” to place a patrol
+* Hit :kbd:`s` to station the soldiers there, or hit :kbd:`p` to place a patrol
   point and then move your cursor around and hit p again to place another
-  point (and keep hitting “p” to place more).
+  point (and keep hitting :kbd:`p` to place more).
 
 Your soldiers will now stop what they are doing and rush to the station
 point. Sometimes it’s a good idea to set it in a safe place first, so
@@ -258,7 +264,7 @@ drop the station point in the middle of the bad guys you risk your lads
 charging in one by one.
 
 There’s a lot of ways of handling military, and we haven’t even covered
-crossbow weilding marksdwarfs, multiple weapons, archery targets, or
+crossbow weilding marksdwarves, multiple weapons, archery targets, or
 any of that stuff. For now, go and build your military and come back
 for the next tutorial where we’ll round out your Dwarf Fortress lesson
 with some thoughts on magma, construction and fortress design!