From fcea979dc0908e40d637b671c135f47e3a63e5cc Mon Sep 17 00:00:00 2001
From: Rob Landley <rob@landley.net>
Date: Tue, 3 Oct 2023 14:36:30 -0500
Subject: [PATCH] Make "about" the default web page index.html points to.

Move "current release" into header, update release.txt, redo quickstart again.
---
 www/header.html |  5 +++--
 www/index.html  |  2 +-
 www/quick.html  | 50 +++++++++++++++++++++++++------------------------
 www/release.txt |  3 +--
 4 files changed, 31 insertions(+), 29 deletions(-)
diff --git a/www/header.html b/www/header.html
index 2911bb9e..e72481f4 100644
--- a/www/header.html
+++ b/www/header.html
@@ -7,9 +7,9 @@
 
   <b>About</b>
   <ul>
-    <li><a href="index.html">Quick Start</a></li>
     <li>What is it?<br>
       - <a href="about.html">About</a><br>
+      - <a href="quick.html">Quick Start</a></br>
       - <a href="roadmap.html">Roadmap</a><br>
       - <a href="status.html">Status</a><br>
       - <a href="help.html">Help</a><br>
@@ -55,4 +55,5 @@
 </td>
 
 <td valign=top>
-
+<h2>Current release <a href=https://landley.net/toybox/news.html>0.8.10</a> (July 30, 2023)</a></h2>
+<hr>
diff --git a/www/index.html b/www/index.html
index 876c97ec..546f3050 120000
--- a/www/index.html
+++ b/www/index.html
@@ -1 +1 @@
-quick.html
\ No newline at end of file
+about.html
\ No newline at end of file
diff --git a/www/quick.html b/www/quick.html
index d2669c47..4b5f3413 100644
--- a/www/quick.html
+++ b/www/quick.html
@@ -1,31 +1,25 @@
 <html><head><title>Toybox quick start</title>
 <!--#include file="header.html" -->
 
-<h2>Current release <a href=https://landley.net/toybox/news.html>0.8.10</a> (July 30, 2023)</a></h2>
+<p>Toybox is a single executable implementing <a href=help.html>over
+two hundred</a> different Linux command line utilities. By default it
+uses its filename to determine which command to run, so it can be installed
+with symlinks like "<b>ln -s toybox sed</b>" to put all the commands into
+the search $PATH. The special name "<b>toybox</b>" uses its first argument
+as the command to run, ala "<b>toybox df -a</b>", so you can use it without
+installing it. Running "<b>toybox</b>" with no arguments lists the available
+commands.</p>
 
-<p>Toybox is a single executable that can act like many different Linux command
-line utilities, currently implementing:</p>
-
-<blockquote><p>
-<!--#include file="commands.html" -->
-</p></blockquote>
-
-<p>Toybox uses its filename to determine which command to run, so
-it's usually installed with symlinks like "<b>ln -s toybox sed</b>"
-to put all the commands into the search $PATH.
-The name "<b>toybox</b>" uses its first argument as the command to run, ala
-"<b>toybox df -a</b>", so you can use it without installing it. Running
-"<b>toybox</b>" with no arguments lists the available commands.</p>
-
-<p>Each command has built-in <a href=help.html>documentation</a>,
-which you can get in three different ways:</p>
+<p>Each toybox command has built-in <a href=help.html>documentation</a>,
+which you can read in three different ways:</p>
 <ol>
-<li>most commands accept a --help argument (ala <b>sed --help</b>)</li>
+<li>most commands accept --help and --version arguments (ala <b>sed --help</b>),
+although some (such as <b>true</b> and <b>false</b>) ignore all arguments.</li>
 <li>toybox has a "<b>help</b>" command (ala <b>help sed</b> or
-<b>toybox help sed</b>)</li>
+<b>toybox help sed</b>).</li>
 <li><b>toybox --help command</b> lets you and ask toybox
 for --help about commands. Run "<b>toybox --help</b>" with no other arguments
-to see general help about toybox.</li>
+to see <a href=help.html#toybox>general help</a> about toybox.</li>
 </ol>
 
 <p>You can download a <a href=https://landley.net/bin/toybox/latest>toybox
@@ -45,7 +39,7 @@ $ mkdir newdir<br />
 $ mv toybox newdir/<br />
 $ for i in $(newdir/toybox); do ln -s toybox newdir/$i; done<br />
 $ export PATH="$PWD/newdir:$PATH"<br />
-ls --help
+$ ls --help
 </p></blockquote>
 
 <p>To compile toybox from source:</p>
@@ -58,9 +52,11 @@ $ ./toybox<br />
 $ make tests<br />
 </p></blockquote>
 
-<p>Toybox's build has "<b>make menuconfig</b>" like the kernel (and clean, distclean,
-allnoconfig, etc), see "<b>make help</b>" for more options.
-The binaries distributed on the website are statically linked against musl-libc
+<p>Toybox's build has "<b>make menuconfig</b>" like the kernel (and the
+usual targets: clean, distclean, allnoconfig...), run "<b>make help</b>"
+to list more options.</p>
+
+<p>The binaries distributed on the website are statically linked against musl-libc
 to provide a portable executable without external userspace dependencies.
 To reproduce that:</p>
 
@@ -73,4 +69,10 @@ $ LDFLAGS=--static CROSS_COMPILE=x86_64-linux-musl-cross/bin/x86_64-linux-musl-
 $ ./toybox
 </p></blockquote>
 
+<p>You can also build individual toybox commands as standalone executables,
+either by name ("<b>make sed</b>") or using the "<b>make change</b>" target (as in change
+for a $20) to build all of them at once. This is much less efficient than
+the default build, the individual commands add up to around ten times the
+size of the equivalent all-in-one toybox binary.</p>
+
 <!--#include file="footer.html" -->
diff --git a/www/release.txt b/www/release.txt
index caf5fcd4..5d1fc980 100644
--- a/www/release.txt
+++ b/www/release.txt
@@ -27,8 +27,7 @@ binaries
 
   scp www/{news,help,status}.html landley.net:landley.net/toybox/
 
-for i in $(toybox); do [ "$i" != '[' ] && echo "<a href=help.html#$i>$i</a>"; done > www/commands.html
-Edit version in quick.html
+Edit version in header.html
 
 roadmap.html
 code.html
-- 
2.39.2

