mirror of
https://github.com/rust-lang/rust.git
synced 2025-06-05 03:38:29 +00:00
Spelling src/doc
* incompatibilities * invocation * keywords * nonexistent * shakespeare * the * toolchain * transparent Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
This commit is contained in:
parent
c6fb7b9815
commit
b1da6a750b
@ -117,7 +117,7 @@ $ ls formatjson5.profraw
|
|||||||
formatjson5.profraw
|
formatjson5.profraw
|
||||||
```
|
```
|
||||||
|
|
||||||
If `LLVM_PROFILE_FILE` contains a path to a non-existent directory, the missing directory structure will be created. Additionally, the following special pattern strings are rewritten:
|
If `LLVM_PROFILE_FILE` contains a path to a nonexistent directory, the missing directory structure will be created. Additionally, the following special pattern strings are rewritten:
|
||||||
|
|
||||||
- `%p` - The process ID.
|
- `%p` - The process ID.
|
||||||
- `%h` - The hostname of the machine running the program.
|
- `%h` - The hostname of the machine running the program.
|
||||||
|
@ -61,7 +61,7 @@ Diagnostics have the following format:
|
|||||||
/* The file where the span is located.
|
/* The file where the span is located.
|
||||||
Note that this path may not exist. For example, if the path
|
Note that this path may not exist. For example, if the path
|
||||||
points to the standard library, and the rust src is not
|
points to the standard library, and the rust src is not
|
||||||
available in the sysroot, then it may point to a non-existent
|
available in the sysroot, then it may point to a nonexistent
|
||||||
file. Beware that this may also point to the source of an
|
file. Beware that this may also point to the source of an
|
||||||
external crate.
|
external crate.
|
||||||
*/
|
*/
|
||||||
|
@ -66,7 +66,7 @@ After completing these steps you can use rust normally in a native environment.
|
|||||||
|
|
||||||
To cross compile, you'll need to:
|
To cross compile, you'll need to:
|
||||||
|
|
||||||
* Build the rust cross toochain using [rust-bootstrap-armv7-unknown-linux-uclibceabi](https://github.com/lancethepants/rust-bootstrap-armv7-unknown-linux-uclibceabi) or your own built toolchain.
|
* Build the rust cross toolchain using [rust-bootstrap-armv7-unknown-linux-uclibceabi](https://github.com/lancethepants/rust-bootstrap-armv7-unknown-linux-uclibceabi) or your own built toolchain.
|
||||||
* Link your built toolchain with
|
* Link your built toolchain with
|
||||||
|
|
||||||
```text
|
```text
|
||||||
|
@ -123,7 +123,7 @@ There are 3 common ways to compile native C code for UEFI targets:
|
|||||||
targets. Be wary of any includes that are not specifically suitable for UEFI
|
targets. Be wary of any includes that are not specifically suitable for UEFI
|
||||||
targets (especially the C standard library includes are not always
|
targets (especially the C standard library includes are not always
|
||||||
compatible). Freestanding compilations are recommended to avoid
|
compatible). Freestanding compilations are recommended to avoid
|
||||||
incompatibilites.
|
incompatibilities.
|
||||||
|
|
||||||
## Ecosystem
|
## Ecosystem
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@ following principles (in rough priority order):
|
|||||||
* readability
|
* readability
|
||||||
- scan-ability
|
- scan-ability
|
||||||
- avoiding misleading formatting
|
- avoiding misleading formatting
|
||||||
- accessibility - readable and editable by users using the the widest
|
- accessibility - readable and editable by users using the widest
|
||||||
variety of hardware, including non-visual accessibility interfaces
|
variety of hardware, including non-visual accessibility interfaces
|
||||||
- readability of code in contexts without syntax highlighting or IDE
|
- readability of code in contexts without syntax highlighting or IDE
|
||||||
assistance, such as rustc error messages, diffs, grep, and other
|
assistance, such as rustc error messages, diffs, grep, and other
|
||||||
|
@ -6,7 +6,7 @@
|
|||||||
* `[T; expr]`, e.g., `[u32; 42]`, `[Vec<Foo>; 10 * 2 + foo()]` (space after colon, no spaces around square brackets)
|
* `[T; expr]`, e.g., `[u32; 42]`, `[Vec<Foo>; 10 * 2 + foo()]` (space after colon, no spaces around square brackets)
|
||||||
* `*const T`, `*mut T` (no space after `*`, space before type)
|
* `*const T`, `*mut T` (no space after `*`, space before type)
|
||||||
* `&'a T`, `&T`, `&'a mut T`, `&mut T` (no space after `&`, single spaces separating other words)
|
* `&'a T`, `&T`, `&'a mut T`, `&mut T` (no space after `&`, single spaces separating other words)
|
||||||
* `unsafe extern "C" fn<'a, 'b, 'c>(T, U, V) -> W` or `fn()` (single spaces around keyowrds and sigils, and after commas, no trailing commas, no spaces around brackets)
|
* `unsafe extern "C" fn<'a, 'b, 'c>(T, U, V) -> W` or `fn()` (single spaces around keywords and sigils, and after commas, no trailing commas, no spaces around brackets)
|
||||||
* `!` should be treated like any other type name, `Name`
|
* `!` should be treated like any other type name, `Name`
|
||||||
* `(A, B, C, D)` (spaces after commas, no spaces around parens, no trailing comma unless it is a one-tuple)
|
* `(A, B, C, D)` (spaces after commas, no spaces around parens, no trailing comma unless it is a one-tuple)
|
||||||
* `<Baz<T> as SomeTrait>::Foo::Bar` or `Foo::Bar` or `::Foo::Bar` (no spaces around `::` or angle brackets, single spaces around `as`)
|
* `<Baz<T> as SomeTrait>::Foo::Bar` or `Foo::Bar` or `::Foo::Bar` (no spaces around `::` or angle brackets, single spaces around `as`)
|
||||||
|
@ -202,5 +202,5 @@ fn shoot_lasers() {}
|
|||||||
|
|
||||||
#[cfg(feature = "monkeys")] // This is UNEXPECTED, because "monkeys" is not in
|
#[cfg(feature = "monkeys")] // This is UNEXPECTED, because "monkeys" is not in
|
||||||
// the values(feature) list
|
// the values(feature) list
|
||||||
fn write_shakespear() {}
|
fn write_shakespeare() {}
|
||||||
```
|
```
|
||||||
|
@ -6,5 +6,5 @@ The `-Zmove-size-limit=N` compiler flag enables `large_assignments` lints which
|
|||||||
will warn when moving objects whose size exceeds `N` bytes.
|
will warn when moving objects whose size exceeds `N` bytes.
|
||||||
|
|
||||||
Lint warns only about moves in functions that participate in code generation.
|
Lint warns only about moves in functions that participate in code generation.
|
||||||
Consequently it will be ineffective for compiler invocatation that emit
|
Consequently it will be ineffective for compiler invocation that emit
|
||||||
metadata only, i.e., `cargo check` like workflows.
|
metadata only, i.e., `cargo check` like workflows.
|
||||||
|
@ -65,7 +65,7 @@ pub union GenericUnion<T: Copy> { // Unions with non-`Copy` fields are unstable.
|
|||||||
pub const THIS_IS_OKAY: GenericUnion<()> = GenericUnion { field: () };
|
pub const THIS_IS_OKAY: GenericUnion<()> = GenericUnion { field: () };
|
||||||
```
|
```
|
||||||
|
|
||||||
Like transarent `struct`s, a transparent `union` of type `U` has the same
|
Like transparent `struct`s, a transparent `union` of type `U` has the same
|
||||||
layout, size, and ABI as its single non-ZST field. If it is generic over a type
|
layout, size, and ABI as its single non-ZST field. If it is generic over a type
|
||||||
`T`, and all its fields are ZSTs except for exactly one field of type `T`, then
|
`T`, and all its fields are ZSTs except for exactly one field of type `T`, then
|
||||||
it has the same layout and ABI as `T` (even if `T` is a ZST when monomorphized).
|
it has the same layout and ABI as `T` (even if `T` is a ZST when monomorphized).
|
||||||
|
Loading…
Reference in New Issue
Block a user