From 1ca3dadc99a6859a93fa292dd7ec820e10739c3f Mon Sep 17 00:00:00 2001 From: DTB Date: Wed, 24 Jul 2024 10:50:07 -0600 Subject: [PATCH] README: overgrown --- README | 58 +++------------------------------------------------------- 1 file changed, 3 insertions(+), 55 deletions(-) diff --git a/README b/README index fdb05fb..202f0e3 100644 --- a/README +++ b/README @@ -1,61 +1,9 @@ -“Seek not to walk the path of the masters; seek what they sought.” -– Matsuo Basho +overgrown - trinity's harakit workshop -The Bonsai harakit utilities are a replacement for standard POSIX utilities -which aim to fill its niche while expanding on their capabilities. These new -tools are the result of the careful examination of the current state of POSIX -and Unix utilies. The Unix Philosophy of “do one thing and do it well” are their -core but they avoid clinging to the past. - -The era of the original Unix tools has been long and fruitful, but they have -their flaws. This project originated from frustrations with the way certain -tools work and how other projects that extend POSIX don’t make anything better. - -This project will not follow in the footsteps of GNU; extensions of POSIX will -not be found here. GNU extensions are a gateway to the misuse of the shell. The -harakit utilities will intentionally discourage use of the shell for purposes -beyond its scope. - -See docs/ for more on the specific utilities currently implemented. - -Building - -Harakit utilities require a POSIX-compliant environment to compile, including a -C compiler and preprocessor (cc(1) and cpp(1) by default), an edition 2023 Rust -compiler (rustc(1) by default), bindgen(1), and a POSIX-compliant make(1) -utility. - -To build and install: +simple build, no dependencies except rust +# pkg_add rust rust-bindgen $ make -$ make PREFIX="/your/preferred/location" install - -To build with a different compiler than the default: - -$ make CC=clang -$ make RUSTC=gccrs - -To test the utilities: - -$ make test - -To remove all build and distributable files: - -$ make clean - -Read More - -An Introduction to the Unix Shell - - -Master Foo and the Ten Thousand Lines - - -Master Foo Discourses on the Unix-Nature - - -Shell Programming! - -- Copyright © 2023–2024 Emma Tebibyte