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

document macros REF and REF_ALTTEXT #1226

Merged
merged 1 commit into from Feb 6, 2016

Conversation

aG0aep6G
Copy link
Contributor

@aG0aep6G aG0aep6G commented Feb 4, 2016

No description provided.

CyberShadow added a commit that referenced this pull request Feb 6, 2016
document macros REF and REF_ALTTEXT
@CyberShadow CyberShadow merged commit a34cd8e into dlang:master Feb 6, 2016
@CyberShadow
Copy link
Member

Not that it really matters, but this kinda seems like a misuse of the COMMENT macro, since it's not doing anything here and someone looking at the code might think it does. Maybe we could use _= as a sort of comment prefix (like // in C/D).

@aG0aep6G aG0aep6G deleted the REF-documentation branch February 8, 2016 22:04
@aG0aep6G
Copy link
Contributor Author

aG0aep6G commented Feb 8, 2016

Not that it really matters, but this kinda seems like a misuse of the COMMENT macro, since it's not doing anything here and someone looking at the code might think it does. Maybe we could use _= as a sort of comment prefix (like // in C/D).

I think COMMENT is the equivalent of //. It's defined as nothing in macros.ddoc, and it doesn't seem to be overridden anywhere. There's also DDOC_COMMENT which is defined as an HTML comment in html.ddoc. I would have named them the other way around, though.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants