Objective-C Readability CL for bauerb.

chrome/browser/ui/cocoa/table_model_array_controller.h

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_UI_COCOA_TABLE_MODEL_ARRAY_CONTROLLER_H_
 #define CHROME_BROWSER_UI_COCOA_TABLE_MODEL_ARRAY_CONTROLLER_H_
 #pragma once
 
 #import <Cocoa/Cocoa.h>
 
 #include "app/table_model_observer.h"
 #include "base/cocoa_protocols_mac.h"
 #include "base/scoped_nsobject.h"
 #include "base/scoped_ptr.h"
 
 class RemoveRowsObserverBridge;
 class RemoveRowsTableModel;
 @class TableModelArrayController;
 
 // This class functions as an adapter from a RemoveRowsTableModel to a Cocoa
 // NSArrayController, to be used with bindings.

[dmac, 2011/01/06 06:04:05]

grammar nit: this first sentence needs some work

[Bernhard Bauer, 2011/01/08 15:41:02]

Ok, I hope it sounds a bit less awkward now.

 // It maps the CanRemoveRows method to its canRemove property, and exposes
 // RemoveRows and RemoveAll as actions (remove: and removeAll:).
 // If the table model has groups, these are inserted into the list of arranged
 // objects as group rows.
 // The designated initializer is the same as for NSArrayController,
 // initWithContent:, but usually this class is instantiated from a nib file.
 // Clicking on a group row selects all rows belonging to that group, like it
 // does in a Windows table_view.
 // In order to show group rows, this class must be the delegate of the
 // NSTableView.
@@ skipping 13 matching lines @@
 // groups, it can be nil.
 - (void)bindToTableModel:(RemoveRowsTableModel*)model
              withColumns:(NSDictionary*)columns
         groupTitleColumn:(NSString*)groupTitleColumn;
 
 - (IBAction)removeAll:(id)sender;
 
 @end
 
 #endif  // CHROME_BROWSER_UI_COCOA_TABLE_MODEL_ARRAY_CONTROLLER_H_
+