Comments.

common/view/view.cpp

@@ -114,7 +114,8 @@ void VIEW::Remove( VIEW_ITEM* aItem )
 
     if( aItem->viewRequiredUpdate() != VIEW_ITEM::NONE )    // prevent from updating a removed item
     {
-        std::vector<VIEW_ITEM*>::iterator item = std::find( m_needsUpdate.begin(), m_needsUpdate.end(), aItem );
+        std::vector<VIEW_ITEM*>::iterator item = std::find( m_needsUpdate.begin(),
+                                                            m_needsUpdate.end(), aItem );
 
         if( item != m_needsUpdate.end() )
             m_needsUpdate.erase( item );

pcbnew/tools/selection_tool.h

@@ -114,9 +114,13 @@ public:
      */
     void AddMenuItem( const TOOL_ACTION& aAction );
 
-    // TODO comments
+    ///> Event sent after an item is selected.
     const TOOL_EVENT SelectedEvent;
+
+    ///> Event sent after an item is deselected.
     const TOOL_EVENT DeselectedEvent;
+
+    ///> Event sent after selection is cleared.
     const TOOL_EVENT ClearedEvent;
 
 private: