suckless
/
sbase
mirror of git://git.suckless.org/sbase
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
sbase/README

121 lines
5.7 KiB
Plaintext
Raw Normal View History

Add initial README
2014-02-12 14:34:09 +00:00
sbase - suckless unix tools
===========================
sbase is a collection of unix tools that are inherently portable
across UNIX and UNIX-like systems.
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
The following tools are implemented ('*' == finished, '#' == UTF-8 support,
'=' == implicit UTF-8 support):
Add an easier to edit "table" of tools in README We need to go through the tools and update this table to reflect current state.
2014-11-20 23:01:56 +00:00
Also indent the headings
2015-01-18 18:41:14 +00:00
UTILITY POSIX 2008 COMPLIANT MISSING OPTIONS
------- -------------------- ---------------
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
=* basename yes none
=* cal yes none
=* cat yes none
= chgrp no -h, -H, -L, -P
=* chmod yes none
= chown no -h, -H, -L, -P
= chroot non-posix none
=* cksum yes none
Mark non-UTF8-tools as non-finished This makes clearer that these tools might require some more work.
2015-01-23 22:00:20 +00:00
cmp yes none
cols non-posix none
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
=* comm yes none
Mark insane POSIX flags which we are not planning to include into sbase. What's left to discuss is how we're going to handle them in the tools (dump usage() or silently ignore them).
2015-01-23 22:31:46 +00:00
= cp no -H, (-i), -L
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
=* cron non-posix none
Add UTF-8-delimiter-support to cut(1) Now you can specify a multibyte-delimiter to cut, which should definitely be possible for the end-user (Fuck POSIX). Looking at GNU/coreutils' cut(1)[0], which basically ignores the difference between characters and bytes, the -n-option and which is bloated as hell, one has to wonder why they are still default. This is insane! Things like this personally keep me motivated to make sbase better every day. [0]: http://git.savannah.gnu.org/gitweb/?p=coreutils.git;a=blob;f=src/cut.c;hb=HEAD NSFW! You have been warned.
2015-01-22 11:32:50 +00:00
#* cut yes none
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README.
2015-01-23 21:54:25 +00:00
=* date yes none
Add mandoc-manpage for dirname(1) and mark it as finished in the README.
2015-01-23 22:17:54 +00:00
=* dirname yes none
Mark insane POSIX flags which we are not planning to include into sbase. What's left to discuss is how we're going to handle them in the tools (dump usage() or silently ignore them).
2015-01-23 22:31:46 +00:00
= du no -H, -L, (-x)
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
= echo yes none
= env yes none
# expand yes none
expr yes none
=* false yes none
fold yes none
Mark non-UTF8-tools as non-finished This makes clearer that these tools might require some more work.
2015-01-23 22:00:20 +00:00
grep yes none
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
head yes none
= hostname non-posix none
=* kill yes none
= link yes none
= ln yes none
=* logger yes none
= logname yes none
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
= ls no -C, -R, -q, -u
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
md5sum non-posix none
= mkdir yes none
= mkfifo yes none
= mktemp non-posix none
Mark insane POSIX flags which we are not planning to include into sbase. What's left to discuss is how we're going to handle them in the tools (dump usage() or silently ignore them).
2015-01-23 22:31:46 +00:00
= mv yes (-i)
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
= nice yes none
= nl no -d, -f, -h, -l, -n, -p, -v, -w
= nohup yes none
paste yes none
= printenv non-posix none
printf stolen stolen
=* pwd yes none
= readlink non-posix none
= renice yes none
Mark insane POSIX flags which we are not planning to include into sbase. What's left to discuss is how we're going to handle them in the tools (dump usage() or silently ignore them).
2015-01-23 22:31:46 +00:00
= rm yes (-i)
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
= rmdir no -p
= sleep yes none
= setsid non-posix none
sort no -m, -o, -d, -f, -i
split yes none
= sponge non-posix none
strings no -a, -n, -t
= sync non-posix none
= tail no -c, -f
= tar non-posix none
Mark tee(1) as finished in the README
2015-01-23 21:04:19 +00:00
=* tee yes none
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
test yes none
Update README for touch
2015-01-20 11:22:09 +00:00
= touch no -r
Add column to mark UTF-8 support One major milestone is to have the sbase-tools supporting UTF-8. Tools like cut(1) with the -n flag don't make sense otherwise. And while the gnu coreutils cut(1) blatantly ignores such an important aspect, we will not tolerate this madness and mark it as a TODO in the main README. Since most tools inherently support UTF-8 anyway, this just concerns tools which mangle with text or search in it in special ways.
2015-01-18 18:36:13 +00:00
#* tr yes none
=* true yes none
= tty yes none
= uudecode no -o
= uuencode no -m
= uname yes none
# unexpand yes none
= uniq no -f, -s
= unlink yes none
seq non-posix none
= sha1sum non-posix none
= sha256sum non-posix none
= sha512sum non-posix none
wc yes none
= xargs no -I, -L, -p, -s, -t, -x
= yes yes none
Add an easier to edit "table" of tools in README We need to go through the tools and update this table to reflect current state.
2014-11-20 23:01:56 +00:00
Minor fix for README
2014-02-12 18:39:13 +00:00
The complement of sbase is ubase[1] which is Linux-specific and
Add initial README
2014-02-12 14:34:09 +00:00
provides all the non-portable tools. Together they are intended to
form a base system similar to busybox but much smaller and suckless.
Building
--------
Update note on building sbase on OpenBSD
2014-11-21 10:36:42 +00:00
You need GNU make to build sbase on OpenBSD.
Require GNU make to build sbase We seem to have problems building individual tools across various make implementations. If anyone can step up and fix this we will remove the dependency on GNU make.
2014-11-17 13:50:19 +00:00
Add initial README
2014-02-12 14:34:09 +00:00
To build sbase, simply type make. You may have to fiddle with
config.mk depending on your system.
You can also build sbase-box, which generates a single binary
containing all the required tools. You can then symlink the
individual tools to sbase-box.
Ideally you will want to statically link sbase. If you are on Linux
we recommend using musl-libc[2].
Portability
-----------
sbase has been compiled on a variety of different operating systems,
including Linux, *BSD, OSX, Haiku, Solaris, SCO OpenServer and others.
Various combinations of operating systems and architectures have also
been built.
You can build sbase with gcc, clang, tcc, nwcc and pcc.
[1] http://git.suckless.org/ubase/
[2] http://www.musl-libc.org/