From 7118be39cbde3740f72accfa546ec1ef02d1ca8e Mon Sep 17 00:00:00 2001 From: David Faulkner Date: Thu, 6 Aug 2026 21:50:03 -0500 Subject: docs(readme): update dependencies, features, and log tailing docs for v1.2.0 - remove sed from system dependencies list - highlight POSIX dirent.h file inspection and native C stream formatting - document non-interactive tailing of last 100 log lines when $PAGER is unset --- README.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 22edd53..3db1016 100644 --- a/README.md +++ b/README.md @@ -6,12 +6,12 @@ A clean, minimalist, robust C utility designed to automate Debian-based Linux sy - **Automated APT Maintenance:** Updates repository indices, checks for upgradeable packages, and runs `apt full-upgrade` only when updates exist. - **Dependency & Cache Cleanup:** Automatically purges unused dependencies and lingering configuration files (`apt autoremove --purge`) and empties cached installer packages (`apt clean`). -- **User Cache Housekeeping:** Safely cleans desktop thumbnail caches and user screenshot directories without failing if the directories are empty. +- **User Cache Housekeeping:** Safely cleans desktop thumbnail caches and user screenshot directories using native POSIX directory APIs (`dirent.h`). - **Persistent Summary Logging:** Automatically writes session timestamps and task completion metrics (item counts purged/deleted) to `~/.local/state/ud/ud.log` following XDG Base Directory standards. -- **CLI Management Flags:** Built-in option parsing (`getopt_long`) to view logs with your system `$PAGER`, clear log files, or inspect utility version information. -- **Robust POSIX C Implementation:** Built using standard C (`-std=c11`, POSIX 2008) with explicit bounds checking on formatted buffers and POSIX exit status inspection (`WIFEXITED`, `WEXITSTATUS`). +- **CLI Management Flags:** Built-in option parsing (`getopt_long`) to view persistent logs, clear log files, or inspect utility version information. When `$PAGER` is unset, viewing logs streams the last 100 lines non-interactively directly to standard output. +- **High-Performance POSIX C Implementation:** Built using standard C (`-std=c11`, POSIX 2008) with zero external process forks for filesystem operations or stream formatting, alongside explicit bounds checking on formatted buffers. - **Hardened & Optimized Build:** Compiled with `-O3`, `-flto`, `-march=native`, stack protection (`-fstack-protector-strong`), runtime buffer fortification (`-D_FORTIFY_SOURCE=2`), and strict warning checks (`-Wall -Wextra -Wpedantic -Werror`). -- **Clean Terminal Output:** Indents subprocess output using `sed` for a clear, readable terminal log. +- **Clean Terminal Output:** Natively indents subprocess output streams in C without invoking external piping utilities. --- @@ -22,7 +22,6 @@ This utility requires a **Debian-based distribution** (Debian, Ubuntu, Linux Min - `gcc` or `clang` - `make` - `apt` -- `sed` - `sudo` privileges for package management operations --- -- cgit v1.2.3