summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorRob Landley <rob@landley.net>2012-02-04 12:20:39 -0600
committerRob Landley <rob@landley.net>2012-02-04 12:20:39 -0600
commit09e8bde9f292e537c35387435b5bea9024cf28e8 (patch)
treeb7b4ed183e531fd466d804fb336ce718d16c37fd /README
parent1bc8463cb98580024fa9453723e0ded0bfd19233 (diff)
downloadtoybox-09e8bde9f292e537c35387435b5bea9024cf28e8.tar.gz
toybox-09e8bde9f292e537c35387435b5bea9024cf28e8.tar.bz2
toybox-09e8bde9f292e537c35387435b5bea9024cf28e8.zip
Add a basic README and an example to "make help".
Diffstat (limited to 'README')
-rw-r--r--README30
1 files changed, 30 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..4526b1b
--- /dev/null
+++ b/README
@@ -0,0 +1,30 @@
+Toybox: all-in-one Linux command line.
+
+--- Building Toybox
+
+Type "make help" for build instructions.
+
+Mostly you want:
+
+ CFLAGS="--static" CROSS_COMPILE=armv5l- make defconfig toybox install
+
+Or "make menuconfig", which produces the same sort of .config file as the
+Linux kernel.
+
+--- Using toybox
+
+The build produces a "swiss-army-knife" style multifunction binary, which acts
+differently depending on the name it was called as (cp, mv, cat...), and
+installs symlinks under each command name to populate $PATH.
+
+The "toybox" command itself uses its first argument as the command name to run
+(ala "toybox ls -l"). With no arguments, it lists available commands. (This
+allows you to use the commands even without the symlinks.)
+
+The "help" command provides information about each command (ala "help cat").
+
+The toybox web page is at "http://landley.net/toybox".
+
+Have fun,
+
+Rob