Use Builder to construct your source was: truffle-api-changes #396

[Jaroslav Tulach]

Hi.
We are moving towards builder-like style to build an instance of Source. Use:

Source.newBuilder(something).
  name(something).
  mimeType(something).
  build();

When working on this change I learned one[1] or two[2] things about builders.
-jt

[1] http://wiki.apidesign.org/wiki/ChameleonBuilder
[2] http://wiki.apidesign.org/wiki/ResistingBuilder


> Added Classes
> -------------
> 
> com.oracle.truffle.api.source.MissingMIMETypeException
> com.oracle.truffle.api.source.MissingNameException
> com.oracle.truffle.api.source.Source$Builder
> 
> Added Nested Classes
> --------------------
> 
> com.oracle.truffle.api.source.Source:   inner public final
> com.oracle.truffle.api.source.Source$Builder
> 
> Added Methods
> -------------
> 
> com.oracle.truffle.api.source.Source:   method public boolean
> com.oracle.truffle.api.source.Source.isInternal()
> com.oracle.truffle.api.source.Source:   method public static
> com.oracle.truffle.api.source.Source$Builder
> com.oracle.truffle.api.source.Source.newBuilder(java.io.File)
> com.oracle.truffle.api.source.Source:   method public static
> com.oracle.truffle.api.source.Source$Builder
> com.oracle.truffle.api.source.Source.newBuilder(java.io.Reader)
> com.oracle.truffle.api.source.Source:   method public static
> com.oracle.truffle.api.source.Source$Builder
> com.oracle.truffle.api.source.Source.newBuilder(java.lang.String)
> com.oracle.truffle.api.source.Source:   method public static
> com.oracle.truffle.api.source.Source$Builder
> com.oracle.truffle.api.source.Source.newBuilder(java.net.URL)
> 
> Added Annotations
> -----------------
> 
> com.oracle.truffle.api.source.Source.fromFileName:          anno 0
> java.lang.Deprecated() com.oracle.truffle.api.source.Source.fromFileName:  
>        anno 0 java.lang.Deprecated()
> com.oracle.truffle.api.source.Source.fromFileName:          anno 0
> java.lang.Deprecated() com.oracle.truffle.api.source.Source.fromReader:    
>        anno 0 java.lang.Deprecated()
> com.oracle.truffle.api.source.Source.fromText:              anno 0
> java.lang.Deprecated() com.oracle.truffle.api.source.Source.fromURL:       
>        anno 0 java.lang.Deprecated()
> com.oracle.truffle.api.source.Source.getShortName:          anno 0
> java.lang.Deprecated() com.oracle.truffle.api.source.Source.withMimeType:  
>        anno 0 java.lang.Deprecated()