Fix a few doxygen issues with the tutorials
Merge pull request #231 from andlaus/fix_doxygen

Fix a few doxygen issues with the tutorials
Merge pull-request #232 from rolk/232_distrib
Merge branch 'release/2013.03' of git://github.com/OPM/opm-core
Merge branch 'master' of git://github.com/OPM/opm-core
Merge branch 'master' of git://github.com/OPM/opm-core
Added wellRates() member.
Add new fluid interface
- in progress
Fix bug in upwinding code.

Accidental usage of std::vector's operator< discovered.
Added assert to guard against wrong usage.
Adds the new interface to SinglePvtLivGas
Added gasoilratio() to BlackoilState.
Created new initialization routine, using RS from deck.
Merge remote-tracking branch 'totto82/newfluid2' into combined
Fix SatGwseg* to handle no-gas situation gracefully.
Initialize rate-controlled well bhp with safety factor.

Safety factor is 1.01 (INJECTOR) or 0.99 (PRODUCER), similar to
mrst's ad-fi/utils/initWellSolLocal.m > initialize().
Unit conversion factor of RS is not 1 for FIELD units.
Refined well state initialization.

For SURFACE_RATE controlled wells, initialize wellRates() to match.
Bugfix in well rate init.

Do not always try to initialize, also initialize proper phase rates.
Ensures well rate initialization actually happens.

Do not use the well's comp_frac member, only rely on the control's distr
member for initialization. This forced a change to WellsManager's
initialization of the distr member.