1 files changed, 16 insertions, 14 deletions

diff --git a/tools/release/README b/tools/release/README
index 294c7ba136..19e4f0735c 100644
--- a/tools/release/README
+++ b/tools/release/README
@@ -5,28 +5,30 @@
    Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
                      \/            \/     \/    \/            \/
 
- This directory contains useful scripts when creating and building
- releases. The plan is to hopefully create a single top-level script that will
- run everything needed to make a complete and full release and put all
- generated data into a separate output directory.
+ This directory the scripts used to create release artifacts.  All
+ generated data is stored in an output directory (called "output").
+
+ All of these scripts take two arguments; the git tag and the version string.
 
  NOTE that these scripts assume that you have the necessary compilers already
  present in your PATH.
 
  The scripts:
 
- bins.pl          Builds all the binary rockbox zip files.
-
- manuals.pl       Builds all manuals
+   bins.pl          Builds all the binary rockbox zip files
+   manuals.pl       Builds all manuals (pdf and html-zip)
+   sources.sh       Builds the source tarball
+   voices.pl        Builds all "complete enough" voice files
 
- voices.pl        Builds all english voice files
+  Only "stable" targets, their manuals, and a selection of voice files are built;
+  these are designated in tools/builds.pm
 
- tarball.sh       Builds the source tarball
+ Example:
 
+   tools/release/sources.sh v3.15-final 3.15
 
- STATUS
+ Other notes:
 
- All these scripts have a "version" variable at the top that needs editing and
- each of this script needs to be run at the source tree root to function. Most
- of them put their generated files in a subdir called 'output' which the
- scripts create.
+   * Update www/tools/dailybuild-voices.pl file to add the release target
+     voice list!
+   * Update release target in tools/builds.pm