-
Notifications
You must be signed in to change notification settings - Fork 10.5k
Remove \brief commands from doxygen comments. #21017
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
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds great to me!
@swift-ci Please test |
Next up on the chopping block: the really old style of "FooMethod - Does the foo thing." |
5555e2b
to
eb951be
Compare
@swift-ci test |
1 similar comment
@swift-ci test |
Build failed |
Build failed |
We've been running doxygen with the autobrief option for a couple of years now. This makes the \brief markers into our comments redundant. Since they are a visual distraction and we don't want to encourage more \brief markers in new code either, this patch removes them all. Patch produced by for i in $(git grep -l '\\brief'); do perl -pi -e 's/\\brief //g' $i & done
eb951be
to
a9b4b6a
Compare
@swift-ci test and merge |
a9b4b6a
to
ff63eae
Compare
@swift-ci test and merge |
1 similar comment
@swift-ci test and merge |
That test failure looks unrelated. @swift-ci smoke test |
[This is analogous to LLVM r331272 and CFE r331834]
We've been running doxygen with the autobrief option for a couple of
years now. This makes the \brief markers into our comments
redundant. Since they are a visual distraction and we don't want to
encourage more \brief markers in new code either, this patch removes
them all.
Patch produced by