Mass update editor documentation

doc/editor/Building.html

@@ -27,9 +27,9 @@ will be used later).</p>
 <p>The first text box is for the name of your scenario. This is the real name, like Quest
 For the Sword, or Guys Running Around Lost. Make up some sort of name.</p>
 
-<p>The second box is for your scenario's file name, the name of the actual file the
-program will create. This must be all letters, and can be at most 8 characters long <!--
-todo: check this -->, like questsrd, or lostguys. Make up a file name.</p>
+<p>The second box is for your own name, or whatever name you would like to be credited by.
+This currently is not used or editable anywhere, but fill it in anyway - it'll probably be
+used in the future.</p>
 
 <p>Finally, the button at the bottom determines whether the outdoors the scenario will
 start with will be caves or grass. Click on this button. Then press OK.</p>
@@ -50,6 +50,12 @@ and get training. Every scenario should have a place like this, but such towns c
 time-consuming and difficult to make. Fortunately, Warrior's Grove is provided for you.
 Press the Include Starter Town button, and then OK.</p>
 
+<p>Now the file save dialog will appear, allowing you to choose where to save your
+scenario. Putting it in the Blades of Exile Scenarios folder is usually a good choice, as
+that will allow you to test it without moving any files whenever you change something. You
+can also put it in a subfolder of the Blades of Exile Scenarios folder - the game will
+still be able to find it.</p>
+
 <h2>Editing Your Scenario</h2>
 
 <p>You will now be facing the Blades of Exile main screen. First, let's look at our default
@@ -58,14 +64,14 @@ town and maybe edit it a little. Press the Edit Town Terrain button.</p>
 <p>You are now looking at Warrior's Grove. Look around it for a little bit. To scroll the
 view around, click on the white border around the terrain (or use the keypad). Now take a
 more panoramic view. There is a grid of buttons in the lower right hand corner of the
-screen. Press the first button in the second row a few times. You will see an overall view
-of the town. You could edit terrain from this view, but it's often better to use the other
-view. Press the button again to zoom back in.</p>
+screen. Press the second-last button in the second row a few times. You will see an
+overall view of the town. You could edit terrain from this view, but it's often better to
+use the close-up view. Press the button again until it zooms back in.</p>
 
 <p>Scroll the terrain back to the center of the town, by the dog. Let's place a tree.
 Drawing terrain works much like a painting program. Each of the spots of terrain to the
 upper right represents a different terrain type (many of them have small symbols - ignore
-these for now). Look for the trees (in the middle of the seventh row). Click on a tree.
+these for now). Look for the trees (at the start of the eighth row). Click on a tree.
 Then click on the pencil button (in the upper left hand corner of the grid of buttons).
 Finally, click on the spot of grass to the right of the dog.</p>
 
@@ -106,14 +112,15 @@ to press the Load Another Town button on the main screen and enter town 0 to loa
 looking at your new town. You will be looking at a blank slate. There's nothing here but
 grass and a few rocks. First, lets make a building.</p>
 
-<p>Click on the basic wall terrain, the fourth terrain in the eighth row. Don't click on
-any of the walls with little symbols on them - these symbols indicate that the terrain has
-some sort of special property. What these symbols mean is explained later.</p>
+<p>Click on the basic wall terrain, the eleventh terrain in the eighth row (next to the
+sign). Don't click on any of the walls with little symbols on them - these symbols
+indicate that the terrain has some sort of special property. What these symbols mean is
+explained later.</p>
 
 <p>Now that you're drawing walls, draw a large rectangle in the terrain area. It can be
 whatever size you'd like, but make it be around seven high and seven wide. This will be the
-walls of a building. Then select the floor terrain (first terrain in the 11th row). Paint
-a floor inside the walls. Finally, click on the first door icon (7th terrain in the 8th
+walls of a building. Then select the floor terrain (11th terrain in the 11th row). Paint
+a floor inside the walls. Finally, click on the first door icon (14th terrain in the 8th
 row). Place a door somewhere in your wall. You will now have a building.</p>
 
 <p>By now, you are probably confused by the huge number of terrain types available to you.
@@ -128,22 +135,26 @@ Fortunately, when you draw cave walls, hills, water, or mountains, the editor wi
 automatically change them so that they curve around and match each other at the edges.</p>
 
 <p>To see this, scroll the terrain view a little to the north of your building, and select
-the hill terrain (third terrain in the third row). Draw a 3x3 square of hill on the grass.
+the hill terrain (fifth terrain in the third row). Draw a 3x3 square of hill on the grass.
 Notice how the editor automatically shifts it around so it all lines up into a nice
 square! This will save you a huge amount of time.</p>
 
 <p>Now, we can make some monsters to fight. Scroll back down to your building. We're going
-to place a few goblins into it. Go up to the M1 menu, and select Goblin. Then click inside
-the building. There's now a goblin there. Do it a few more times.</p>
+to place a few goblins into it. In the right-most column of buttons, click the third one
+(with the little person icon). The terrain palette will change to show monsters instead.
+Select a Goblin (6th in the 3rd row). Then click inside the building. There's now a goblin
+there. Do it a few more times.</p>
 
 <p>When the player enters this room, the goblins will attack. That is because goblins are
 set to be always hostile. You can find out later how to make the goblins friendly, but for
 now, they might as well fight.</p>
 
-<p>Now, you can give the goblins some loot to steal. Go up to the I1 menu, and select a
-weapon. Then click inside the building. There is now a weapon there for the player to
-find. Now select Gold from the I1 menu and click inside the building. There is some gold
-there.</p>
+<p>Now, you can give the goblins some loot to steal. In the right-most column of buttons,
+click the middle one (with the sword). Now the terrain palette shows items. Select a
+weapon. If you're not sure which weapon is which, click it and look at the bottom right -
+the item's name will be shown. Then click inside the building. There is now a weapon there
+for the player to find. Now select Gold (the top left icon) and click inside the building.
+There is now some gold there.</p>
 
 <p>You may, however, want to choose how much gold to find. Fortunately, this is easy.
 Press the Edit Item button (first button in the third row), and click on the gold. Enter a
@@ -159,7 +170,7 @@ how to make it possible for the party to enter your towns.</p>
 <p>Press Back To Main Menu, and then press Edit Outdoor Terrain. Scroll the terrain view a
 few spaces north of Warriors Grove. Select the Outdoor Building terrain (in the lower
 right hand corner) and place it somewhere. There's your town. Finally, you need to link it
-to your dungeon. The last button in the second row is the Set Town Entrance button. Press
+to your dungeon. The first button in the second row is the Set Town Entrance button. Press
 it, and then click on your town. You will be asked what town is here. Enter 1 in the text
 area (for town 1, your new town), and press OK. When the party moves onto this town, they
 will find themselves in your new town.</p>