Lint changes from Jim Roseborough

Change-Id: Ibca11aa9205f5af6180cb2dcf7ceaf1e8724f092

internal/ceres/cxsparse.h

@@ -133,6 +133,7 @@ class CXSparse {
   int scratch_size_;
 };
 
+// Sparse cholesky factorization using CXSparse.
 class CXSparseCholesky : public SparseCholesky {
  public:
   // Factory

internal/ceres/linear_solver.h

@@ -69,9 +69,15 @@ enum LinearSolverTerminationType {
   LINEAR_SOLVER_FATAL_ERROR
 };
 
+// This enum controls the fill-reducing ordering a sparse linear
+// algebra library should use before computing a sparse factorization
+// (usually Cholesky).
 enum OrderingType {
-  NATURAL,
-  AMD
+  NATURAL, // Do not re-order the matrix. This is useful when the
+           // matrix has been ordered using a fill-reducing ordering
+           // already.
+  AMD      // Use the Approximate Minimum Degree algorithm to re-order
+           // the matrix.
 };
 
 class LinearOperator;

internal/ceres/sparse_cholesky.h

@@ -40,8 +40,8 @@
 namespace ceres {
 namespace internal {
 
-// An interface abstracts away the internal details of various sparse
-// linear algebra libraries and offers a simple API for solving
+// An interface that abstracts away the internal details of various
+// sparse linear algebra libraries and offers a simple API for solving
 // symmetric positive definite linear systems using a sparse Cholesky
 // factorization.
 //