Documented parameters, and made unit behaviour according to doc (perm in mD etc.)

opm/core/fluid/BlackoilPropertiesBasic.cpp

@@ -32,7 +32,7 @@ namespace Opm
 	double poro = param.getDefault("porosity", 1.0);
 	using namespace Dune::unit;
 	using namespace Dune::prefix;
-	double perm = param.getDefault("permeability", 100*milli*darcy);
+	double perm = param.getDefault("permeability", 100)*milli*darcy;
         rock_.init(dim, num_cells, poro, perm);
 	pvt_.init(param);
         satprops_.init(param);

opm/core/fluid/BlackoilPropertiesBasic.hpp

@@ -35,6 +35,13 @@ namespace Opm
     {
     public:
         /// Construct from parameters.
+	/// The following parameters are accepted (defaults):
+	///    num_phases         (2)         Must be 1 or 2.
+	///    relperm_func       ("Linear")  Must be "Constant", "Linear" or "Quadratic".
+	///    rho1 [rho2, rho3]  (1.0e3)     Density in kg/m^3
+	///    mu1 [mu2, mu3]     (1.0)       Viscosity in cP
+	///    porosity           (1.0)       Porosity
+	///    permeability       (100.0)     Permeability in mD
         BlackoilPropertiesBasic(const Dune::parameter::ParameterGroup& param,
 				const int dim,
 				const int num_cells);