Skip to content
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

Add docstring and attribute support to interfaces #25825

Merged

Conversation

jabraham17
Copy link
Member

@jabraham17 jabraham17 commented Aug 27, 2024

Adds compiler support for interfaces to have attributes applied to them and have docstrings recognized by chpldoc

Resolves #17383

Relies on chapel-lang/sphinxcontrib-chapeldomain#95

This PR also updates the interface Allocators.allocator. #25821 will update the existing Sort module allocators. No other allocators are currently shown in our documentation

While adding tests of @unstable with interfaces, I found that some tests weren't actually testing what we thought they were (i.e. test/unstable-keyword/enum_test1.chpl), so I updated them

Testing

  • full paratest with/without comm

[Reviewed by @lydia-duncan and @DanilaFe]

Signed-off-by: Jade Abraham <[email protected]>
Signed-off-by: Jade Abraham <[email protected]>
Signed-off-by: Jade Abraham <[email protected]>
Signed-off-by: Jade Abraham <[email protected]>
Signed-off-by: Jade Abraham <[email protected]>
jabraham17 added a commit to chapel-lang/sphinxcontrib-chapeldomain that referenced this pull request Aug 28, 2024
Adds support for `interface`, which will be outputed by chpldoc after
chapel-lang/chapel#25825

[Reviewed by @lydia-duncan]
Signed-off-by: Jade Abraham <[email protected]>
Signed-off-by: Jade Abraham <[email protected]>
@jabraham17 jabraham17 marked this pull request as ready for review August 28, 2024 16:21
Signed-off-by: Jade Abraham <[email protected]>
Copy link
Member

@lydia-duncan lydia-duncan left a comment

Choose a reason for hiding this comment

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

Very minor nits but otherwise this looks good to me for the parts I felt I could accurately review

modules/standard/Allocators.chpl Outdated Show resolved Hide resolved
modules/standard/Allocators.chpl Outdated Show resolved Hide resolved
test/unstable-keyword/enum_test1.good Show resolved Hide resolved
Signed-off-by: Jade Abraham <[email protected]>
Copy link
Contributor

@DanilaFe DanilaFe left a comment

Choose a reason for hiding this comment

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

parser changes look good to me

@jabraham17 jabraham17 merged commit 42f8bb0 into chapel-lang:main Aug 28, 2024
7 checks passed
@jabraham17 jabraham17 deleted the interfaces-with-docs-and-attributes branch August 28, 2024 18:58
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.

Implement support for interfaces in chpldoc
3 participants