Document constants with comments, actual names, and more thorough usage

constants/deco_constants.asm

@@ -1,3 +1,4 @@
+; decoration types
 const_value = 1
 	const DECO_PLANT
 	const DECO_BED
@@ -6,6 +7,7 @@ const_value = 1
 	const DECO_DOLL
 	const DECO_BIGDOLL
 
+; DecorationNames indexes (see engine/decorations.asm)
 const_value = 1
 	const PUT_IT_AWAY
 	const MAGNAPLANT
@@ -33,6 +35,7 @@ const_value = 1
 	const YELLOW_CARPET
 	const GREEN_CARPET
 
+; DoDecorationAction2 arguments (see engine/decorations.asm)
 const_value = 1
 	const SET_UP_BED
 	const PUT_AWAY_BED
@@ -56,66 +59,67 @@ deco: MACRO
 	enum DECOFLAG_\1
 endm
 
+; decorations
 const_value = 1
 __enum__ = 0
 	const BEDS
-	deco  FEATHERY_BED ; 2 (0)
-	deco  PINK_BED ; 3 (1)
-	deco  POLKADOT_BED ; 4 (2)
-	deco  PIKACHU_BED ; 5 (3)
+	deco  FEATHERY_BED
+	deco  PINK_BED
+	deco  POLKADOT_BED
+	deco  PIKACHU_BED
 
 	const CARPETS
-	deco  RED_CARPET ; 7 (4)
-	deco  BLUE_CARPET ; 8 (5)
-	deco  YELLOW_CARPET ; 9 (6)
-	deco  GREEN_CARPET ; a (7)
+	deco  RED_CARPET
+	deco  BLUE_CARPET
+	deco  YELLOW_CARPET
+	deco  GREEN_CARPET
 
 	const PLANTS
-	deco  MAGNAPLANT ; c (8)
-	deco  TROPICPLANT ; d (9)
-	deco  JUMBOPLANT ; e (a)
+	deco  MAGNAPLANT
+	deco  TROPICPLANT
+	deco  JUMBOPLANT
 
 	const POSTERS
-	deco  TOWN_MAP ; 10 (b)
-	deco  PIKACHU_POSTER ; 11 (c)
-	deco  CLEFAIRY_POSTER ; 12 (d)
-	deco  JIGGLYPUFF_POSTER ; 13(e)
+	deco  TOWN_MAP
+	deco  PIKACHU_POSTER
+	deco  CLEFAIRY_POSTER
+	deco  JIGGLYPUFF_POSTER
 
 	const CONSOLES
-	deco  FAMICOM ; 15 (f)
-	deco  SNES ; 16 (10)
-	deco  N64 ; 17 (11)
-	deco  VIRTUAL_BOY ; 18 (12)
+	deco  FAMICOM
+	deco  SNES
+	deco  N64
+	deco  VIRTUAL_BOY
 
 	const BIG_DOLLS
-	deco  BIG_SNORLAX_DOLL ; 1a (13)
-	deco  BIG_ONIX_DOLL ; 1b (14)
-	deco  BIG_LAPRAS_DOLL ; 1c (15)
+	deco  BIG_SNORLAX_DOLL
+	deco  BIG_ONIX_DOLL
+	deco  BIG_LAPRAS_DOLL
 
 	const DOLLS
-	deco  PIKACHU_DOLL ; 1e (16)
-	deco  SURF_PIKACHU_DOLL ; 1f (17)
-	deco  CLEFAIRY_DOLL ; 20 (18)
-	deco  JIGGLYPUFF_DOLL ; 21 (19)
-	deco  BULBASAUR_DOLL ; 22 (1a)
-	deco  CHARMANDER_DOLL ; 23 (1b)
-	deco  SQUIRTLE_DOLL ; 24 (1c)
-	deco  POLIWAG_DOLL ; 25 (1d)
-	deco  DIGLETT_DOLL ; 26 (1e)
-	deco  STARMIE_DOLL ; 27 (1f)
-	deco  MAGIKARP_DOLL ; 28 (20)
-	deco  ODDISH_DOLL ; 29 (21)
-	deco  GENGAR_DOLL ; 2a (22)
-	deco  SHELLDER_DOLL ; 2b (23)
-	deco  GRIMER_DOLL ; 2c (24)
-	deco  VOLTORB_DOLL ; 2d (25)
-	deco  WEEDLE_DOLL ; 2e (26)
-	deco  UNOWN_DOLL ; 2f (27)
-	deco  GEODUDE_DOLL ; 30 (28)
-	deco  MACHOP_DOLL ; 31 (29)
-	deco  TENTACOOL_DOLL ; 32 (2a)
-	deco  GOLD_TROPHY_DOLL ; 33 (2b)
-	deco  SILVER_TROPHY_DOLL ; 34 (2c)
+	deco  PIKACHU_DOLL
+	deco  SURF_PIKACHU_DOLL
+	deco  CLEFAIRY_DOLL
+	deco  JIGGLYPUFF_DOLL
+	deco  BULBASAUR_DOLL
+	deco  CHARMANDER_DOLL
+	deco  SQUIRTLE_DOLL
+	deco  POLIWAG_DOLL
+	deco  DIGLETT_DOLL
+	deco  STARMIE_DOLL
+	deco  MAGIKARP_DOLL
+	deco  ODDISH_DOLL
+	deco  GENGAR_DOLL
+	deco  SHELLDER_DOLL
+	deco  GRIMER_DOLL
+	deco  VOLTORB_DOLL
+	deco  WEEDLE_DOLL
+	deco  UNOWN_DOLL
+	deco  GEODUDE_DOLL
+	deco  MACHOP_DOLL
+	deco  TENTACOOL_DOLL
+	deco  GOLD_TROPHY_DOLL
+	deco  SILVER_TROPHY_DOLL
 
-NUM_NON_TROPHY_DECOS EQU $2b
-NUM_DECOS EQU $2d
+NUM_DECOS = __enum__
+NUM_NON_TROPHY_DECOS = NUM_DECOS +- 2