###################################################################################
#########                                                                 #########
#########      README for the downloadsection of linkstationwiki.net      #########
#########                                                                 #########
###################################################################################

We reorganized the downloadsection because there obviously was the need for that.
In the beginning we only had the LS1...but in the meantime this downloadsection is 
getting the central place for currently 13 different boxes, covering 3 different 
architectures. It was impossible to identify which stuff should work on which box.

======== Boxes & Architectures ========

So we created a folder for each box. If you identify your box right, all stuff 
inside these folders is 100 % for your box. This also means that it most likely 
is ONLY for this box. (If it would work on other boxes it would be in a 
"generic" folder described below) 

You might ask why there this "_<arch>"-extensions after each boxname. reason for 
that is that there are several packages working across the different boxes.

Thats why there are folders like "ALL_<generic_boxes>_<arch>". 
The scripts/packages/anything should work on all boxes that are quite similar.

Here you see which boxes can use stuff from which generic-directory:

ALL_LS_KB_PPC  - LS1, LSHG, LSHS, KB, KBHG
ALL_LS_KB_ARM9 - LSPro, LSLIVE, KBPro
ALL_TS_PPC     - TS, TSHS, TSProI
ALL_TS_ARM11   - TSProII, TSLIVE

(Check out the "Hardware_Similarities.txt" which describes the differences between
the boxes. It describes this only in a quite abstract way....)

just remember: packages from different archs than your LS/TS/KB-arch won`t work!

========== 3 Quality Levels ===========

With the new folder-structure we introduced 3 quality levels
1) best quality - in the box specific folders + generic folders for the box-family
2) testing - snapshots (this is for pre-releases of firmwares/packages/scripts)
3) experimental - uploads + user-dirs 

======= Folder Structure ========

ArchIndependent           --- archindependent stuff is for all boxes.
    Patches                   
    Scripts                 
        startscripts        
    Sources                
DEVELOPMENT               --- access is restricted to developers & betatesters   
    ...                       become a betatester if you want to access this!
Installers
    Freelinkomatix
    Kernel2.6-Webinstaller
KB_PPC            --------------------------------------------------------------|
    ...                                                                         |
KBHG_PPC          -------------ALL BOX SPECIFIC FOLDERS-------------------------|
    ...                                                                         |
KBPro_ARM9        --------------------------------------------------------------|
    ...                                                                         |
LS1_PPC           --------------------------------------------------------------|
    Bootloader                                                                  |
        Utilities                                                               |
        UBoot                                                                   |
            Precompiled                                                         |
            FirmimgBins                                                         |
    DevelopmentTools                                                            |
        CrossToolchains                                                         |
            Config                                                              |
            Obsolete                                                            |
                Config                                                          |
        Documentation                                                           |
        Flash                                                                   |
            Original                                                            |
            Utilities                                                           |
        JTAG                                                                    |
        NativeToolchains                                                        |
            Obsolete                                                            |
        Packages                                                                |
    Distributions                                                               |
        Debian                                                                  |
        Freelink                                                                |
            Obsolete                                                            |
            Packages                                                            |
            Releases                                                            |
            TmpImages                                                           |
            Updaters                                                            |
        Gentoo                                                                  |
        Openlink                                                                |
            Obsolete                                                            |
            Packages                                                            |
            Releases                                                            |
            TmpImages                                                           |
            Updaters                                                            |
    Initrds                                                                     |
    Kernel                                                                      |
        Headers                                                                 |
        Modules                                                                 |
        Kernels                                                                 |
            Uboot                                                               |
            NonUboot                                                            |
    Patches                                                                     |
    Scripts                                                                     |
    Sources                                                                     |
    StockFirmware                                                               |
        Stock                                                                   |
        TelnetEnabled                                                           |
LS2_MIPSel        --------------------------------------------------------------|
    ...                                                                         |
LSHG_PPC          --------------------------------------------------------------|
    ...                                                                         |
LSHS_PPC          --------------------------------------------------------------|
    ...                                                                         |
LSLIVE_ARM9       --------------------------------------------------------------|
    ...                                                                         |
LSPro_ARM9        --------------------------------------------------------------|
    ...                                                                         |
PlatformSupport                --- additional utils needed to access the        |
    ...                            box-hdd from Macs/x86                        |
TSHS_PPC          --------------------------------------------------------------|
    ...                                                                         |
TSLIVE_ARM11      --------------------------------------------------------------|
    ...                                                                         |
TSProII_ARM11     --------------------------------------------------------------|
    ...                                                                         |
TSProI_PPC        --------------------------------------------------------------|
    ...                                                                         |
TS_PPC            --------------------------------------------------------------|
    ...
Uploads                        --- The Upload-section. 
    ArchIndependent                ask a admin/mod/betatester for ftp-access
    LS1
    LS2
    LSHG
    LSHS
    LSLIVE
    LSPro
    TSHS
    TSLIVE
    TSProII
    TSProI
    OldUploads (to be sorted)
Users                           --- Admins & Moderators get their own folder
    mindbender                      with ftp-access
    timtimred
    fry
    Professor farnsworth
    E.T.
    etc
    
CHANGELOG:
20.3.2007 - Initial Version by mindbender