Skip to content

render EBNF grammar in node kind enums doc comments#545

Merged
OmarTawfik merged 1 commit intomainfrom
OmarTawfik/render-node-kinds-doc-comments
Jul 24, 2023
Merged

render EBNF grammar in node kind enums doc comments#545
OmarTawfik merged 1 commit intomainfrom
OmarTawfik/render-node-kinds-doc-comments

Conversation

@OmarTawfik
Copy link
Copy Markdown
Contributor

No description provided.

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Jul 17, 2023

🦋 Changeset detected

Latest commit: b7ef3a7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
changelog Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@OmarTawfik OmarTawfik force-pushed the OmarTawfik/add-tera-templates branch from 6395685 to 21f916b Compare July 17, 2023 15:09
@OmarTawfik OmarTawfik force-pushed the OmarTawfik/render-node-kinds-doc-comments branch from c8ef711 to d13f8bd Compare July 17, 2023 15:14

// Constructs all documentation headers for the given production, including any sub-statements
// It returns a map from each statement name to its markdown documentation:
fn extract_documentation(
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This looks like a good candidate to refactor the shared EBNF serializer to produce documentation in a single place for all three consumers. However, we are changing how we do versioning soon, so I decided to keep this for now.

@OmarTawfik OmarTawfik marked this pull request as ready for review July 17, 2023 17:19
@OmarTawfik OmarTawfik requested a review from a team as a code owner July 17, 2023 17:19
@OmarTawfik OmarTawfik linked an issue Jul 19, 2023 that may be closed by this pull request
@OmarTawfik OmarTawfik removed a link to an issue Jul 19, 2023
@OmarTawfik OmarTawfik force-pushed the OmarTawfik/add-tera-templates branch from 21f916b to 84715f9 Compare July 24, 2023 08:50
Base automatically changed from OmarTawfik/add-tera-templates to main July 24, 2023 09:15
@OmarTawfik OmarTawfik force-pushed the OmarTawfik/render-node-kinds-doc-comments branch from d13f8bd to 3f80c57 Compare July 24, 2023 11:31
@OmarTawfik OmarTawfik force-pushed the OmarTawfik/render-node-kinds-doc-comments branch from 3f80c57 to b7ef3a7 Compare July 24, 2023 11:56
@OmarTawfik OmarTawfik enabled auto-merge July 24, 2023 11:56
@OmarTawfik OmarTawfik added this pull request to the merge queue Jul 24, 2023
Merged via the queue into main with commit e73658a Jul 24, 2023
@OmarTawfik OmarTawfik deleted the OmarTawfik/render-node-kinds-doc-comments branch July 24, 2023 12:30
@github-actions github-actions bot mentioned this pull request Jul 24, 2023
github-merge-queue bot pushed a commit that referenced this pull request Aug 2, 2023
This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and publish to npm
yourself or [setup this action to publish
automatically](https://github.com/changesets/action#with-publishing). If
you're not ready to do a release yet, that's fine, whenever you add more
changesets to main, this PR will be updated.


# Releases
## @nomicfoundation/slang@0.9.0

### Minor Changes

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add a Rust
Cursor API and refactor the Rust Visitor API to run on top of it.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Move Visitor
et al to node:: namespace, which is where Cursor is.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Rename
`range` functions that return a TextRange to `text_range`

### Patch Changes

- [#543](#543)
[`7a34599`](7a34599)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Move
`syntax::parser::ProductionKind` to `syntax::nodes` namespace.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add
TokenNode.text to the TS API.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add first
pass of Typescript binding to the Cursor API, but no TS Visitor yet.

- [#545](#545)
[`e73658a`](e73658a)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - render EBNF
grammar on top of each `ProductionKind`, `RuleKind`, and `TokenKind`.

- [#558](#558)
[`95bbc50`](95bbc50)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Correct
versioning for `SourceUnitMember` and `ContractMember` children.

## changelog@0.9.0

### Minor Changes

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add a Rust
Cursor API and refactor the Rust Visitor API to run on top of it.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Move Visitor
et al to node:: namespace, which is where Cursor is.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Rename
`range` functions that return a TextRange to `text_range`

### Patch Changes

- [#543](#543)
[`7a34599`](7a34599)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Move
`syntax::parser::ProductionKind` to `syntax::nodes` namespace.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add
TokenNode.text to the TS API.

- [#540](#540)
[`0d04f95`](0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add first
pass of Typescript binding to the Cursor API, but no TS Visitor yet.

- [#545](#545)
[`e73658a`](e73658a)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - render EBNF
grammar on top of each `ProductionKind`, `RuleKind`, and `TokenKind`.

- [#558](#558)
[`95bbc50`](95bbc50)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Correct
versioning for `SourceUnitMember` and `ContractMember` children.

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
rollup-smithbm0p added a commit to rollup-smithbm0p/slang that referenced this pull request Dec 26, 2025
This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and publish to npm
yourself or [setup this action to publish
automatically](https://github.com/changesets/action#with-publishing). If
you're not ready to do a release yet, that's fine, whenever you add more
changesets to main, this PR will be updated.


# Releases
## @nomicfoundation/slang@0.9.0

### Minor Changes

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add a Rust
Cursor API and refactor the Rust Visitor API to run on top of it.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Move Visitor
et al to node:: namespace, which is where Cursor is.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Rename
`range` functions that return a TextRange to `text_range`

### Patch Changes

- [#543](NomicFoundation/slang#543)
[`7a34599`](NomicFoundation/slang@7a34599)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Move
`syntax::parser::ProductionKind` to `syntax::nodes` namespace.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add
TokenNode.text to the TS API.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add first
pass of Typescript binding to the Cursor API, but no TS Visitor yet.

- [#545](NomicFoundation/slang#545)
[`e73658a`](NomicFoundation/slang@e73658a)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - render EBNF
grammar on top of each `ProductionKind`, `RuleKind`, and `TokenKind`.

- [#558](NomicFoundation/slang#558)
[`95bbc50`](NomicFoundation/slang@95bbc50)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Correct
versioning for `SourceUnitMember` and `ContractMember` children.

## changelog@0.9.0

### Minor Changes

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add a Rust
Cursor API and refactor the Rust Visitor API to run on top of it.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Move Visitor
et al to node:: namespace, which is where Cursor is.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Rename
`range` functions that return a TextRange to `text_range`

### Patch Changes

- [#543](NomicFoundation/slang#543)
[`7a34599`](NomicFoundation/slang@7a34599)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Move
`syntax::parser::ProductionKind` to `syntax::nodes` namespace.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add
TokenNode.text to the TS API.

- [#540](NomicFoundation/slang#540)
[`0d04f95`](NomicFoundation/slang@0d04f95)
Thanks [@AntonyBlakey](https://github.com/AntonyBlakey)! - Add first
pass of Typescript binding to the Cursor API, but no TS Visitor yet.

- [#545](NomicFoundation/slang#545)
[`e73658a`](NomicFoundation/slang@e73658a)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - render EBNF
grammar on top of each `ProductionKind`, `RuleKind`, and `TokenKind`.

- [#558](NomicFoundation/slang#558)
[`95bbc50`](NomicFoundation/slang@95bbc50)
Thanks [@OmarTawfik](https://github.com/OmarTawfik)! - Correct
versioning for `SourceUnitMember` and `ContractMember` children.

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
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.

2 participants