[Mac] Omnibox keyword, keyword hint, and search hint support....

chrome/browser/cocoa/autocomplete_text_field_editor.h

 // Copyright (c) 2009 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.
 
 #import <Cocoa/Cocoa.h>
 
+// AutocompleteTextFieldEditor customized the AutocompletTextField
+// field editor (helper text-view used in editing).  It intercepts UI
+// events for forwarding to the core Omnibox code.  It also undoes
+// some of the effects of using styled text in the Omnibox (the text
+// is styled but should not appear that way when copied to the
+// pasteboard).
+
+// AutocompleteTextFieldEditorDelegateMethods are meant to be similar
+// to NSTextView delegate methods, adding additional intercepts
+// relevant to the Omnibox implementation.
+
 @protocol AutocompleteTextFieldEditorDelegateMethods
 
 // Delegate -paste: implementation to the field being edited.  If the
 // delegate returns YES, or does not implement the method, NSTextView
 // is called to handle the paste.  The delegate can block the paste
 // (or handle it internally) by returning NO.
 - (BOOL)textShouldPaste:(NSText*)fieldEditor;
 
 @end
 
 // Field editor used for the autocomplete field.
 @interface AutocompleteTextFieldEditor : NSTextView {
 }
 
 // Copy contents of the TextView to the designated clipboard as plain
 // text.
 - (void)performCopy:(NSPasteboard*)pb;
 
 // Same as above, note that this calls through to performCopy.
 - (void)performCut:(NSPasteboard*)pb;
 
 // Called by -paste: to decide whether to forward to superclass.
 // Exposed for unit testing.
 - (BOOL)shouldPaste;
 
 @end