mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 19:00:11 +01:00
rephrase a few sentences (#3766)
Minor tweaks while reading through the docs to hopefully improve readability.
This commit is contained in:
@@ -1304,9 +1304,9 @@ fn Positive(a: i64) -> auto {
|
||||
A _block_ is a sequence of _statements_. A block defines a
|
||||
[scope](#declarations-definitions-and-scopes) and, like other scopes, is
|
||||
enclosed in curly braces (`{`...`}`). Each statement is terminated by a
|
||||
semicolon or block. [Expressions](#expressions), [assignments](assignment.md)
|
||||
and [`var`](#variable-var-declarations) and [`let`](#constant-let-declarations)
|
||||
are valid statements.
|
||||
semicolon or block. [Expressions](#expressions), [assignments](assignment.md),
|
||||
[`var`](#variable-var-declarations) and [`let`](#constant-let-declarations) are
|
||||
valid statements.
|
||||
|
||||
Statements within a block are normally executed in the order they appear in the
|
||||
source code, except when modified by control-flow statements.
|
||||
@@ -3731,8 +3731,8 @@ In conclusion, there are two patterns in how Carbon diverges from C++:
|
||||
|
||||
- Simplify and removing things to create space for new safety features. This
|
||||
trivially requires breaking backwards compatibility.
|
||||
- Re-engineer foundations to model and enforce safety. This has complex and
|
||||
difficulty in C++ without first simplifying the language.
|
||||
- Re-engineer foundations to model and enforce safety. This is complex and
|
||||
difficult in C++ without first simplifying the language.
|
||||
|
||||
This leads to Carbon's incremental path to safety:
|
||||
|
||||
|
||||
@@ -77,9 +77,8 @@ especially important to the coherence of generics and templates.
|
||||
attempt to observe a property of an incomplete class that is not known until
|
||||
the class is complete renders the program invalid.
|
||||
- When an `impl` needs to be resolved, only those `impl` declarations that
|
||||
have that appear earlier are considered. However, if a later `impl`
|
||||
declaration would change the result of any earlier `impl` lookup, the
|
||||
program is invalid.
|
||||
appear earlier are considered. However, if a later `impl` declaration would
|
||||
change the result of any earlier `impl` lookup, the program is invalid.
|
||||
|
||||
## Exceptions
|
||||
|
||||
|
||||
@@ -694,8 +694,8 @@ Advantages:
|
||||
- Probabilistic safety should come at lower performance cost (including CPU,
|
||||
memory, and disk space).
|
||||
- This will sometimes be significant, and as a result of multiple checks,
|
||||
could be the difference between the hardened build mode being 50% slower
|
||||
than the performance build mode and being 200% slower.
|
||||
could result in the hardened build mode being 50% slower than the
|
||||
performance build mode instead of being 200% slower.
|
||||
|
||||
Disadvantages:
|
||||
|
||||
@@ -767,5 +767,5 @@ addition. If build modes are added for non-safety-related reasons, this may lead
|
||||
to moving build modes out of the safety strategy.
|
||||
|
||||
**Experiment**: This can be considered an experiment. Carbon may eventually add
|
||||
more than the initial three build modes, although the reticence to add more is
|
||||
more than the initial three build modes, although the reluctance to add more is
|
||||
likely to remain.
|
||||
|
||||
@@ -52,8 +52,8 @@ This goal is not necessarily about complete support for the entire language
|
||||
design, but rather enough of it to support building the realistic and
|
||||
interesting Carbon code that interoperates with C++.
|
||||
|
||||
Some example language features that we think are key to success here but far
|
||||
from an exhaustive list:
|
||||
Here are some example language features that we think are key to success, but
|
||||
this is far from an exhaustive list:
|
||||
|
||||
- Imports and a working [prelude] (the earliest stages of a standard library)
|
||||
- Operator overloading and dispatch for expressions
|
||||
@@ -125,9 +125,9 @@ subsequent years.
|
||||
As we adjust our schedule and roadmap to reflect the realistic rate of progress,
|
||||
the _earliest_ it seems feasible to have everything we need to evaluate the 0.1
|
||||
language is 2025. We're starting to be optimistic in 2024 that we'll be able to
|
||||
hit this in 2025, but ultimately this remains a lower bound. We may discover as
|
||||
we progress things that further push out the schedule here. That is the nature
|
||||
of an experimental project like Carbon.
|
||||
hit this in 2025, but ultimately this remains a lower bound. As we progress, we
|
||||
may discover things that push the schedule out further. That is the nature of an
|
||||
experimental project like Carbon.
|
||||
|
||||
We expect that once we reach this milestone the community will be able to start
|
||||
realistically evaluating Carbon as a C++ successor language. Of course, this
|
||||
|
||||
Reference in New Issue
Block a user