From f1f5ac1788b4d148b1c783f7389fa20590d24e86 Mon Sep 17 00:00:00 2001 From: DTB Date: Wed, 8 May 2024 08:25:34 -0600 Subject: [PATCH] Bonsix fork --- README | 57 +++++++++++++++++---------------------------------------- 1 file changed, 17 insertions(+), 40 deletions(-) diff --git a/README b/README index accfc7e..e4b14d5 100644 --- a/README +++ b/README @@ -1,27 +1,27 @@ -“Seek not to walk the path of the masters; seek what they sought.” -– Matsuo Basho +For the Bonsai coreutils, a better Unix toolset, please visit +. -The Bonsai core utilities are the result of the careful examination of the -current state of POSIX and Unix utilies. The Unix Philosophy, “do one thing and -do it well” is its core but these tools do not cling to the names of the past. + wwwww / + wWWWWWw /_ _____ _ * "It's not a very good tree, but + w|||w / \/ \ / | /\ / /|/ occasionally it bears fruit!" + _,|||._ _/\__/|__// /_/_|_/_//|__ + bonsix : "BOHN zix" : "Bonsai" but "POSIX" -The era of the original Unix tools has been long and fruitful, but they have -their flaws. The new, non-POSIX era of this project started with frustration -with the way certain tools work and how other projects that extend POSIX don’t -make anything better. +The excellent Bonsai core utilities are the result of the careful examination +of the current state of POSIX and Unix utilities, ironing out wrinkles in the +implementations that ended up being worn by the POSIX standard. Bonsai's +guiding quote is this one from Matsuo Basho: -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 -Bonsai core utilities will intentionally discourage use of the shell for -purposes beyond its scope. +"Seek not to walk the path of the masters; seek what they sought." -See docs/ for more on the specific utilities currently implemented. +Unlike Bonsai, Bonsix intends to walk the path of the masters, implementing a +POSIX userland under an AGPLv3 license and taking inspiration from the +practices used by Bonsai. Building -The coreutils require a POSIX-compliant environment to compile, including a C -compiler and preprocessor (cc(1) and cpp(1) by default) with the -idirafter -flag, a Rust compiler (rustc(1) by default), bindgen(1), and a POSIX-compliant +Bonsix requires an existing POSIX-compliant environment to compile, including a +C compiler and preprocessor (cc(1) and cpp(1) by default) and a POSIX-compliant make(1) utility. To build and install: @@ -32,29 +32,6 @@ $ 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 untracked 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