From 9b945c7cd8a5cc7dab9fdded8172cd575b6129c9 Mon Sep 17 00:00:00 2001
From: "Steven J. Magnani" <steve@digidescorp.com>
Date: Mon, 12 Sep 2005 18:40:00 +0000
Subject: [PATCH] Attempt to make comments more descriptive.

git-svn-id: svn://svn.coreboot.org/coreboot/trunk@2023 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
---
 src/config/Options.lb | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/config/Options.lb b/src/config/Options.lb
index bf7faf5d55..54def7ffef 100644
--- a/src/config/Options.lb
+++ b/src/config/Options.lb
@@ -188,37 +188,37 @@ define FALLBACK_SIZE
 	default 65536
 	format "0x%x"
 	export used
-	comment "Default fallback image size"
+	comment "ROM_SECTION_SIZE to use for the fallback build."
 end
 define ROM_SIZE
 	default none
 	format "0x%x"
 	export used
-	comment "Size of your ROM"
+	comment "Total number of bytes allocated for normal and fallback LinuxBIOS images and payloads. Note that the fallback image goes at the end of the ROM, and the normal image at the beginning."
 end
 define ROM_IMAGE_SIZE
 	default 65535
 	format "0x%x"
 	export always
-	comment "Default image size"
+	comment "Maximum number of bytes allowed for a LinuxBIOS image. Does not include the payload."
 end
 define ROM_SECTION_SIZE
 	default {FALLBACK_SIZE}
 	format "0x%x"
 	export used
-	comment "Default rom section size"
+	comment "Default rom section size. Normally, this is calculated in mainboard Config.lb and varies between the normal and fallback builds."
 end
 define ROM_SECTION_OFFSET
 	default {ROM_SIZE - FALLBACK_SIZE}
 	format "0x%x"
 	export used
-	comment "Default rom section offset"
+	comment "Number of bytes from the beginning of the ROM to the start of the section containing this build (normal or fallback). Normally, this is calculated in mainboard Config.lb."
 end
 define PAYLOAD_SIZE
 	default {ROM_SECTION_SIZE - ROM_IMAGE_SIZE}
 	format "0x%x"
 	export always
-	comment "Default payload size"
+	comment "Maximum number of bytes allowed for a payload. Normally, this is calculated as above."
 end
 define _ROMBASE
 	default {PAYLOAD_SIZE}
@@ -533,7 +533,7 @@ define CONFIG_ROM_STREAM_START
 	default {0xffffffff - ROM_SIZE + ROM_SECTION_OFFSET + 1}
 	format "0x%x"
 	export always
-	comment "ROM stream start location"
+	comment "Memory address of this (normal or fallback) build's payload in ROM. Normally, this is calculated as above."
 end
 define CONFIG_FS_STREAM
 	default 0