mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 02:54:26 +00:00
kevinveenbirkenbachandClaude Opus 5
5137465c6f
3529 invalid comments in 528 files, grandfathered in while the linter only saw the working-tree diff. Removal ran through the linter's own collectors, so detection and deletion cannot drift: a comment whose opener line is blank before it and whose closer line is blank after it loses all its lines, anything else loses only the comment region, and a line left holding a bare delimiter goes with it. Five files keep their comments behind a nocheck marker instead. Four are upstream configs whose inline docs are upstream's own (mautrix, systemd journald, nextcloud-oidc-login, MediaWiki). In littlejs the commented-out entries ARE the deactivation mechanism for an example tile, so deleting them would delete configuration. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
111 lines
2.7 KiB
Bash
Executable File
111 lines
2.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Print Make targets with their descriptions.
|
|
#
|
|
# Without arguments: short list — one description line per target. The
|
|
# description is the topmost comment line in each target's comment block.
|
|
#
|
|
# With a single argument: print the full comment block for that target —
|
|
# the description line plus its schema lines (Usage:, Example:, Note:,
|
|
# Param <name>:). See tests/lint/filesystem/makefile/test_single_line_comments.py
|
|
# for the canonical schema.
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
REPO_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
|
|
MAKEFILE="${REPO_ROOT}/Makefile"
|
|
|
|
if [[ ! -f "${MAKEFILE}" ]]; then
|
|
echo "make help: Makefile not found at ${MAKEFILE}" >&2
|
|
exit 1
|
|
fi
|
|
|
|
if [[ -t 1 ]]; then
|
|
C_BOLD=$'\033[1m'
|
|
C_CYAN=$'\033[36m'
|
|
C_GREEN=$'\033[32m'
|
|
C_DIM=$'\033[2m'
|
|
C_RESET=$'\033[0m'
|
|
else
|
|
C_BOLD=""
|
|
C_CYAN=""
|
|
C_GREEN=""
|
|
C_DIM=""
|
|
C_RESET=""
|
|
fi
|
|
|
|
if [[ $# -ge 1 && -n "$1" ]]; then
|
|
target="$1"
|
|
awk -v want="${target}" -v g="${C_GREEN}" -v b="${C_BOLD}" -v d="${C_DIM}" -v r="${C_RESET}" '
|
|
/^[[:space:]]*#[[:space:]]*nocheck[[:space:]]*:/ { next }
|
|
/^#/ {
|
|
line = $0
|
|
sub(/^#[[:space:]]?/, "", line)
|
|
block[++n] = line
|
|
next
|
|
}
|
|
/^\.[A-Za-z]/ { next }
|
|
/^[[:space:]]*$/ { n = 0; next }
|
|
/^[A-Za-z][A-Za-z0-9_.-]*:/ && !/:=/ && !/[?+]=/ {
|
|
t = $0
|
|
sub(/:.*$/, "", t)
|
|
if (t == want) {
|
|
printf "%s%s%s\n", b g, t, r
|
|
if (n >= 1) {
|
|
printf " %s\n", block[1]
|
|
for (i = 2; i <= n; i++) {
|
|
printf " %s%s%s\n", d, block[i], r
|
|
}
|
|
}
|
|
found = 1
|
|
exit 0
|
|
}
|
|
n = 0
|
|
next
|
|
}
|
|
/^[[:space:]]/ { next }
|
|
{ n = 0 }
|
|
END {
|
|
if (!found) {
|
|
printf "make help: target %s%s%s not found in Makefile\n", b, want, r > "/dev/stderr"
|
|
exit 1
|
|
}
|
|
}
|
|
' "${MAKEFILE}"
|
|
exit $?
|
|
fi
|
|
|
|
printf '\n%sInfinito.Nexus Make targets%s\n' "${C_BOLD}${C_CYAN}" "${C_RESET}"
|
|
# shellcheck disable=SC2016 # backticks are literal text in the rendered help banner
|
|
printf '%sUsage: make <target> (or `make help target=<target>` for details)%s\n\n' "${C_DIM}" "${C_RESET}"
|
|
|
|
awk '
|
|
/^[[:space:]]*#[[:space:]]*nocheck[[:space:]]*:/ { next }
|
|
/^#/ {
|
|
line = $0
|
|
sub(/^#[[:space:]]?/, "", line)
|
|
block[++n] = line
|
|
next
|
|
}
|
|
/^\.[A-Za-z]/ { next }
|
|
/^[[:space:]]*$/ { n = 0; next }
|
|
/^[A-Za-z][A-Za-z0-9_.-]*:/ && !/:=/ && !/[?+]=/ {
|
|
target = $0
|
|
sub(/:.*$/, "", target)
|
|
if (!seen[target]++) {
|
|
printf "%s\t%s\n", target, (n >= 1 ? block[1] : "-")
|
|
}
|
|
n = 0
|
|
next
|
|
}
|
|
/^[[:space:]]/ { next }
|
|
{ n = 0 }
|
|
' "${MAKEFILE}" |
|
|
sort |
|
|
awk -F'\t' -v g="${C_GREEN}" -v d="${C_DIM}" -v r="${C_RESET}" '
|
|
{ printf " %s%-32s%s %s%s%s\n", g, $1, r, d, $2, r }
|
|
'
|
|
|
|
printf '\n'
|
|
|
|
printf '%sDocumentation:%s %s%s\n\n' "${C_BOLD}" "${C_RESET}" "${C_CYAN}https://docs.infinito.nexus${C_RESET}" ""
|