diff --git a/util/checklist/Makefile.inc b/util/checklist/Makefile.inc index e400725609..be872b0118 100644 --- a/util/checklist/Makefile.inc +++ b/util/checklist/Makefile.inc @@ -13,6 +13,41 @@ # GNU General Public License for more details. # +########################################################################### +# 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/.debug > _symbols.txt +# 6. sed 's/^...........//' _symbols.txt > _complete.dat +# 7. grep -F " W " _symbols.txt | sed 's/^...........//' \ +# > _optional.dat +# 8. Edit _complete.dat to remove any symbols that are not +# desired in the report +# 9. Edit _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 +# * _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 ###########################################################################