aboutsummaryrefslogtreecommitdiff
path: root/www
diff options
context:
space:
mode:
authorRob Landley <rob@landley.net>2006-11-05 01:01:34 -0500
committerRob Landley <rob@landley.net>2006-11-05 01:01:34 -0500
commit3f920589e2eaed2fb6fb5b02251b68ba0935e09f (patch)
tree75e828d24020337cb408b4a6b068737b7667c537 /www
parent5c63c928689f2ebb7b8d87895c8d4846f7aac6aa (diff)
downloadtoybox-3f920589e2eaed2fb6fb5b02251b68ba0935e09f.tar.gz
Redo the index page (flesh it out about halfway), and a couple tweaks to
the license page.
Diffstat (limited to 'www')
-rw-r--r--www/index.html58
-rw-r--r--www/license.html20
2 files changed, 69 insertions, 9 deletions
diff --git a/www/index.html b/www/index.html
index 94a9da2c..3b651ba2 100644
--- a/www/index.html
+++ b/www/index.html
@@ -1,6 +1,64 @@
<html><title>toybox</title>
<body>
+<h2>What is ToyBox?</h2>
+
+<p>Toybox aims to implement all the Linux command line utilities in under one
+megabyte. This project aims for small, simple, and efficient implementations,
+with configurable levels of functionality. It should scale from tiny embedded
+systems up to full fledged desktop and development environments.</p>
+
+<p>The project is <a href=license.html>Licensed under GPL version 2</a>.</p>
+
+<p>Toybox can be built as a single "swiss army knife" executable (ala BusyBox
+or Red Hat's Nash), or each command can be built as a traditional independent
+executable.</p>
+
+<h2>Which commands are planned?</h2>
+
+<b><h3>Relevant Standards</h3></b>
+
+<p>Most commands are implemented according to
+<a href=http://www.opengroup.org/onlinepubs/009695399/idx/utilities.html>The
+Single Unix Specification version 3</a>. This does not mean that Toybox is
+implementing every SUSv3 utility: some such as SCCS and ed are obsolete, while
+others such as c99 are outside the scope of the project. Toybox also isn't
+implementing full internationalization support: it should be 8-bit clean and
+handle UTF-8, but otherwise we leave this to X11 and higher layers.</p>
+
+<p>The other major sources of commands are the Linux man pages, and testing
+the behavior of existing commands (although not generally looking at their
+source code).</p>
+
+<b><h3>Command Shell</h3></b>
+<p>The Toybox Shell aims to be a reasonable bash replacement. It implements
+the "sh" and "toysh" commands, plus the built-in commands "cd" and "exit".
+The following additional commands may be built into the shell (but not as
+separate executables): cd, exit, if, while, for, function, fg, bg, jobs, source,
+<a href="http://www.opengroup.org/onlinepubs/009695399/utilities/alias.html">alias</a>,
+export, set, unset, read, trap, and exec.</p>
+
+<b><h3>General Purpose Commands:</h3></b>
+
+<p>[TODO]</p>
+
+<b><h3>Development tools:</h3></b>
+
+<p>Commands: ar, make [TODO]</p>
+
+<b><h2>What commands are implemented?</h2></b>
+
+<p>Toybox is a work in progress, and nowhere near a 1.0 release. The first
+commit was September 27, 2006, and work is ongoing.</p>
+
+<p>Partial (in progress): sh/toysh (cd, exit), df, which.</p>
+
+<p>Complete: hello, pwd.</p>
+
+<p>Infrastructure:</p>
+
+<b><h2>Download</h2></b>
+
<p>This project is maintained as a mercurial archive. To get a copy of the
current development version, "hg clone static-http://landley.net/code/toybox",
or check <a href=download>the download directory</a> for release tarballs.
diff --git a/www/license.html b/www/license.html
index c178a96d..547adeab 100644
--- a/www/license.html
+++ b/www/license.html
@@ -3,9 +3,10 @@
<h2>Toybox is licensed under the terms of GPLv2.</h2>
<p>The complete text of the General Public License version 2 is included in the
-file LICENSE in each source tarball. Version 2 is the only version of
-this license which toybox is distributed under. (I.E. It doesn't have the
-strange "or later" dual license some projects have.)</p>
+file LICENSE in each source tarball, and again at the end of this page.
+Version 2 is the only version of this license which toybox is distributed
+under. (I.E. It doesn't have the strange "or later" dual license some projects
+have.)</p>
<h2>Clarifications</h2>
@@ -22,7 +23,8 @@ interpreting the sucker where it says something stupid.</p>
individual source files.</b> This doesn't mean you can change what license the
code is under, or that you can remove other people's copyright notices. You
certainly can't change the test of the GPL itself. What it means is that if
-you use this code in a project that distributes source in zip files instead of
+a file says "see file LICENSE in this tarball for details" and you use this
+code in a project that distributes source in zip files instead of
tarballs, or your package's copy of the GPLv2 text isn't in a file called
"LICENSE", it's silly to preserve an obsolete notice verbatim and add some
kind of "correction" after the old notice.</p>
@@ -30,7 +32,7 @@ kind of "correction" after the old notice.</p>
<p>Some lawyers seem to think a strict reading of GPLv2 section 1 (and later
sections including section 1 by reference) requires maintaining old notices in
perpetuity. Even if you had code that used to be dual licensed, but created
-a derived work that's just under one of the two licenses, so the old license
+a derived work that's just under one of the two licenses, and the old license
notice is not just strange or misleading but actually incorrect for the new
file. (For example, splicing GPLv2 only code into a dual "GPLv2 or later"
project produces a result that can be distributed under the terms of GPLv2,
@@ -155,7 +157,7 @@ patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
-
+
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
@@ -210,7 +212,7 @@ above, provided that you also meet all of these conditions:
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
-
+
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
@@ -268,7 +270,7 @@ access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
-
+
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
@@ -325,7 +327,7 @@ impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
-
+
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License