penultima: add some comments to help navigation

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/specs/penultima.game.toml b/specs/penultima.game.toml
index 5833ca1a3f47758422641737663b2053108be1f8..9f21d5e724b38d06330e28b0e6407016e434cdb4 100644 (file)
--- a/specs/penultima.game.toml
+++ b/specs/penultima.game.toml
@@ -11,9 +11,16 @@
  "ship","giraffe","cannon"]
 {% endmacro fairy_pieces -%}
 
+
+# -------------------- actual game spec --------------------
+
+# board
+
 table_size = [300, 200]
 table_colour = "#bbd"
 
+# board and standard pieces, in starting places
+
 [[pieces]]
 pos = [150,100]
 type = "Lib"
@@ -54,6 +61,8 @@ posd = [10, 0]
 count = 8
 
 
+# geometric shapes
+
 [[pieces]]
 pos = [20, 75]
 type = "Disc"
@@ -94,6 +103,9 @@ posd = [5, 0]
 size = [1,9]
 count = 16
 
+
+# spare vanilla pieces
+
 [[pieces]]
 pos = [20,  125]
 type = "LibList"
@@ -126,6 +138,9 @@ item = "chess-b-P"
 posd = [10, 0]
 count = 4
 
+
+# exciting colours
+
 [[pieces]]
 pos = [210, 55]
 type = "LibList"
@@ -158,6 +173,9 @@ prefix = "chess-purple-"
 items = ["K","Q","R","R","B","B","N","N"]
 posd = [10, 0]
 
+
+# fairy pieces
+
 [[pieces]]
 pos = [205, 125]
 type = "LibList"