Subversion Repositories crisos/svn

Welcome to CrisOs DarwinFox building system
*************************************************
                                http://crisos.org


1. Introduction
2. OpenWrt and patches
3. Bulding system
4. Patch system
5. Contibute

1. Introduction
-------------------
Some time ago I start to work within this strange project, CrisOs just for fun,
during the mouths I release some different version of CrisOs.
Originally this system was based on an old release of openwrt with some fix 
called alpha release, now this approach is useless and cannot be followed for 
the latest CrisOs release Darwinfox, let me explain because.

2. OpenWrt and patches
-------------------
Most of the works done on CrisOs has been upstreamed to OpenWrt community using 
patches, but this patches are not applied or directly dropped.
This building systems allow me to dynamically publish the related patches for the 
latest openwrt version.
BUT there are a lot of side effect on this approach, READ ALL THIS DOCUMENT!

3. Bulding system
-------------------
The OpenWrt system is well documented under openwrt/doc and will not addressed
in this readme.
The darwinfox system have this directory layout:
darwinfox
    |--- helper         - this dir contain some script
    |--- openwrt        - contain the latest openwrt version
    \--- patches        - contain crisos patches
    

The darwinfox building system introduce some aliases and a simple patches manager.

Aliases:
make update     - this update the openwrt checkout ONLY
make menuconfig - alias of make -C openwrt/ menuconfig
make verbose    - alias make -C openwrt/ V=99

4. Patch system
-----------------
At the moment the patch system is very, VERY stupid!
Typing 'make patch' the patches files under patches/ are applied to openwrt/
**BEWARE**
To prevent possible error due to previously applied patches ALL the change 
inside openwrt/ are reverted before applying patches!

For save your change BEFORE patch the openwrt with new set of patches save 
your change as follows:

1) enter the openwrt directory
2) make your change to one or more file 
3) save this change using:
        svn diff <file1> ... >  ../patches/<num>-<name>.patch 
where:
        <num> is a three digit number used for sort the patches
        <name> is a descriptive name

Use this method for save your change!

5. Contribute
-----------------
Any kind of support is welcome!

If you discover a bug or do you like to contribute to CrisOs please join mailing 
list, report issue on bug system http://crisos.org/flyspray/ or directly write 
to info@crisos.org.