rephrase a few sentences (#3766)

Minor tweaks while reading through the docs to hopefully improve
readability.
This commit is contained in:
Nathan Youngman
2024-03-13 22:03:34 +00:00
committed by GitHub
parent 6c6b3b6618
commit 10189bbb78
4 changed files with 15 additions and 16 deletions
+5 -5
View File
@@ -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
+3 -3
View File
@@ -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.
+5 -5
View File
@@ -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