<?xml version="1.0" encoding="UTF-8"?>
<commit>
  <added type="array"/>
  <modified type="array">
    <modified>
      <diff>@@ -717,7 +717,20 @@ CPTextFieldStatePlaceholder = CPThemeState(&quot;placeholder&quot;);
 }
 
 /*!
-    Adjusts the text field's size in the application.
+    Size to fit has two behavior, depending on if the receiver is an editable text field or not.
+    
+    For non-editable text fields (typically, a label), sizeToFit will change the frame of the 
+    receiver to perfectly fit the current text in stringValue in the current font, and respecting
+    the current theme values for content-inset, min-size, and max-size.
+    
+    For editable text fields, sizeToFit will ONLY change the HEIGHT of the text field. It will not 
+    change the width of the text field. You can use setFrameSize: with the current height to set the 
+    width, and you can get the size of a string with [CPString sizeWithFont:]. 
+    
+    The logic behind this decision is that most of the time you do not know what content will be placed
+    in an editable text field, so you want to just choose a fixed width and leave it at that size. 
+    However, since you don't know how tall it needs to be if you change the font, sizeToFit will still be
+    useful for making the textfield an appropriate height.
 */
 
 - (void)sizeToFit</diff>
      <filename>AppKit/CPTextField.j</filename>
    </modified>
  </modified>
  <removed type="array"/>
  <parents type="array">
    <parent>
      <id>bee5d36fbfd1ed9f819363bfff6fe2bc3a03c836</id>
    </parent>
  </parents>
  <author>
    <name>Ross Boucher</name>
    <email>ross@280north.com</email>
  </author>
  <url>http://github.com/280north/cappuccino/commit/429dd80409f891d6fda534875e79739714b99318</url>
  <id>429dd80409f891d6fda534875e79739714b99318</id>
  <committed-date>2009-05-20T12:15:55-07:00</committed-date>
  <authored-date>2009-05-20T12:15:55-07:00</authored-date>
  <message>updated documentatino for CPTextField</message>
  <tree>d4439dbc398eae8989e9db18714f564ce923ab95</tree>
  <committer>
    <name>Ross Boucher</name>
    <email>ross@280north.com</email>
  </committer>
</commit>
