Skip to content

[doc] Add a table to map release tags from the compiler to SwiftSyntax. #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 19, 2018

Conversation

nkcsgexi
Copy link
Contributor

No description provided.

@nkcsgexi
Copy link
Contributor Author

@swift-ci please test

README.md Outdated
@@ -26,7 +26,13 @@ let package = Package(
)
```

Replace `<#Specify Release tag#>` by the version of SwiftSyntax that you want to use. Tags will be created for every release of the compiler in the form `swift-4.2-RELEASE` and for every nightly build in the form `swift-4.2-DEVELOPMENT-SNAPSHOT-2018-08-25-a`.
Replace `<#Specify Release tag#>` by the version of SwiftSyntax that you want to use (see the following table for mapping details). Tags will be created for every release of the compiler in the form `swift-4.2-RELEASE` and for every nightly build in the form `swift-4.2-DEVELOPMENT-SNAPSHOT-<DATE>`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tags will be created for every... is confusing and does not reflect the change in the tagging scheme, recommend to change to:

Tags will be created for every nightly build in the form `<SwiftSyntax Release Tag>-DEVELOPMENT-SNAPSHOT-<DATE>`.

@nkcsgexi
Copy link
Contributor Author

@akyrtzi Changed. Mind taking another look?

@mdiep
Copy link

mdiep commented Sep 18, 2018

I'm a little confused personally. Does this need to match the version of swift that you're using?

@nkcsgexi nkcsgexi merged commit bbdb60c into swiftlang:master Sep 19, 2018
@nkcsgexi
Copy link
Contributor Author

@mdiep That's correct. Swift-syntax relies on compiler (swiftc) to generate syntax trees to deserialize. For every major releases of Swift, Syntax tree generated from the compiler can vary structurally. So we have to agree on compatible versions so the parser can generate the tree swift-syntax recognizes, and vice versa. If you have any trouble building your tool on top of swift-syntax, please let us know :)

adevress pushed a commit to adevress/swift-syntax that referenced this pull request Jan 14, 2024
Lint pipeline improvements; fix enabling/disabling of lint rules.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants