Clarify ProgramEvaluator comments.
diff --git a/internal/ceres/program_evaluator.h b/internal/ceres/program_evaluator.h index 8c23e2e..7ec74b1 100644 --- a/internal/ceres/program_evaluator.h +++ b/internal/ceres/program_evaluator.h
@@ -37,9 +37,13 @@ // - A "JacobianWriter" that is responsible for storing the resulting // jacobian blocks in the passed sparse matrix. // -// This abstraction affords a evaluator implementation while still efficiently -// supporting multiple sparse matrices in the backend. This evaluator -// implementation is threaded using OpenMP. +// This abstraction affords an efficient evaluator implementation while still +// supporting writing to multiple sparse matrix formats. For example, when the +// ProgramEvaluator is parameterized for writing to block sparse matrices, the +// residual jacobians are written directly into their final position in the +// block sparse matrix by the user's CostFunction; there is no copying. +// +// The evaluation is threaded with OpenMP. // // The EvaluatePreparer and JacobianWriter interfaces are as follows: //