reflow comments in platform/fonts

third_party/WebKit/Source/platform/fonts/mac/FontFamilyMatcherMac.mm

 /*
  * Copyright (C) 2006, 2007, 2008, 2009 Apple Inc. All rights reserved.
  * Copyright (C) 2007 Nicholas Shanks <webkit@nickshanks.com>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
@@ skipping 94 matching lines @@
     BOOL candidateHasUnwantedTrait = desired != ((candidateTraits & mask) != 0);
     if (!candidateHasUnwantedTrait && chosenHasUnwantedTrait)
       return YES;
     if (!chosenHasUnwantedTrait && candidateHasUnwantedTrait)
       return NO;
   }
 
   int chosenWeightDeltaMagnitude = abs(chosenWeight - desiredWeight);
   int candidateWeightDeltaMagnitude = abs(candidateWeight - desiredWeight);
 
-  // If both are the same distance from the desired weight, prefer the candidate if it is further from medium.
+  // If both are the same distance from the desired weight, prefer the candidate
+  // if it is further from medium.
   if (chosenWeightDeltaMagnitude == candidateWeightDeltaMagnitude)
     return abs(candidateWeight - 6) > abs(chosenWeight - 6);
 
   // Otherwise, prefer the one closer to the desired weight.
   return candidateWeightDeltaMagnitude < chosenWeightDeltaMagnitude;
 }
 
-// Family name is somewhat of a misnomer here.  We first attempt to find an exact match
-// comparing the desiredFamily to the PostScript name of the installed fonts.  If that fails
-// we then do a search based on the family names of the installed fonts.
+// Family name is somewhat of a misnomer here.  We first attempt to find an
+// exact match comparing the desiredFamily to the PostScript name of the
+// installed fonts.  If that fails we then do a search based on the family
+// names of the installed fonts.
 NSFont* MatchNSFontFamily(NSString* desiredFamily,
                           NSFontTraitMask desiredTraits,
                           FontWeight desiredWeight,
                           float size) {
   if ([desiredFamily isEqualToString:@"BlinkMacSystemFont"]) {
     // On OSX 10.9, the default system font depends on the SDK version. When
     // compiled against the OSX 10.10 SDK, the font is .LucidaGrandeUI. When
     // compiled against the OSX 10.6 SDK, the font is Lucida Grande. Layout
     // tests don't support different expectations based on the SDK version,
     // so force layout tests to use "Lucida Grande". Once the 10.10 SDK
@@ skipping 22 matching lines @@
     if (desiredTraits & IMPORTANT_FONT_TRAITS)
       font = [[NSFontManager sharedFontManager] convertFont:font
                                                 toHaveTrait:desiredTraits];
     return font;
   }
 
   NSFontManager* fontManager = [NSFontManager sharedFontManager];
 
   // Do a simple case insensitive search for a matching font family.
   // NSFontManager requires exact name matches.
-  // This addresses the problem of matching arial to Arial, etc., but perhaps not all the issues.
+  // This addresses the problem of matching arial to Arial, etc., but perhaps
+  // not all the issues.
   NSEnumerator* e = [[fontManager availableFontFamilies] objectEnumerator];
   NSString* availableFamily;
   while ((availableFamily = [e nextObject])) {
     if ([desiredFamily caseInsensitiveCompare:availableFamily] == NSOrderedSame)
       break;
   }
 
   int appKitFontWeight = toAppKitFontWeight(desiredWeight);
   if (!availableFamily) {
     // Match by PostScript name.
     NSEnumerator* availableFonts =
         [[fontManager availableFonts] objectEnumerator];
     NSString* availableFont;
     NSFont* nameMatchedFont = nil;
     NSFontTraitMask desiredTraitsForNameMatch =
         desiredTraits | (appKitFontWeight >= 7 ? NSBoldFontMask : 0);
     while ((availableFont = [availableFonts nextObject])) {
       if ([desiredFamily caseInsensitiveCompare:availableFont] ==
           NSOrderedSame) {
         nameMatchedFont = [NSFont fontWithName:availableFont size:size];
 
-        // Special case Osaka-Mono.  According to <rdar://problem/3999467>, we need to
-        // treat Osaka-Mono as fixed pitch.
+        // Special case Osaka-Mono.  According to <rdar://problem/3999467>, we
+        // need to treat Osaka-Mono as fixed pitch.
         if ([desiredFamily caseInsensitiveCompare:@"Osaka-Mono"] ==
                 NSOrderedSame &&
             desiredTraitsForNameMatch == 0)
           return nameMatchedFont;
 
         NSFontTraitMask traits = [fontManager traitsOfFont:nameMatchedFont];
         if ((traits & desiredTraitsForNameMatch) == desiredTraitsForNameMatch)
           return [fontManager convertFont:nameMatchedFont
                               toHaveTrait:desiredTraitsForNameMatch];
 
@@ skipping 51 matching lines @@
 
   NSFontTraitMask actualTraits = 0;
   if (desiredTraits & NSFontItalicTrait)
     actualTraits = [fontManager traitsOfFont:font];
   int actualWeight = [fontManager weightOfFont:font];
 
   bool syntheticBold = appKitFontWeight >= 7 && actualWeight < 7;
   bool syntheticItalic = (desiredTraits & NSFontItalicTrait) &&
                          !(actualTraits & NSFontItalicTrait);
 
-  // There are some malformed fonts that will be correctly returned by -fontWithFamily:traits:weight:size: as a match for a particular trait,
-  // though -[NSFontManager traitsOfFont:] incorrectly claims the font does not have the specified trait. This could result in applying
-  // synthetic bold on top of an already-bold font, as reported in <http://bugs.webkit.org/show_bug.cgi?id=6146>. To work around this
-  // problem, if we got an apparent exact match, but the requested traits aren't present in the matched font, we'll try to get a font from
-  // the same family without those traits (to apply the synthetic traits to later).
+  // There are some malformed fonts that will be correctly returned by
+  // -fontWithFamily:traits:weight:size: as a match for a particular trait,
+  // though -[NSFontManager traitsOfFont:] incorrectly claims the font does not
+  // have the specified trait. This could result in applying
+  // synthetic bold on top of an already-bold font, as reported in
+  // <http://bugs.webkit.org/show_bug.cgi?id=6146>. To work around this
+  // problem, if we got an apparent exact match, but the requested traits
+  // aren't present in the matched font, we'll try to get a font from the same
+  // family without those traits (to apply the synthetic traits to later).
   NSFontTraitMask nonSyntheticTraits = desiredTraits;
 
   if (syntheticBold)
     nonSyntheticTraits &= ~NSBoldFontMask;
 
   if (syntheticItalic)
     nonSyntheticTraits &= ~NSItalicFontMask;
 
   if (nonSyntheticTraits != desiredTraits) {
     NSFont* fontWithoutSyntheticTraits =
@@ skipping 17 matching lines @@
       6,   // FontWeight500
       8,   // FontWeight600
       9,   // FontWeight700
       10,  // FontWeight800
       12,  // FontWeight900
   };
   return appKitFontWeights[fontWeight];
 }
 
 }  // namespace blink