diff options
| -rw-r--r-- | www/index.html | 58 | ||||
| -rw-r--r-- | www/license.html | 20 |
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 |