* doc improvements in Cwise and PartialRedux:

- 33 new snippets
  - unfuck doxygen output in Cwise (issues with function macros)
  - more see-also links from outside, making Cwise more discoverable
* rename matrixNorm() to operatorNorm(). There are many matrix norms
  (the L2 is another one) but only one is called the operator norm.
  Risk of confusion with keyword operator is not too scary after all.

doc/Doxyfile.in

@@ -31,7 +31,7 @@ PROJECT_NAME           = Eigen
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 2.0-alpha6
+PROJECT_NUMBER         = 2.0-alpha7
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
 # base path where the generated documentation will be put.
@@ -1195,7 +1195,9 @@ PREDEFINED             = EIGEN_EMPTY_STRUCT \
 
 EXPAND_AS_DEFINED      = EIGEN_MAKE_SCALAR_OPS          \
                          EIGEN_MAKE_TYPEDEFS            \
-                         EIGEN_MAKE_TYPEDEFS_ALL_SIZES 
+                         EIGEN_MAKE_TYPEDEFS_ALL_SIZES  \
+                         EIGEN_CWISE_UNOP_RETURN_TYPE   \
+                         EIGEN_CWISE_BINOP_RETURN_TYPE
 
 # If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
 # doxygen's preprocessor will remove all function-like macros that are alone

doc/snippets/Cwise_abs.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,-2,-3);
+cout << v.cwise().abs() << endl;

doc/snippets/Cwise_abs2.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,-2,-3);
+cout << v.cwise().abs2() << endl;

doc/snippets/Cwise_cos.cpp

@@ -0,0 +1,2 @@
+Vector3d v(M_PI, M_PI/2, M_PI/3);
+cout << v.cwise().cos() << endl;

doc/snippets/Cwise_cube.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4);
+cout << v.cwise().cube() << endl;

doc/snippets/Cwise_equal_equal.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()==w) << endl;

doc/snippets/Cwise_exp.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3);
+cout << v.cwise().exp() << endl;

doc/snippets/Cwise_greater.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()>w) << endl;

doc/snippets/Cwise_greater_equal.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()>=w) << endl;

doc/snippets/Cwise_inverse.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4);
+cout << v.cwise().inverse() << endl;

doc/snippets/Cwise_less.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()<w) << endl;

doc/snippets/Cwise_less_equal.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()<=w) << endl;

doc/snippets/Cwise_log.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3);
+cout << v.cwise().log() << endl;

doc/snippets/Cwise_max.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4), w(4,2,3);
+cout << v.cwise().max(w) << endl;

doc/snippets/Cwise_min.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4), w(4,2,3);
+cout << v.cwise().min(w) << endl;

doc/snippets/Cwise_minus.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3);
+cout << v.cwise()-5 << endl;

doc/snippets/Cwise_minus_equal.cpp

@@ -0,0 +1,3 @@
+Vector3d v(1,2,3);
+v.cwise() -= 5;
+cout << v << endl;

doc/snippets/Cwise_not_equal.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3), w(3,2,1);
+cout << (v.cwise()!=w) << endl;

doc/snippets/Cwise_plus.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,3);
+cout << v.cwise()+5 << endl;

doc/snippets/Cwise_plus_equal.cpp

@@ -0,0 +1,3 @@
+Vector3d v(1,2,3);
+v.cwise() += 5;
+cout << v << endl;

doc/snippets/Cwise_pow.cpp

@@ -0,0 +1,2 @@
+Vector3d v(8,27,64);
+cout << v.cwise().pow(0.333333) << endl;

doc/snippets/Cwise_quotient.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4), w(4,2,3);
+cout << v.cwise()/w << endl;

doc/snippets/Cwise_sin.cpp

@@ -0,0 +1,2 @@
+Vector3d v(M_PI, M_PI/2, M_PI/3);
+cout << v.cwise().sin() << endl;

doc/snippets/Cwise_sqrt.cpp

@@ -0,0 +1,2 @@
+Vector3d v(1,2,4);
+cout << v.cwise().sqrt() << endl;

doc/snippets/Cwise_square.cpp

@@ -0,0 +1,2 @@
+Vector3d v(2,3,4);
+cout << v.cwise().square() << endl;

doc/snippets/MatrixBase_colwise.cpp

@@ -0,0 +1,5 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the sum of each column:" << endl << m.colwise().sum() << endl;
+cout << "Here is the maximum absolute value of each column:"
+     << endl << m.cwise().abs().colwise().maxCoeff() << endl;

doc/snippets/MatrixBase_cwise.cpp

@@ -0,0 +1,4 @@
+Vector3d v(1,2,3);
+v.cwise() += 3;
+v.cwise() -= 2;
+cout << v << endl;

doc/snippets/MatrixBase_cwise_const.cpp

@@ -0,0 +1,4 @@
+Vector3d v(-1,2,-3);
+cout << "the absolute values:" << endl << v.cwise().abs() << endl;
+cout << "the absolute values plus one:" << endl << v.cwise().abs().cwise()+1 << endl;
+cout << "sum of the squares: " << v.cwise().square().sum() << endl;

doc/snippets/MatrixBase_rowwise.cpp

@@ -0,0 +1,5 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the sum of each row:" << endl << m.rowwise().sum() << endl;
+cout << "Here is the maximum absolute value of each row:"
+     << endl << m.cwise().abs().rowwise().maxCoeff() << endl;

doc/snippets/PartialRedux_maxCoeff.cpp

@@ -0,0 +1,3 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the maximum of each column:" << endl << m.colwise().maxCoeff() << endl;

doc/snippets/PartialRedux_minCoeff.cpp

@@ -0,0 +1,3 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the minimum of each column:" << endl << m.colwise().minCoeff() << endl;

doc/snippets/PartialRedux_norm.cpp

@@ -0,0 +1,3 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the norm of each column:" << endl << m.colwise().norm() << endl;

doc/snippets/PartialRedux_norm2.cpp

@@ -0,0 +1,3 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the square norm of each row:" << endl << m.rowwise().norm2() << endl;

doc/snippets/PartialRedux_sum.cpp

@@ -0,0 +1,3 @@
+Matrix3d m = Matrix3d::Random();
+cout << "Here is the matrix m:" << endl << m << endl;
+cout << "Here is the sum of each row:" << endl << m.rowwise().sum() << endl;