05400b7a2f
util/util_readme/util_readme.sh is specifically a bash script and requires bash-specific features such as "[[". It doesn't work when run with a "sh" shell that only implements POSIX features, such as dash. Thus, tell the user to run the script directly, in which case the #! line is used. Change-Id: I5706ffe857c5a148e9776571a377ad8647f9a4c2 Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net> Reviewed-on: https://review.coreboot.org/c/30162 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Patrick Georgi <pgeorgi@google.com>
42 lines
1.3 KiB
Bash
Executable file
42 lines
1.3 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
|
|
# Creates `./util/README.md` and `./Documentation/Util.md` of description files
|
|
# in `./util` subdirectories
|
|
#
|
|
# Execute from root of project. Example:
|
|
# `util/util_readme/util_readme.sh`
|
|
|
|
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_"
|
|
|
|
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"
|
|
|
|
for DESC_FILE in $DESCRIPTION_FILES; do
|
|
UTIL_NAME=$(echo "$DESC_FILE" | rev | cut -d '/' -f2 | rev)
|
|
DESC=$(cat "$DESC_FILE")
|
|
|
|
if [[ $DESC == "__"${UTIL_NAME}* || $DESC == "__["${UTIL_NAME}* ]]; then
|
|
DESC="* $DESC"
|
|
else
|
|
DESC="* __${UTIL_NAME}__ - $DESC"
|
|
fi
|
|
|
|
# format description to under 72 characters per line and only
|
|
# breaking on whitespace
|
|
DESC=$(echo "$DESC" \
|
|
| tr '\r\n' ' ' \
|
|
| sed 's/ [*]\+/\n\t\*/g' \
|
|
| sed 's/ \+/ /g' \
|
|
| fold -s -w72 \
|
|
| sed 's/\s*$//')
|
|
|
|
echo "$DESC" >> "$UTIL_DIR/README.md"
|
|
echo "$DESC" >> "$DOCMENTATION_DIR/util.md"
|
|
done
|