url_formatter: Update comments for clarity.

components/url_formatter/url_formatter_unittest.cc

 // Copyright 2015 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.
 
 #include "components/url_formatter/url_formatter.h"
 
 #include <stddef.h>
 #include <string.h>
 
 #include <vector>
 
 #include "base/macros.h"
 #include "base/strings/string_number_conversions.h"
 #include "base/strings/stringprintf.h"
 #include "base/strings/utf_string_conversions.h"
 #include "testing/gtest/include/gtest/gtest.h"
 #include "url/gurl.h"
 
 
 namespace url_formatter {
 
 namespace {
 
 using base::WideToUTF16;
 using base::ASCIIToUTF16;
 
 const size_t kNpos = base::string16::npos;
 
 struct IDNTestCase {
+  // The IDNA/Punycode version of the domain (plain ASCII).
   const char* const input;
+  // The equivalent Unicode version of the domain. Even if we expect the domain
+  // to be displayed in Punycode, this should still contain the Unicode
+  // equivalent (see |unicode_allowed|).
   const wchar_t* unicode_output;
+  // Whether we expect the domain to be displayed decoded as a Unicode string
+  // (true) or in its Punycode form (false).
   const bool unicode_allowed;
 };
 
 // TODO(jshin): Replace L"..." with "..." in UTF-8 when it's easier to read.
 const IDNTestCase idn_cases[] = {
   // No IDN
   {"www.google.com", L"www.google.com", true},
   {"www.google.com.", L"www.google.com.", true},
   {".", L".", true},
   {"", L"", true},
@@ skipping 955 matching lines @@
     0, kNpos, kNpos, kNpos, kNpos, kNpos, kNpos, 0, kNpos, kNpos, kNpos, kNpos,
     0, 1, 2, 3, 4, 5, 6, 7
   };
   CheckAdjustedOffsets("http://user@foo.com/", kFormatUrlOmitAll,
                        net::UnescapeRule::NORMAL, omit_all_offsets);
 }
 
 }  // namespace
 
 }  // namespace url_formatter