Omnibox - Add About Flag to Reverse Title and URLs in the Dropdown

components/omnibox/autocomplete_match.h

 // Copyright 2014 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 COMPONENTS_OMNIBOX_AUTOCOMPLETE_MATCH_H_
 #define COMPONENTS_OMNIBOX_AUTOCOMPLETE_MATCH_H_
 
 #include <map>
 #include <string>
 #include <vector>
 
 #include "base/memory/scoped_ptr.h"
+#include "components/omnibox/autocomplete_input.h"
 #include "components/omnibox/autocomplete_match_type.h"
 #include "components/search_engines/template_url.h"
 #include "ui/base/page_transition_types.h"
 #include "url/gurl.h"
 
 class AutocompleteProvider;
 class SuggestionAnswer;
 class TemplateURL;
 class TemplateURLService;
 
@@ skipping 229 matching lines @@
   // such as keyword engine matches or extension-provided matches, aren't
   // detected by this IsVerbatimType, as the user will not be able to infer
   // what will happen when he or she presses enter in those cases if the match
   // is not shown.
   bool IsVerbatimType() const;
 
   // Returns whether this match or any duplicate of this match can be deleted.
   // This is used to decide whether we should call DeleteMatch().
   bool SupportsDeletion() const;
 
+  // For some inputs, possibly swaps the contents and descriptions fields and
+  // their associated classifications for a URL suggestion.  This is meant to
+  // emphasize descriptions (i.e., titles of URLs) rather than the contents
+  // (i.e., the URL itself) under some conditions.

[Peter Kasting, 2015/05/21 21:55:33]

Nit: How about:

Swaps the contents and description fields, and their associated classifications,
if this is a match for which we should emphasize the title (in the description
field) over the URL (in the contents field).  See the implementation for the
conditions under which this is true.

[Mark P, 2015/05/22 22:51:29]

Sure, that sounds cleaner.

+  void PossiblySwapContentsAndDescriptionForURLSuggestion(
+      const AutocompleteInput& input);
+
   // The provider of this match, used to remember which provider the user had
   // selected when the input changes. This may be NULL, in which case there is
   // no provider (or memory of the user's selection).
   AutocompleteProvider* provider;
 
   // The relevance of this match. See table in autocomplete.h for scores
   // returned by various providers. This is used to rank matches among all
   // responding providers, so different providers must be carefully tuned to
   // supply matches with appropriate relevance.
   //
@@ skipping 113 matching lines @@
       const base::string16& text,
       const ACMatchClassifications& classifications) const;
 #endif
 };
 
 typedef AutocompleteMatch::ACMatchClassification ACMatchClassification;
 typedef std::vector<ACMatchClassification> ACMatchClassifications;
 typedef std::vector<AutocompleteMatch> ACMatches;
 
 #endif  // COMPONENTS_OMNIBOX_AUTOCOMPLETE_MATCH_H_