Index: kernel/src/OptimizerState.cpp
===================================================================
--- kernel/src/OptimizerState.cpp	(revision 441)
+++ kernel/src/OptimizerState.cpp	(working copy)
@@ -13,9 +13,9 @@
 {
 
 //! Constructor
-OptimizerState::OptimizerState(std::string name) : name_(name)
+OptimizerState::OptimizerState() 
 {
-  IMP_LOG(VERBOSE, "OptimizerState constructed " << name << std::endl);
+  IMP_LOG(VERBOSE, "OptimizerState constructed " << std::endl);
 }
 
 
Index: kernel/include/IMP/OptimizerState.h
===================================================================
--- kernel/include/IMP/OptimizerState.h	(revision 441)
+++ kernel/include/IMP/OptimizerState.h	(working copy)
@@ -22,18 +22,25 @@
 class Optimizer;
 
 //! Shared optimizer state.
+/** The OptimizerState update method is called each time the Optimizer commits
+    to a new set of coordinates.
+ */
 class IMPDLLEXPORT OptimizerState : public internal::Object
 {
   friend class Optimizer;
   void set_optimizer(Optimizer* optimizer);
 
 public:
-  OptimizerState(std::string name=std::string());
+  OptimizerState();
   virtual ~OptimizerState();
 
   // Update the state given the current state of the optimizer
   virtual void update() = 0;
 
+  //! Show the OptimizerState
+  /** Show can print out multiple lines and should end 
+      in a newline.
+  */
   virtual void show(std::ostream& out = std::cout) const;
 
   //! \return version and authorship information.