sbase/README

sbase - suckless unix tools
===========================

sbase  is a  collection of  unix  tools that  are inherently  portable
across UNIX and UNIX-like systems.

The following tools are implemented ('*' == finished, '#' == UTF-8 support,
'=' == implicit UTF-8 support):

   UTILITY         POSIX 2008 COMPLIANT         MISSING OPTIONS
   -------         --------------------         ---------------
=* basename        yes                          none
=* cal             yes                          none
=* cat             yes                          none
=  chgrp           no                           -h
=* chmod           yes                          none
=  chown           no                           -h
=* chroot          non-posix                    none
=* cksum           yes                          none
=* cmp             yes                          none
#* cols            non-posix                    none
=* comm            yes                          none
=  cp              yes                          none (-i)
=* cron            non-posix                    none
#* cut             yes                          none
=* date            yes                          none
=* dirname         yes                          none
=  du              yes                          none (-x)
=* echo            yes                          none
=* env             yes                          none
#* expand          yes                          none
=* expr            yes                          none
=* false           yes                          none
#* fold            yes                          none
=* grep            yes                          none
=* head            yes                          none
=* hostname        non-posix                    none
=* kill            yes                          none
=* link            yes                          none
=* ln              yes                          none
=* logger          yes                          none
=* logname         yes                          none
=  ls              no                           -C, -R, -q, -u
=* md5sum          non-posix                    none
=* mkdir           yes                          none
=* mkfifo          yes                          none
=* mktemp          non-posix                    none
=* mv              yes                          none (-i)
=* 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                    -e
=* renice          yes                          none
=* rm              yes                          none (-i)
=* rmdir           yes                          none
#  sed
   seq             non-posix                    none
=* setsid          non-posix                    none
=  sha1sum         non-posix                    none
=  sha256sum       non-posix                    none
=  sha512sum       non-posix                    none
=* sleep           yes                          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            yes                          none
=* tar             non-posix                    none
=* tee             yes                          none
#* test            yes                          none
=* touch           yes                          none
#* tr              yes                          none
=* true            yes                          none
=* tty             yes                          none
=* uname           yes                          none
#* unexpand        yes                          none
=  uniq            no                           none
=* unlink          yes                          none
=  uudecode        no                           -o
=  uuencode        no                           -m
#* wc              yes                          none
=  xargs           no                           -I, -L, -p, -s, -t, -x
=* yes             non-posix                    none

The  complement of  sbase  is  ubase[1] which  is  Linux-specific  and
provides all  the non-portable tools.   Together they are  intended to
form a base system similar to busybox but much smaller and suckless.

Building
--------

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/
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
Reformat README 2015-02-08 23:20:33 +00:00			`UTILITY POSIX 2008 COMPLIANT MISSING OPTIONS`
			`------- -------------------- ---------------`
			`=* basename yes none`
			`=* cal yes none`
			`=* cat yes none`
Update README reflecting recent changes to the codebase 2015-02-09 23:53:48 +00:00			`= chgrp no -h`
Reformat README 2015-02-08 23:20:33 +00:00			`=* chmod yes none`
Update README reflecting recent changes to the codebase 2015-02-09 23:53:48 +00:00			`= chown no -h`
Reformat README 2015-02-08 23:20:33 +00:00			`=* chroot non-posix none`
			`=* cksum yes none`
			`=* cmp yes none`
			`#* cols non-posix none`
			`=* comm yes none`
Update README reflecting recent changes to the codebase 2015-02-09 23:53:48 +00:00			`= cp yes none (-i)`
Reformat README 2015-02-08 23:20:33 +00:00			`=* cron non-posix none`
			`#* cut yes none`
			`=* date yes none`
			`=* dirname yes none`
Update README reflecting recent changes to the codebase 2015-02-09 23:53:48 +00:00			`= du yes none (-x)`
Reformat README 2015-02-08 23:20:33 +00:00			`=* echo yes none`
			`=* env yes none`
			`#* expand yes none`
			`=* expr yes none`
			`=* false yes none`
			`#* fold yes none`
			`=* grep yes none`
			`=* head yes none`
			`=* hostname non-posix none`
			`=* kill yes none`
			`=* link yes none`
			`=* ln yes none`
			`=* logger yes none`
			`=* logname yes none`
			`= ls no -C, -R, -q, -u`
			`=* md5sum non-posix none`
			`=* mkdir yes none`
			`=* mkfifo yes none`
			`=* mktemp non-posix none`
			`=* mv yes none (-i)`
			`=* 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`
Update README 2015-02-11 10:54:17 +00:00			`= readlink non-posix -e`
Reformat README 2015-02-08 23:20:33 +00:00			`=* renice yes none`
			`=* rm yes none (-i)`
			`=* rmdir yes none`
Fix alphabetical order in README 2015-02-10 11:11:21 +00:00			`# sed`
			`seq non-posix none`
Reformat README 2015-02-08 23:20:33 +00:00			`=* setsid non-posix none`
Fix alphabetical order in README 2015-02-10 11:11:21 +00:00			`= sha1sum non-posix none`
			`= sha256sum non-posix none`
			`= sha512sum non-posix none`
Reformat README 2015-02-08 23:20:33 +00:00			`=* sleep yes none`
			`sort no -m, -o, -d, -f, -i`
			`=* split yes none`
			`=* sponge non-posix none`
			`strings no -a, -n, -t`
			`=* sync non-posix none`
Add c-flag to tail(1) and refactor manpage and mark it as finished in README. 2015-02-09 17:38:41 +00:00			`=* tail yes none`
Reformat README 2015-02-08 23:20:33 +00:00			`=* tar non-posix none`
			`=* tee yes none`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`#* test yes none`
Add r-flag to touch(1), refactor manpage and code and mark it as finished in README. 2015-02-08 23:41:57 +00:00			`=* touch yes none`
Reformat README 2015-02-08 23:20:33 +00:00			`#* tr yes none`
			`=* true yes none`
			`=* tty yes none`
			`=* uname yes none`
			`#* unexpand yes none`
Update README 2015-02-11 10:54:17 +00:00			`= uniq no none`
Reformat README 2015-02-08 23:20:33 +00:00			`=* unlink yes none`
			`= uudecode no -o`
			`= uuencode no -m`
			`#* wc yes none`
			`= xargs no -I, -L, -p, -s, -t, -x`
			`=* yes non-posix 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`
			`--------`

			`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/`