2023-12-24 17:13:17 -07:00
|
|
|
|
“Seek not to walk the path of the masters; seek what they sought.”
|
|
|
|
|
|
– Matsuo Basho
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
See docs/ for more on the specific utilities currently implemented.
|
|
|
|
|
|
|
2024-02-07 21:27:43 -07:00
|
|
|
|
Building
|
|
|
|
|
|
|
|
|
|
|
|
The coreutils require minimal dependencies for building:
|
|
|
|
|
|
|
2024-02-07 21:38:32 -07:00
|
|
|
|
· bindgen(1)
|
|
|
|
|
|
· cc(1) with -idirafter
|
|
|
|
|
|
· cp(1p)
|
|
|
|
|
|
· make(1p)
|
|
|
|
|
|
· mkdir(1p)
|
|
|
|
|
|
· rustc(1) or equivalent
|
|
|
|
|
|
· sh(1p)
|
2024-02-07 21:27:43 -07:00
|
|
|
|
|
|
|
|
|
|
To build and install:
|
|
|
|
|
|
|
|
|
|
|
|
$ make
|
|
|
|
|
|
$ make PREFIX="/your/preferred/location" install
|
|
|
|
|
|
|
|
|
|
|
|
To build with a different compiler than the default:
|
|
|
|
|
|
|
|
|
|
|
|
$ make CC=clang # different C compiler than cc(1)
|
|
|
|
|
|
$ make RUSTC=gccrs # different Rust compiler than rustc(1)
|
|
|
|
|
|
|
|
|
|
|
|
To test the utilities:
|
|
|
|
|
|
|
|
|
|
|
|
$ make test
|
|
|
|
|
|
|
|
|
|
|
|
To remove all untracked files:
|
|
|
|
|
|
|
|
|
|
|
|
$ make clean
|
|
|
|
|
|
|
2023-12-24 17:13:17 -07:00
|
|
|
|
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>
|
2024-02-07 21:27:43 -07:00
|
|
|
|
|
|
|
|
|
|
--
|
|
|
|
|
|
This work © 2023–2024 by Emma Tebibyte is licensed under CC BY-SA 4.0. To view a
|
|
|
|
|
|
copy of this license, visit <http://creativecommons.org/licenses/by-sa/4.0/>
|
