Improving doc

Documentation/doc/Documentation/Installation.txt

@@ -513,7 +513,7 @@ The \sc{Eigen} web site is <A HREF="http://eigen.tuxfamily.org">`http://eigen.tu
 \sc{Lapack} is a `Fortran` library for linear algebra.
 
 In \cgal, \sc{Lapack} is an alternative to \sc{Eigen} for singular value decomposition for the \ref
-kgJet_fitting_3 and the \ref PkgRidges_3 packages.
+PkgJet_fitting_3 and the \ref PkgRidges_3 packages.
 
 The \sc{Lapack} web site is <A HREF="http://www.netlib.org/lapack/">`http://www.netlib.org/lapack/`</A>.
 

Principal_component_analysis/doc/Principal_component_analysis/CGAL/linear_least_squares_fitting_3.h

@@ -71,7 +71,6 @@ can be omitted: if Eigen 3 (or greater) is available and
 implementation `Internal_diagonalize_traits` is used.
 
 
-
 \cgalHeading{Requirements}
 
 <OL> 

Principal_component_analysis/doc/Principal_component_analysis/PackageDescription.txt

@@ -27,6 +27,7 @@
 \cgalPkgSummaryEnd
 \cgalPkgShortInfoBegin
 \cgalPkgSince{3.2}
+\cgalPkgDependsOn{\ref PkgSolverSummary} 
 \cgalPkgBib{cgal:ap-pcad}
 \cgalPkgLicense{\ref licensesGPL "GPL"}
 \cgalPkgDemo{Principal Component Analysis,pca.zip,Operations on Polygons,polygon.zip,Operations on Polyhedra,polyhedron_3.zip}

Solver_interface/doc/Solver_interface/CGAL/Eigen_diagonalize_traits.h

@@ -13,9 +13,8 @@ available on the system.
 \cgalModels `DiagonalizeTraits`
 
 
-`FT`: floating type
+\tparam FT Number type
-
+\tparam dim Dimension of the matrices and vectors
-`dim`: dimension of the matrices and vectors
 
 \sa http://eigen.tuxfamily.org
 

Solver_interface/doc/Solver_interface/CGAL/Eigen_solver_traits.h

@@ -10,8 +10,7 @@ The version 3.1 (or greater) of \ref thirdpartyEigen "Eigen" must be available o
 \cgalModels `SparseLinearAlgebraTraitsWithFactor_d` and `NormalEquationSparseLinearAlgebraTraits_d`
 
 
-`T`: a sparse solver of \ref thirdpartyEigen "Eigen". The default solver is the iterative bi-congugate gradient stabilized solver 
+\tparam T A sparse solver of \ref thirdpartyEigen "Eigen". The default solver is the iterative bi-congugate gradient stabilized solver  `Eigen::BiCGSTAB` for `double`. 
-`Eigen::BiCGSTAB` for `double`. 
 
 \sa `CGAL::Eigen_sparse_matrix<T>`
 \sa `CGAL::Eigen_sparse_symmetric_matrix<T>`

Solver_interface/doc/Solver_interface/CGAL/Internal_diagonalize_traits.h

@@ -9,10 +9,8 @@ Matrices.
 
 \cgalModels `DiagonalizeTraits`
 
-
+\tparam FT Number type
-`FT`: floating type
+\tparam dim Dimension of the matrices and vectors
-
-`dim`: dimension of the matrices and vectors
 
 Example 
 -------------- 

Solver_interface/doc/Solver_interface/PackageDescription.txt

@@ -25,10 +25,11 @@
 
 ## Concepts ##
 
+- `DiagonalizeTraits`
 - `SparseLinearAlgebraTraits_d`
 - `SparseLinearAlgebraTraitsWithFactor_d`
 - `SvdTraits`
-- `DiagonalizeTraits`
+
 
 ## Classes ##
 

Solver_interface/doc/Solver_interface/dependencies

@@ -3,4 +3,3 @@ Kernel_23
 STL_Extension
 Algebraic_foundations
 Miscellany
-Jet_fitting_3

Solver_interface/examples/Solver_interface/sparse_solvers.cpp

@@ -1,6 +1,3 @@
-#include <set>
-
-#include <CGAL/Simple_cartesian.h>
 #include <CGAL/Eigen_solver_traits.h>
 #include <CGAL/Eigen_matrix.h>
 
@@ -21,6 +18,8 @@ int main(void)
   Eigen_matrix A (degree);
 
   Eigen_vector diag (degree);
+
+  // Randomly make some coefficients of the matrix non-zero
   for (std::size_t i = 0; i < nb_nonzero_coef; ++ i)
     {
       std::size_t x = rand () % degree;
@@ -38,7 +37,8 @@ int main(void)
 
   for (std::size_t i = 0; i < degree; ++ i)
     A.add_coef (i, i, diag.vector()[i]);
-  
+
+  // Create sparse matrix
   A.assemble_matrix();
   
   Eigen_vector X (degree);

Surface_mesh_parameterization/doc/Surface_mesh_parameterization/Surface_mesh_parameterization.txt

@@ -760,11 +760,6 @@ Square, circular and two-points border parameterizations are good starting point
 Obviously, this package would benefit of having robust algorithms
 which transform arbitrary meshes into topological disks.
 
-\example Surface_mesh_parameterization/Simple_parameterization.cpp
-\example Surface_mesh_parameterization/Mesh_cutting_parameterization.cpp
-\example Surface_mesh_parameterization/Complete_parameterization_example.cpp
-\example Surface_mesh_parameterization/polyhedron_ex_parameterization.cpp
-
 
 */ 
 } /* namespace CGAL */

Surface_mesh_parameterization/doc/Surface_mesh_parameterization/examples.txt

@@ -1,5 +1,6 @@
-/// \example Surface_mesh_parameterization/Simple_parameterization.cpp
+/*!
-/// \example Surface_mesh_parameterization/Mesh_cutting_parameterization.cpp
+ \example Surface_mesh_parameterization/Simple_parameterization.cpp
-/// \example Surface_mesh_parameterization/Complete_parameterization_example.cpp
+ \example Surface_mesh_parameterization/Mesh_cutting_parameterization.cpp
-/// \example Surface_mesh_parameterization/Eigen_parameterization.cpp
+ \example Surface_mesh_parameterization/Complete_parameterization_example.cpp
-/// \example Surface_mesh_parameterization/polyhedron_ex_parameterization.cpp
+ \example Surface_mesh_parameterization/polyhedron_ex_parameterization.cpp
+*/