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

Fix up documentation around no_std #34838

Merged
merged 1 commit into from
Jul 17, 2016
Merged

Conversation

steveklabnik
Copy link
Member

  1. Fix the sections in the book to have the correct signatures. I've
    also marked them as ignore; there's no way to set the no_std
    feature for libc, so it pulls in the stdlib, so this wasn't even
    testing the actual thing it was testing. Better to just ignore.
  2. Correcting libcore's docs for factual inaccuracy, and add a note
    about language items.

Fixes #33677

r? @alexcrichton

@alexcrichton
Copy link
Member

I wonder if we can also make sure these is all plastered with "zomg this is unstable"? Documenting things like symbol names makes me a little queasy as I don't want anyone relying on that ever basically

# #[no_mangle] pub extern fn rust_eh_register_frames () {}
# #[no_mangle] pub extern fn rust_eh_unregister_frames () {}
# // fn main() {} tricked you, rustdoc!
// These functions and traits are used by the compiler, but not
Copy link
Member

Choose a reason for hiding this comment

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

No traits here though?

Copy link
Member Author

Choose a reason for hiding this comment

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

Whoops, this was just the previous text.

@steveklabnik
Copy link
Member Author

I wonder if we can also make sure these is all plastered with "zomg this is unstable"?

So, the book part is explicitly in "unstable rust", but making it more clear in libcore's docs is something I can do!

@alexcrichton
Copy link
Member

Ok! Sounds good to me, looks like travis failure is legit though:

run doc-book-no-stdlib [x86_64-unknown-linux-gnu]

running 2 tests

test _0 ... ignored

test _1 ... FAILED

failures:

---- _1 stdout ----

    <anon>:7:1: 7:19 error: use of unstable library feature 'libc': use `libc` from crates.io (see issue #27783)

<anon>:7 extern crate libc;

         ^~~~~~~~~~~~~~~~~~

<anon>:7:1: 7:19 help: add #![feature(libc)] to the crate attributes to enable

error: aborting due to previous error(s)

thread '_1' panicked at 'Box<Any>', src/librustc/session/mod.rs:170

note: Run with `RUST_BACKTRACE=1` for a backtrace.

failures:

    _1

test result: FAILED. 0 passed; 1 failed; 1 ignored; 0 measured

r=me other than that though

1. Fix the sections in the book to have the correct signatures. I've
   also marked them as `ignore`; there's no way to set the `no_std`
   feature for libc, so it pulls in the stdlib, so this wasn't even
   testing the actual thing it was testing. Better to just ignore.
2. Correcting libcore's docs for factual inaccuracy, and add a note
   about language items.

Fixes rust-lang#33677
@steveklabnik
Copy link
Member Author

Whoops, I was checking as I wrote it, but missed it in the end. Should be good now, let's see what travis says.

@alexcrichton
Copy link
Member

@bors: r+ fcecdac

@GuillaumeGomez
Copy link
Member

@bors: rollup

GuillaumeGomez added a commit to GuillaumeGomez/rust that referenced this pull request Jul 16, 2016
Fix up documentation around no_std

1. Fix the sections in the book to have the correct signatures. I've
   also marked them as `ignore`; there's no way to set the `no_std`
   feature for libc, so it pulls in the stdlib, so this wasn't even
   testing the actual thing it was testing. Better to just ignore.
2. Correcting libcore's docs for factual inaccuracy, and add a note
   about language items.

Fixes rust-lang#33677

r? @alexcrichton
bors added a commit that referenced this pull request Jul 17, 2016
Rollup of 7 pull requests

- Successful merges: #33362, #34768, #34837, #34838, #34847, #34848, #34849
- Failed merges: #33951, #34850
@bors bors merged commit fcecdac into rust-lang:master Jul 17, 2016
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.

4 participants