.-----------------------------------------------------------------------------.
|                                                    ____     _  _  _  __     |
|                                                   |    ||_||_>| ||_|| _     |
|       ,-----------------.                         | *    | |_>|_||| |_/     |
|         B L U E C H I P                           |   __    _ ___ __ _  _   |
|       `-----------------'                         |  |_ |_||_  | |_ ||||_   |
|             presents                              |_:__| |  _| | |__| | _|  |
|                                                                             |
|            __________               __   ___.                               |
|  Open      \______   \ ____   ____ |  | _\_ |__   _______  ___              |
|  Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /              |
|  Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <  DevKit       |
|  Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \              |
|                    \/            \/     \/    \/            \/      v3.14   |
|                  real firmware written by serious hackers                   |
|                                                                             |
`-----------------------------------------------------------------------------'


         ***************************************************************
                               INFORMATION UPDATE
         ***************************************************************

         As of today (see version history) there is currently a problem
         with the Rockbox build process which will cause this error:

            "/home/guest/_____/tools/convbdf: not found"

         If you see this error message.  It can be fixed very simply by
         typing the following from your 'MyBuild' directory:

           ~/_____/MyBuild> cd ../tools
           ~/_____/tools> make

         You may then tell the build process to continue from where it
         left off by typing:

           ~/_____/tools> cd ../MyBuild
           ~/_____/MyBuild> make

         ***************************************************************


         1.  Run the installer: RockBox-DevKit.exe
             o It will create a sub-dir called "Rockbox-Devkit"
               under whatever directory you specify
             o This directory can be moved/renamed
               only AFTER install and BEFORE setup


         2.  Run /DEVKIT/setup/setup.bat
             * Notes to people who have a.n.other cygwin install...
               o Old cygwin registry entries WILL be backed up.
               o To uninstall the Rockbox DevKit and reset the registry
                 simply run /DEVKIT/setup/remove.bat
               o If you wish to move the DevKit AFTER "setup"
                 You should (a) 'remove' the DevKit, (b) move/rename
                 the directory, (c) run 'setup' again.

         2a.  (Optional) Create Desktop icon
              o During setup, a shortcut file to the DevKit is
                created as /DEVKIT/RockBox.pif
              o This file may be copied or moved to the Desktop,
                Start Menu or Launchbar as desired.

         ---------------------------------------------------------------
                  If you plan to use CVS for source maintenance,
                       that's probably all you need to know.
                --------------------------------------------------
                  The rest of this document is designed to assist
                     the new-comer through their first compile.
         ---------------------------------------------------------------


         3.  Download a daily tarball
             o You can find these under "Source tarballs" at
               http://rockbox.haxx.se/daily.shtml


         4.  Save the tarball to /DEVKIT/home/guest/
             o The tarball will typically be named:
               "rockbox-daily-yyyyddmm.tar.gz"
               Where yyyymmdd is the year/month/day of the release
             o For the purpose of this document, we will simply
               call this file "tarball"


         5.  Run /DEVKIT/_RockBox.bat
             o The "_" on the start of the name ensures that this important
               file is always at the top of the directory listing :)


         6.  Unzip the tarball by typing:

             ~> daily tarball.tar.gz


         7a. === Making a Simulator Build ===

             ~> cd tarball

             ~/tarball> mkdir MySimBuild
             ~/tarball> cd MySimBuild

             ~/tarball/MySimBuild> rbconf
             ~/tarball/MySimBuild> make


         7b. === Making an AJZ Build ===

             ~> cd tarball

             ~/tarball> mkdir MyAJZBuild
             ~/tarball> cd MyAJZBuild

             ~/tarball/MyAJZBuild> rbconf
             ~/tarball/MyAJZBuild> make


         Notes
         -----
         o You may call your 'tarball' & 'build' directories anything
           that pleases you.

         o "rbconf" is an alias for "../tools/configure"

         o "daily" is an alias for "tar -xzf"



Additional
----------

# There is a full How-To regarding CVS in the /DEVKIT/ directory.

# If you need to add to the PATH, please edit /DEVKIT/UserPath.bat

# Feedback is useful and appreciated.
  cs_bluechip @at@ webtribe .dot. net



Greetz
------

Special thanks goes to (in alphabetical order):
amiconn, Bagder, c0utta, DevZer0, GH, Joerch, LinusN, linuxstb, M.Bright,
midk, Naftali, scott666, Zagor



