forked from bonsai/harakit
Bonsix fork
This commit is contained in:
parent
7f59c3b617
commit
f1f5ac1788
57
README
57
README
@ -1,27 +1,27 @@
|
|||||||
“Seek not to walk the path of the masters; seek what they sought.”
|
For the Bonsai coreutils, a better Unix toolset, please visit
|
||||||
– Matsuo Basho
|
<https://git.tebibyte.media/bonsai/coreutils>.
|
||||||
|
|
||||||
The Bonsai core utilities are the result of the careful examination of the
|
wwwww /
|
||||||
current state of POSIX and Unix utilies. The Unix Philosophy, “do one thing and
|
wWWWWWw /_ _____ _ * "It's not a very good tree, but
|
||||||
do it well” is its core but these tools do not cling to the names of the past.
|
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
|
The excellent Bonsai core utilities are the result of the careful examination
|
||||||
their flaws. The new, non-POSIX era of this project started with frustration
|
of the current state of POSIX and Unix utilities, ironing out wrinkles in the
|
||||||
with the way certain tools work and how other projects that extend POSIX don’t
|
implementations that ended up being worn by the POSIX standard. Bonsai's
|
||||||
make anything better.
|
guiding quote is this one from Matsuo Basho:
|
||||||
|
|
||||||
This project will not follow in the footsteps of GNU; extensions of POSIX will
|
"Seek not to walk the path of the masters; seek what they sought."
|
||||||
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.
|
|
||||||
|
|
||||||
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
|
Building
|
||||||
|
|
||||||
The coreutils require a POSIX-compliant environment to compile, including a C
|
Bonsix requires an existing POSIX-compliant environment to compile, including a
|
||||||
compiler and preprocessor (cc(1) and cpp(1) by default) with the -idirafter
|
C compiler and preprocessor (cc(1) and cpp(1) by default) and a POSIX-compliant
|
||||||
flag, a Rust compiler (rustc(1) by default), bindgen(1), and a POSIX-compliant
|
|
||||||
make(1) utility.
|
make(1) utility.
|
||||||
|
|
||||||
To build and install:
|
To build and install:
|
||||||
@ -32,29 +32,6 @@ $ make PREFIX="/your/preferred/location" install
|
|||||||
To build with a different compiler than the default:
|
To build with a different compiler than the default:
|
||||||
|
|
||||||
$ make CC=clang
|
$ 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
|
|
||||||
<https://porkmail.org/era/unix/shell>
|
|
||||||
|
|
||||||
Master Foo and the Ten Thousand Lines
|
|
||||||
<http://www.catb.org/~esr/writings/unix-koans/ten-thousand.html>
|
|
||||||
|
|
||||||
Master Foo Discourses on the Unix-Nature
|
|
||||||
<http://www.catb.org/~esr/writings/unix-koans/unix-nature.html>
|
|
||||||
|
|
||||||
Shell Programming!
|
|
||||||
<https://tldp.org/LDP/abs/html/why-shell.html>
|
|
||||||
|
|
||||||
--
|
--
|
||||||
Copyright © 2023–2024 Emma Tebibyte <emma@tebibyte.media>
|
Copyright © 2023–2024 Emma Tebibyte <emma@tebibyte.media>
|
||||||
|
Loading…
Reference in New Issue
Block a user