Mercurial > hg > toybox
annotate www/index.html @ 222:cf3b2b8a371b
Release notice.
author | Rob Landley <rob@landley.net> |
---|---|
date | Wed, 02 Jan 2008 01:40:09 -0600 |
parents | f868f933bd3b |
children | 6aac63925eff |
rev | line source |
---|---|
85
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
1 <!--#include file="header.html" --> |
222 | 2 <p><b>January 2, 2008</b> - And <a href=downloads/toybox-0.0.4.tar.bz2>toybox-0.0.4.tar.bz2</a> is out. New applets include patch, touch, and sha1sum.</p> |
85
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
3 |
200 | 4 <p><b>December 12, 2007</b> - Updated the list of implemented applications, |
5 put up a <a href=todo.txt>todo list</a> and <a href=code.html>infrastructure | |
6 documentation</a>. Expect another release towards the end of the month.</p> | |
7 | |
135
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
8 <p><b>June 18, 2007</b> - Put out |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
9 <a href=downloads/toybox-0.0.3.tar.bz2>toybox-0.0.3.tar.bz2</a> since it's |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
10 been too long since I did something like that. This one implements |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
11 catv, count, df, echo, false, oneit, pwd, sleep, sync, toysh, true, which, |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
12 and yes (which is what "make defconfig" enables). There are several other |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
13 commands not enabled by defconfig, because they don't really work yet.</p> |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
14 |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
15 <p>Most of the general infrastructure's there now, although lots of tweaking |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
16 and optimizing is still needed. The test suite is skeletal and not entirely |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
17 checked in yet, but I'm working on that.</p> |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
18 |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
19 <p>I don't have nearly as much time to work on this as I'd like, but I'm making |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
20 a little progress.</p> |
3b20d0322d28
Update web page to mention 0.0.3 release.
Rob Landley <rob@landley.net>
parents:
85
diff
changeset
|
21 |
200 | 22 <p><b>January 31, 2007</b> - |
23 Screwing up the web page a bit, adding an index bar along the side | |
85
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
24 which doesn't properly connect up to anything yet. (Busy implementing |
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
25 mke2fs and gene2fs.)</p> |
22
64d6e0a2f030
The web page should be in the repository, and while I'm at it let's see if I
Rob Landley <rob@landley.net>
parents:
diff
changeset
|
26 |
24
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
27 <p>Warning: lots of this page is about what I plan to do, not what I've |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
28 already done. See <a href="#status>status</a> or <a href="/notes.html>my |
30
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
29 development blog</a>, or <a href="/hg/toybox">browse the mercurial |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
30 archive</a>.</p> |
24
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
31 |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
32 <h2><a name="what" />What is ToyBox?</h2> |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
33 |
200 | 34 <p>The goal of the Toybox project is to create simple implementations of all |
35 the important Linux command line utilities. These implementations should | |
36 be small (the entire project should total less than a megabyte, uncompressed), | |
37 fast, simple, and correctly implemented (which is related to standards | |
38 compliance, but isn't quite the same thing). Click for | |
39 <a href="design.html">more about the design goals</a></p> | |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
40 |
24
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
41 <p>Toybox has configurable levels of functionality, and should scale from tiny |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
42 embedded systems up to full general purpose desktop and development |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
43 environments. The author plans to run it on his laptop, and the |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
44 <a href=/code/firmware>Firmware Linux</a> project is trying to get a complete |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
45 Linux system to rebuild itself from source code using toybox.</p> |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
46 |
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
47 <p>Toybox is <a href=license.html>Licensed under GPL version 2</a>.</p> |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
48 |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
49 <p>Toybox can be built as a single "swiss army knife" executable (ala BusyBox |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
50 or Red Hat's Nash), or each command can be built as a traditional independent |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
51 executable.</p> |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
52 |
24
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
53 <h2><a name="commands" />Which commands are planned?</h2> |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
54 |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
55 <b><h3>Relevant Standards</h3></b> |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
56 |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
57 <p>Most commands are implemented according to |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
58 <a href=http://www.opengroup.org/onlinepubs/009695399/idx/utilities.html>The |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
59 Single Unix Specification version 3</a>. This does not mean that Toybox is |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
60 implementing every SUSv3 utility: some such as SCCS and ed are obsolete, while |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
61 others such as c99 are outside the scope of the project. Toybox also isn't |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
62 implementing full internationalization support: it should be 8-bit clean and |
140 | 63 handle UTF-8, but otherwise we leave this to X11 and higher layers. And |
64 some things (like $CDPATH support in "cd") await a good explanation of why | |
65 to bother with them.</p> | |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
66 |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
67 <p>The other major sources of commands are the Linux man pages, and testing |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
68 the behavior of existing commands (although not generally looking at their |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
69 source code).</p> |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
70 |
200 | 71 <b><h2><a name="status" />What commands are implemented?</h2></b> |
72 | |
73 <p>The following commands are currently implemented: basename, catv, chroot, | |
74 count, df, dirname, dmesg, echo, false, hello, mkfifo, oneit, pwd, sha1sum, | |
75 sleep, sync, true, tty, which, yes.</p> | |
76 | |
77 <p>The following commands are partly implemented, in a somewhat usable but not | |
78 necessarily complete state: bzcat/bunzip2, help, mke2fs, netcat/nc, sh/toysh, | |
79 mdev, touch, readlink.</p> | |
80 | |
81 <p>The following are partially implemented commands that don't actually do | |
82 anything yet: mke2fs, md5sum.</p> | |
83 | |
84 <p>For more information, see <a href=todo.txt>the todo list</a>.</p> | |
85 | |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
86 <b><h3>Command Shell</h3></b> |
200 | 87 <p>The Toybox Shell (toysh) aims to be a reasonable bash replacement. It |
88 implements the "sh" and "toysh" commands, plus the built-in commands "cd" and | |
89 "exit". This is the largest single sub-project in toybox.</p> | |
90 | |
91 <p>The following additional commands may be built into the shell (but not as | |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
92 separate executables): cd, exit, if, while, for, function, fg, bg, jobs, source, |
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
93 <a href="http://www.opengroup.org/onlinepubs/009695399/utilities/alias.html">alias</a>, |
200 | 94 export, set, unset, read, trap, and exec. (Note: not done yet.)</p> |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
95 |
200 | 96 </ul> |
24
c8d0f1876c40
Web site updates, and a design document.
Rob Landley <rob@landley.net>
parents:
23
diff
changeset
|
97 |
85
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
98 <b><h2><a name="downloads" />Download</h2></b> |
23
a5e1ebc1d6ee
Redo the index page (flesh it out about halfway), and a couple tweaks to
Rob Landley <rob@landley.net>
parents:
22
diff
changeset
|
99 |
22
64d6e0a2f030
The web page should be in the repository, and while I'm at it let's see if I
Rob Landley <rob@landley.net>
parents:
diff
changeset
|
100 <p>This project is maintained as a mercurial archive. To get a copy of the |
30
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
101 current development version, either use mercurial (hg clone |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
102 http://landley.net/toybox) or click on one of the zip/gz/bz2 links |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
103 at the top of the <a href=/hg/toybox>mercurial archive browser</a> page to get |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
104 an archive of the appropriate version. Click |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
105 <a href="/hg/toybox?cmd=tags">tags</a> to the tagged release versions ("tip" |
71bfd266fce9
I got the mercurial web browser thingy set up, note it on the web page.
Rob Landley <rob@landley.net>
parents:
24
diff
changeset
|
106 is the current development version).</p> |
22
64d6e0a2f030
The web page should be in the repository, and while I'm at it let's see if I
Rob Landley <rob@landley.net>
parents:
diff
changeset
|
107 |
43 | 108 |
22
64d6e0a2f030
The web page should be in the repository, and while I'm at it let's see if I
Rob Landley <rob@landley.net>
parents:
diff
changeset
|
109 <p>My <a href=/notes.html>development log</a> is currently the best way to |
43 | 110 track what's going on with this project. There's also a |
111 <a href=http://www2.them.com:8080/cgi-bin/mailman/listinfo/toybox>mailing list</a> for toybox development.</p> | |
85
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
112 |
4108e577e018
Move download->downloads (be consistent) and add a skeletal index bar along
Rob Landley <rob@landley.net>
parents:
43
diff
changeset
|
113 <!--#include file="footer.html" --> |