Merge pull request swiftlang#219 from akyrtzi/update-changelog-readme

Update Changelog and Readme

Author: akyrtzi

Changelog.md

@@ -2,6 +2,14 @@
 
 Note: This is in reverse chronological order, so newer entries are added to the top.
 
+## Swift 5.3
+
+* Introduced `FunctionCallExprSyntax.additionalTrailingClosures` property with type `MultipleTrailingClosureElementListSyntax?` for supporting [SE-0279 Multiple Trailing Closures](https://github.com/apple/swift-evolution/blob/master/proposals/0279-multiple-trailing-closures.md).
+
+* Introduced `syntaxNodeType` property for all types conforming to `SyntaxProtocol`, which returns the underlying syntax node type. It is primarily intended as a debugging aid during development.
+
+* Provided a clearer error message for the "parser compatibility" error.
+
 ## Swift 5.2
 
 - `ReversedSyntaxChildren` has been removed

README.md

@@ -79,6 +79,27 @@ should be specified with the intended tag.
 Different from building SwiftSyntax from source, declaring SwiftSyntax as a SwiftPM dependency doesn't require
 the Swift compiler source because we always push gyb-generated files to a tag.
 
+### Embedding SwiftSyntax in an Application
+
+SwiftSyntax depends on the `lib_InternalSwiftSyntaxParser.dylib/.so` library which provides a C interface to the underlying Swift C++ parser. When you do `swift build` SwiftSyntax links and uses the library included in the Swift toolchain. If you are building an application make sure to embed `_InternalSwiftSyntaxParser` as part of your application's libraries.
+
+You can either copy `lib_InternalSwiftSyntaxParser.dylib/.so` directly from the toolchain or even build it yourself from the [Swift repository](https://github.com/apple/swift), as long as you are matching the same tags or branches in both the SwiftSyntax and Swift repositories. To build it for the host os (macOS/linux) use the following steps:
+
+```
+git clone https://github.com/apple/swift.git
+./swift/utils/update-checkout --clone
+./swift/utils/build-parser-lib --release --no-assertions --build-dir /tmp/parser-lib-build
+```
+
+### Embedding in an iOS Application
+
+You need to build `lib_InternalSwiftSyntaxParser.dylib` yourself, you cannot copy it from the toolchain. Follow the instructions above and change the invocation of `build-parser-lib` accordingly:
+
+```
+./swift/utils/build-parser-lib --release --no-assertions --build-dir /tmp/parser-lib-build-iossim --host iphonesimulator --architectures x86_64
+./swift/utils/build-parser-lib --release --no-assertions --build-dir /tmp/parser-lib-build-ios --host iphoneos --architectures arm64
+```
+
 ### Some Example Users
 
 [**Swift AST Explorer**](https://swift-ast-explorer.kishikawakatsumi.com/): a Swift AST visualizer.