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

Intro of rustc in docs should mention debug/optimization #22330

Closed
tanadeau opened this Issue Feb 14, 2015 · 3 comments

Comments

Projects
None yet
2 participants
@tanadeau
Copy link
Contributor

tanadeau commented Feb 14, 2015

Mentions of the use of the rustc binary in the docs (such as the "Hello, World!" section in the Rust book) should mention that no optimizations are performed unless the -O or similar flag is given. They should also give a quick overview of the debug/optimization differences and use-cases. This distinction is often new to users coming from JIT'ed/interpreted languages.

@steveklabnik steveklabnik added the A-docs label Feb 14, 2015

@steveklabnik

This comment has been minimized.

Copy link
Member

steveklabnik commented Feb 17, 2015

You can't mention every possibe aspect all at once. The introduction already takes a very long time to get to actual code, and I don't want to pollute it any further.

@tanadeau

This comment has been minimized.

Copy link
Contributor Author

tanadeau commented Feb 17, 2015

@steveklabnik Would you be open to an entirely new section that is referenced from the intro location? If so, I'll create that issue.

@steveklabnik

This comment has been minimized.

Copy link
Member

steveklabnik commented Feb 17, 2015

I would like an "optimizing and debugging Rust" chapter in the book, but I'm not tracking chapter feature requests currently.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.