Introduction
_________________________________________________________________________
	This examples wants to give users a quick view about what
	CMake look like and what's the result of some CMake commands.


Requisite
_________________________________________________________________________
	1. Reading Readme.
	2. Basic knowledge about Unix command line.
	3. Unix-like OS. (TODO : make this portable to Window)
	4. CMake 2.8
	5. GNU C++ toolchain


What is CMake
_________________________________________________________________________
	There are some stages for a program

	1. configure stage :
		Find and set up your toolchain, and clarify dependency
		between sources files. In this example, is using CMake.
		This stage should take less than a minute.

	2. build stage :
		Using compiler to compile object files and using linker
		to link a executable. In this example, is using GMake
		This stage may take more than 10 minutes for a large
		project.

	3. run stage :
		Runing executables.


	CMake: The Cross Platform Build System :
	http://clubjuggler.livejournal.com/138364.html?nojs=1

	Getting Start with CMake:
	http://www.ogre3d.org/tikiwiki/Getting%20started%20with%20CMake


How to use this CMake examples
_________________________________________________________________________
	please refer to basic/README, medium/README

	basic/ is what I think the minimum requirement to use CMake.
	medium/ is something you don't need in simple projects but
	may be helpful for some complex projects.


How to install CMake
_________________________________________________________________________
	download page : http://www.cmake.org/cmake/resources/software.html
	Debian-base Linux : apt-get install cmake
	Red-Hat-base Linux : yum install cmake


Useful Cmake Websites:
_________________________________________________________________________
	English:
		http://www.cmake.org/Wiki/CMake
	Simplied Chinese:
		http://zh.wikibooks.org/wiki/CMake_%E5%85%A5%E9%96%80



The explnation to out-of-source build
_________________________________________________________________________
	http://www.cmake.org/Wiki/CMake_FAQ#What_is_an_.22out-of-source.22_build.3F


How to run an example
_________________________________________________________________________
	cd /where/you/want/to/build
	configure : cmake /where/source/dir
	build : make
	runtime : main.exe



To check cmake manual
_________________________________________________________________________
	using "man cmake" when you are under linux. I think you may
	want to check certain commands, then using "cmake --help-command xxx"

	To view manual with web browser :
	http://www.cmake.org/cmake/help/v2.8.11/cmake.html


TODO
_________________________________________________________________________
	Give explanation to cache variables.