[coreboot-gerrit] New patch to review for coreboot: util/checklist: Add usage instructions

[Lee Leahy (leroy.p.leahy@intel.com)]

Lee Leahy (leroy.p.leahy at intel.com) just uploaded a new patch set to gerrit, which you can find at https://review.coreboot.org/16036

-gerrit

commit 5ae05201a716f8cdbc39dc13e19f8d15798e1a6d
Author: Lee Leahy <leroy.p.leahy at intel.com>
Date:   Tue Aug 2 08:23:17 2016 -0700

    util/checklist: Add usage instructions
    
    Document how to use the checklist and how to generate the data files.
    
    TEST=Build and run on Amenia
    
    Change-Id: Idffc0683e916cbc5a984028886dc3d89a01d0595
    Signed-off-by: Lee Leahy <leroy.p.leahy at intel.com>
---
 util/checklist/Makefile.inc | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/util/checklist/Makefile.inc b/util/checklist/Makefile.inc
index e400725..f1dff5d 100644
--- a/util/checklist/Makefile.inc
+++ b/util/checklist/Makefile.inc
@@ -14,6 +14,41 @@
 #
 
 ###########################################################################
+# Instructions
+###########################################################################
+#
+# Create new control files for checklist:
+#
+#     1. Remove any selection for CREATE_BOARD_CHECKLIST
+#     2. Remove any selection for MAKE_CHECKLIST_PUBLIC
+#     3. make
+#     4. nm build/cbfs/fallback/<stage>.debug > <stage>_symbols.txt
+#     6. sed 's/^...........//' <stage>_symbols.txt > <stage>_complete.dat
+#     7. grep -F " W " <stage>_symbols.txt | sed 's/^...........//' \
+#             > <stage>_optional.dat
+#     8. Edit <stage>_complete.dat to remove any symbols that are not
+#        desired in the report
+#     9. Edit <stage>_optional.dat to remove any symbols that are
+#        required to be implemented
+#
+# Create a board checklist:
+#
+#     1. select CREATE_BOARD_CHECKLIST
+#     2. Optionally: select MAKE_CHECKLIST_PUBLIC
+#     3. Specify CONFIG_CHECKLIST_DATA_FILE_LOCATION
+#     4. make
+#
+# Build Errors:
+#     * No checklist built - verify CREATE_BOARD_CHECKLIST is selected in
+#           board Kconfig file.  Do a make clean
+#     * <stage>_complete.dat not found - verify that
+#           CONFIG_CHECKLIST_DATA_FILE_LOCATION points to the directory
+#           containing the checklist data files.  Build the checklist
+#           data files if necessary.
+#     * Segmentation fault - most likely caused by $(NM_$(class)) not being
+#           set.
+#
+###########################################################################
 # Build the board implementation checklist
 ###########################################################################
 
@@ -191,7 +226,6 @@ endif
 ifeq ($(CONFIG_POSTCAR_STAGE),y)
 html_table_files += $(objcbfs)/postcar.html
 endif
-html_table_files += $(objcbfs)/romstage.html $(objcbfs)/ramstage.html
 
 #
 # Create a list with each file on a separate line