bonsai/harakit
5
4
Fork 3
Code Issues 42 Pull Requests 5 Projects 1 Releases 34 Activity

README: attempt to clarify intent

Browse Source
This commit is contained in:
dtb 2024-07-18 09:32:58 -06:00
parent e90d25e30f
commit cd875df547
Signed by: trinity
GPG Key ID: 34C0543BBB6AF81B
1 changed files with 20 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
README
View File

@ -1,23 +1,29 @@
“Seek not to walk the path of the masters; seek what they sought.” “Seek not to walk the path of the masters; seek what they sought.”
– Matsuo Basho – Matsuo Basho
The Bonsai harakit utilities are a replacement for standard POSIX utilities The Bonsai harakit is an alternative to the standard POSIX utility set that
which aim to fill its niche while expanding on their capabilities. These new aims to be simpler, easier, and more powerful than its counterpart. These tools
tools are the result of the careful examination of the current state of POSIX are the result of careful examination of the current state of POSIX and common
and Unix utilies. The Unix Philosophy of “do one thing and do it well” are their Unix utilities. They represent a vision of accomplishing everyday use cases
core but they avoid clinging to the past. with tools that follow the Unix philosophy of “do one thing and do it well”,
without clinging to the past.
The era of the original Unix tools has been long and fruitful, but they have 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 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. 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 The intent of harakit is not to conform to or extend POSIX, like the GNU or BSD
not be found here. GNU extensions are a gateway to the misuse of the shell. The utilities, but to invent new utilities to perform the same tasks in more
harakit utilities will intentionally discourage use of the shell for purposes intuitive ways. GNU and BSD extensions are convenient but often unhealthy,
beyond its scope. forgetting the purposes of the tools they extend, or building into existing
utilities features that would be more useful as their own tools to be used
anywhere. Whereas other utility sets aim to provide a number of fully-featured
programs to be used individually, harakit tools are meant to be easily
composable and work together in pipelines.
See docs/ for more on the specific utilities currently implemented. See docs/ for more on the specific utilities currently implemented.
Building Building
Harakit utilities require a POSIX-compliant environment to compile, including a Harakit utilities require a POSIX-compliant environment to compile, including a
@ -43,6 +49,7 @@ To remove all build and distributable files:
$ make clean $ make clean
Read More Read More
An Introduction to the Unix Shell An Introduction to the Unix Shell
@ -57,6 +64,10 @@ Master Foo Discourses on the Unix-Nature
Shell Programming! Shell Programming!
<https://tldp.org/LDP/abs/html/why-shell.html> <https://tldp.org/LDP/abs/html/why-shell.html>
UNIX Style, or cat -v Considered Harmful
<http://harmful.cat-v.org/cat-v/>
-- --
Copyright © 2023–2024 Emma Tebibyte <emma@tebibyte.media> Copyright © 2023–2024 Emma Tebibyte <emma@tebibyte.media>
Copyright © 2024 DTB <trinity@trinity.moe> Copyright © 2024 DTB <trinity@trinity.moe>