util/util_readme: update to give additional information

Add a note to the top of the util.md document saying not to edit it.

The Documentation/util.md file had been updated to contain additional
information at the bottom.  This copies that information into the file
after it's been created.

Change-Id: I4b08439420ceb706df62e3949406585ea34c1514
Signed-off-by: Martin Roth <gaumless@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/64580
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Raul Rangel <rrangel@chromium.org>
This commit is contained in:
Martin Roth
2022-05-22 19:11:04 -06:00
committed by Martin L Roth
parent 56846091f1
commit 124c418ccf
2 changed files with 33 additions and 3 deletions

View File

@ -10,13 +10,25 @@ UTIL_README_DIR="$(cd "$(dirname "$0")" || exit; pwd -P)"
UTIL_DIR=$(dirname "$UTIL_README_DIR")
COREBOOT_ROOT_DIR=$(dirname "$UTIL_DIR")
DOCMENTATION_DIR="$COREBOOT_ROOT_DIR/Documentation"
SUMMARY="_Scripts and programs found in the \`./util\` directory_"
SUMMARY='
## List of utils
_Scripts and programs found in the coreboot `./util` directory_
'
APPEND_TO_UTIL_MD="${UTIL_README_DIR}/post_util.md"
DESCRIPTION_FILES=$(find "$UTIL_DIR" -name "description.md" | sort)
echo -n "" > "$UTIL_DIR/README.md"
echo "# Utilities" > "$DOCMENTATION_DIR/util.md"
echo "$SUMMARY" >> "$DOCMENTATION_DIR/util.md"
{
echo
echo "[//]: # ( DO NOT EDIT - AUTOGENERATED FILE )";
echo
echo "[//]: # ( RUN 'util/util_readme/util_readme.sh' to regenerate )";
echo;
echo "# Utilities";
echo "${SUMMARY}"
} > "${DOCMENTATION_DIR}/util.md"
for DESC_FILE in $DESCRIPTION_FILES; do
UTIL_NAME=$(echo "$DESC_FILE" | rev | cut -d '/' -f2 | rev)
@ -40,3 +52,5 @@ for DESC_FILE in $DESCRIPTION_FILES; do
echo "$DESC" >> "$UTIL_DIR/README.md"
echo "$DESC" >> "$DOCMENTATION_DIR/util.md"
done
cat "${APPEND_TO_UTIL_MD}" >> "${DOCMENTATION_DIR}/util.md"