From 124c418ccf4d0e786d2a5718920bf9cea79a9097 Mon Sep 17 00:00:00 2001 From: Martin Roth Date: Sun, 22 May 2022 19:11:04 -0600 Subject: 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 Reviewed-on: https://review.coreboot.org/c/coreboot/+/64580 Tested-by: build bot (Jenkins) Reviewed-by: Raul Rangel --- util/util_readme/post_util.md | 16 ++++++++++++++++ util/util_readme/util_readme.sh | 20 +++++++++++++++++--- 2 files changed, 33 insertions(+), 3 deletions(-) create mode 100644 util/util_readme/post_util.md (limited to 'util') diff --git a/util/util_readme/post_util.md b/util/util_readme/post_util.md new file mode 100644 index 0000000000..9533cb192a --- /dev/null +++ b/util/util_readme/post_util.md @@ -0,0 +1,16 @@ +## In depth documentation + +* [cbfstool](util/cbfstool/index.md) +* [ifdtool](util/ifdtool/index.md) +* [intelp2m](util/intelp2m/index.md) + +## Generated documentation + +**Please do not edit the markdown file in the documentation directory +*directly.** + +This file was generated by running util_readme.sh. Please make sure it +is rerun when new tools are added or when documentation is updated. + +To update, edit the markdown files in the util directory, then +re-generate this file by running `util/util_readme/util_readme.sh` diff --git a/util/util_readme/util_readme.sh b/util/util_readme/util_readme.sh index af688c4b0d..986c393ca8 100755 --- a/util/util_readme/util_readme.sh +++ b/util/util_readme/util_readme.sh @@ -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" -- cgit v1.2.3