README.mkdn

<img src="https://raw.github.com/BlissRoms/platform_manifest/mm6.0/bliss-logo.png">

Getting Started 
---------------

To get started with Android/Bliss, you'll need to get
familiar with [Git and Repo](http://source.android.com/source/using-repo.html).

To initialize your local repository using the Bliss trees, use this command:

    repo init -u https://github.com/BlissRoms/platform_manifest.git -b new-mm6.0

Then to sync up:

    repo sync -j#

`j#` depends on the number of cpu cores - just use `repo sync` if you are unsure.

To build for your device:

	. build/envsetup.sh

	breakfast `device name here`

	brunch `device name here`

or make it all in one line:

	. build/envsetup.sh && breakfast `device name here` && brunch `device name here`

For more information on this Github Organization and how it is structured,
please [read the wiki article](http://wiki.cyanogenmod.org/w/Github_Organization)

***

Using Build Script
------------------

run command 

	. build.sh 
	
and follow the command prompts.


GERRIT
------
review.blissroms.com

If you would like to contribute to the Bliss project submit patches to
`review.blissroms.com`. Then head into the project and clone it locally, make changes and push back to Bliss review.

HOW TO SUBMIT TO OUR GERRIT:

First and foremost, setup your github with out Gerrit.

Clone the repo you would like to commit to from the Gerrit [Project List](http://review.blissroms.com:8081/#/admin/projects/)
   - Select from the list and copy the clone command line.

Make sure you have git review installed
   - `sudo apt-get install git-review` or `sudo pacman -S git-review`
   
Make sure you are on the correct branch----mm6.0

Make your change and commit it.

Now just type git review, if it does not have the remote yet it will automatically add it and just answer yes to its questions. It will push to the gerrit for you.


BLISS BUILD FLAGS
-----------------

These can be added to your device trees BoardConfig.mk

`BLISS_STRICT:= true`    "run strict aliasing"

`BLISS_O3 := true`    "run O3 optimizations on build"

`BLISS_GRAPHITE := true`    "run graphite optimizations on build"

`BLISS_KRAIT := true`    "run krait optimizations on build - CPU specific, please verify if you can use this"

`BLISS_PIPE := true`   "This flag has actually no effect on the generated code, but it makes the compilation process faster."

`TARGET_TC_ROM := "@@"` Specify toolchain for Rom to be compiled with.

`TARGET_TC_KERNEL := "@@"` Specify toolchain for kernel to be complied with.

@@= Toolchains are located in prebuilts/gcc/linux-x86/arm You only need to specify the end number be it 4.8-sm for 4.8 SaberMod Toolchain, this goes for both ROM and KERNEL.

If you use TARGET_TC_ROM and/or TARGET_TC_KERNEL, please add the following to BoardConfig.mk as well

`TARGET_GCC_VERSION_EXP := $(TARGET_TC_ROM)`

`TARGET_KERNEL_CUSTOM_TOOLCHAIN := $(TARGET_TC_KERNEL)`