Version History
---------------

3.14    BC      2005-11-14  iPod update.
                            Added:   /usr/include/getopt.h
                                     /usr/include/errno.h
                                     /usr/include/unistd.h
                                     /usr/include/sys/errno.h
                                     /usr/include/sys/unistd.h
                                     /opt/arm/*
                            Updated: /etc/profile
                                       (added /opt/arm to the path)
                                       (added m68k & arm version checks)
                                     /bin/cygwin1.dll  ->  v1.5.18-1

3.13    BC      2005-08-23  Added:   /usr/bin/env.exe

3.12    BC      2005-07-23  Removed: font update request in /usr/bin/cvsget
                                     (no longer required)
                            Updated: /home/guest/.inputrc
                                     Just tidying
                            Updated: /bin/sed.exe
                                     updated to version 4.1.2 ...more info at:
                                  www.rockbox.org/twiki/bin/view/Main/BrokenSed
                            Updated: 
                                     Instructions on building the tools
                            Added:   /lib/w32api/libwinmm.a
                                     Now required by the windows sim

3.11    BC      2005-07-18  Updated toolchain to reflect the requirements of
                            the latest Rockbox CVS (& daily) source.

                            Added: /bin/basename.exe
                            Added: /bin/wc.exe
                            Added: /bin/head.exe

                            Updated HowTo_CVS.html

3.10    BC      2005-03-08  Big fat overhaul:
-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-
Bug Fixes:
  Fixed mingw sybolic links in setup.bat

Updated:
  /bin/cygwin1.dll (to version 1.5.12)
  /usr/bin/uclpack.exe (support --none)
  /home/guest/.inputrc  (win32sim exe name changed)
  /etc/profile - updated path for new opt/* structure

Added:
  /bin/echo.exe  (win32sim makefiles)
  /bin/cygintl-3.dll  (for echo)
  /bin/grep.exe  (updated build scripts)
  /bin/cygpcre.dll  (for grep)
  /bin/ranlib.exe  (updated lib support)
  /usr/sh1/bin/sh-elf-ranlib.exe  (updated lib support)
  /lib/gcc-lib/i686-pc-cygwin/3.3.1/include/limits.h  (new string functions)
  /lib/gcc-lib/i686-pc-cygwin/3.3.1/include/syslimits.h  (new string functions)
  /usr/include/mingw/limits.h  (new string functions)
  /opt/m68k/*  (require for iRiver builds) ^1^

Moved:
  /usr/sh1/*   ->  /opt/sh1/*


^1^ Thanks to LinusN for his invaluable assistance with these files.
    I have a copy of the _full_ m68k tool chain if anyone needs it.


Test results with CVS/2005-Mar-08/04:00GMT:

2 - Recorder20, Normal, OK
2 - Recorder20, Win32sim, OK
2 - Recorder20, Debug, fail "region FLASH is full"
2 - Recorder20, Bootloader, LOL

9 - iRiver_h100, Win32sim, OK
9 - iRiver_h100, Normal, OK
9 - iRiver_h100, Debug, fails in 'mpeg.c' ("`TSTR' undeclared")
9 - iRiver_h100, Bootloader, OK

TODO:
'calmrisc' support for GMINI series.
If anybody is able to supply the required GMINI tool-chain (typically
everything you would find in the /opt/calmric16/ directory) please contact me.

-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-

3.03    BC      2004-07-17  Updated etc/profile
                            Updated .inputrc - added .inputrc.help
                            Added SCROLLIT
                            Added remmed SCROLLIT command in UserPath.bat
                            Added licomdlg.a for new Windows UIsims

3.02    BC      2004-06-18  Improved cvs scripts
                            added inputrc to add better PC keyboard support
                            Minor updates to documentation

3.01    BC      2004-06-18  Moved SHORTCUT.EXE to /usr/bin/
                            Extended version number to 5 digits ("v3.01")
                            Updates to this file
                            Updates to CVS HowTo
                            removed oldroot/ - whoops
                            Added cvsget, cvsup & cvsdif(f) scripts to /usr/bin
                            Renamed RockBox.bat to _RockBox.bat
                            Updated SETUP.BAT for Shortcut

3.0     BC      2004-06-18  First Release


Note to whoever...

When updating please:
# Update the version history table above.
# Update the version number in "version.bat"
# Rename this file to reflect the new version number.
# Make sure you erase any .bak files you create before recompressing.