auto merge of #7197 : rkbodenner/rust/doc-for-lib-move, r=brson
Was updating some code of mine to use the new `std`/`extra` library names, and noticed a place where docs for `std::libc` hadn't been updated. Then I updated some top-level docs for the new libraries' names, too.
This commit is contained in:
commit
d084d9e7df
4 changed files with 28 additions and 24 deletions
|
|
@ -12,19 +12,20 @@
|
|||
|
||||
# The Rust standard library
|
||||
|
||||
The Rust standard library provides runtime features required by the language,
|
||||
including the task scheduler and memory allocators, as well as library
|
||||
support for Rust built-in types, platform abstractions, and other commonly
|
||||
used features.
|
||||
The Rust standard library is a group of interrelated modules defining
|
||||
the core language traits, operations on built-in data types, collections,
|
||||
platform abstractions, the task scheduler, runtime support for language
|
||||
features and other common functionality.
|
||||
|
||||
`std` includes modules corresponding to each of the integer types, each of
|
||||
the floating point types, the `bool` type, tuples, characters, strings
|
||||
(`str`), vectors (`vec`), managed boxes (`managed`), owned boxes (`owned`),
|
||||
and unsafe and borrowed pointers (`ptr`). Additionally, `std` provides
|
||||
pervasive types (`option` and `result`), task creation and communication
|
||||
primitives (`task`, `comm`), platform abstractions (`os` and `path`), basic
|
||||
I/O abstractions (`io`), common traits (`kinds`, `ops`, `cmp`, `num`,
|
||||
`to_str`), and complete bindings to the C standard library (`libc`).
|
||||
`std` includes modules corresponding to each of the integer types,
|
||||
each of the floating point types, the `bool` type, tuples, characters,
|
||||
strings (`str`), vectors (`vec`), managed boxes (`managed`), owned
|
||||
boxes (`owned`), and unsafe and borrowed pointers (`ptr`, `borrowed`).
|
||||
Additionally, `std` provides pervasive types (`option` and `result`),
|
||||
task creation and communication primitives (`task`, `comm`), platform
|
||||
abstractions (`os` and `path`), basic I/O abstractions (`io`), common
|
||||
traits (`kinds`, `ops`, `cmp`, `num`, `to_str`), and complete bindings
|
||||
to the C standard library (`libc`).
|
||||
|
||||
# Standard library injection and the Rust prelude
|
||||
|
||||
|
|
@ -38,7 +39,7 @@ with the `std::` path prefix, as in `use std::vec`, `use std::task::spawn`,
|
|||
etc.
|
||||
|
||||
Additionally, `std` contains a `prelude` module that reexports many of the
|
||||
most common std modules, types and traits. The contents of the prelude are
|
||||
most common types, traits and functions. The contents of the prelude are
|
||||
imported into every *module* by default. Implicitly, all modules behave as if
|
||||
they contained the following prologue:
|
||||
|
||||
|
|
@ -66,7 +67,7 @@ they contained the following prologue:
|
|||
#[deny(non_camel_case_types)];
|
||||
#[deny(missing_doc)];
|
||||
|
||||
// Make core testable by not duplicating lang items. See #2912
|
||||
// Make std testable by not duplicating lang items. See #2912
|
||||
#[cfg(test)] extern mod realstd(name = "std");
|
||||
#[cfg(test)] pub use kinds = realstd::kinds;
|
||||
#[cfg(test)] pub use ops = realstd::ops;
|
||||
|
|
|
|||
|
|
@ -14,8 +14,8 @@
|
|||
* This module contains bindings to the C standard library,
|
||||
* organized into modules by their defining standard.
|
||||
* Additionally, it contains some assorted platform-specific definitions.
|
||||
* For convenience, most functions and types are reexported from `core::libc`,
|
||||
* so `pub use core::libc::*` will import the available
|
||||
* For convenience, most functions and types are reexported from `std::libc`,
|
||||
* so `pub use std::libc::*` will import the available
|
||||
* C bindings as appropriate for the target platform. The exact
|
||||
* set of functions available are platform specific.
|
||||
*
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue