Skip to content

[llvm] Proofread ProgrammersManual.rst #150787

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

kazutakahirata
Copy link
Contributor

This patch only adds double backticks around code-related terms to
facilitate the review process.

Copy link
Member

@tgymnich tgymnich left a comment

Choose a reason for hiding this comment

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

found some more missing ``. Not sure if all of those should be changed.

StringRef is ideal for passing simple strings around that are known to be live,
either because they are C string literals, std::string, a C array, or a
``StringRef`` is ideal for passing simple strings around that are known to be live,
either because they are C string literals, ``std::string``, a C array, or a
SmallVector. Each of these cases has an efficient implicit conversion to
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
SmallVector. Each of these cases has an efficient implicit conversion to
``SmallVector``. Each of these cases has an efficient implicit conversion to

StringRef is ideal for passing simple strings around that are known to be live,
either because they are C string literals, std::string, a C array, or a
``StringRef`` is ideal for passing simple strings around that are known to be live,
either because they are C string literals, ``std::string``, a C array, or a
SmallVector. Each of these cases has an efficient implicit conversion to
StringRef, which doesn't result in a dynamic strlen being executed.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
StringRef, which doesn't result in a dynamic strlen being executed.
``StringRef``, which doesn't result in a dynamic ``strlen`` being executed.

StringRef is ideal for passing simple strings around that are known to be live,
either because they are C string literals, std::string, a C array, or a
``StringRef`` is ideal for passing simple strings around that are known to be live,
either because they are C string literals, ``std::string``, a C array, or a
SmallVector. Each of these cases has an efficient implicit conversion to
StringRef, which doesn't result in a dynamic strlen being executed.

StringRef has a few major limitations which make more powerful string containers
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
StringRef has a few major limitations which make more powerful string containers
``StringRef`` has a few major limitations which make more powerful string containers

This patch only adds double backticks around code-related terms to
facilitate the review process.
@kazutakahirata kazutakahirata force-pushed the cleanup_20250726_proofread branch from ce79249 to 2fe5f39 Compare July 27, 2025 01:06
@kazutakahirata
Copy link
Contributor Author

@tgymnich Thanks for the review! I've incorporated your suggestions and fixed a few more. Please take a look. Thanks!

``SmallVector``s would trigger an error.
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