aboutsummaryrefslogtreecommitdiff
path: root/index.md
diff options
context:
space:
mode:
authorMelody Horn <melody@boringcactus.com>2020-10-19 16:27:42 -0600
committerMelody Horn <melody@boringcactus.com>2020-10-19 16:27:42 -0600
commit239fdd456e72a08465e8ef51bff12d5dbfac43dc (patch)
tree488aff3b7fb246b68dac101ec7462368886b129c /index.md
parenta6543cd772b22889e17b59507d7fbf6fd8a41bc1 (diff)
downloadspec-239fdd456e72a08465e8ef51bff12d5dbfac43dc.tar.gz
spec-239fdd456e72a08465e8ef51bff12d5dbfac43dc.zip
super rough draft of memory safety
Diffstat (limited to 'index.md')
-rw-r--r--index.md53
1 files changed, 31 insertions, 22 deletions
diff --git a/index.md b/index.md
index f9f71e9..72e2572 100644
--- a/index.md
+++ b/index.md
@@ -1,22 +1,31 @@
----
-title: Crowbar Spec
----
-
-This is entirely a work-in-progress, and should not be relied upon to be stable in any way.
-
-# Context
-
-- [Rust is not a good C replacement](https://drewdevault.com/2019/03/25/Rust-is-not-a-good-C-replacement.html)
-
-# cactus's Blog Posts
-
-- [Crowbar: Defining a good C replacement](https://www.boringcactus.com/2020/09/28/crowbar-1-defining-a-c-replacement.html)
-- [Crowbar: Simplifying C's type names](https://www.boringcactus.com/2020/10/13/crowbar-2-simplifying-c-type-names.html)
-
-# Syntax
-
-[Read the Syntax chapter of the spec.](syntax.md)
-
-# Semantics
-
-[![Creative Commons BY-SA License](https://i.creativecommons.org/l/by-sa/4.0/80x15.png)](http://creativecommons.org/licenses/by-sa/4.0/)
+Crowbar: the good parts of C, with a little bit extra.
+
+This is entirely a work-in-progress, and should not be relied upon to be stable in any way.
+
+# Context
+
+- [Rust is not a good C replacement](https://drewdevault.com/2019/03/25/Rust-is-not-a-good-C-replacement.html)
+
+# cactus's Blog Posts
+
+- [Crowbar: Defining a good C replacement](https://www.boringcactus.com/2020/09/28/crowbar-1-defining-a-c-replacement.html)
+- [Crowbar: Simplifying C's type names](https://www.boringcactus.com/2020/10/13/crowbar-2-simplifying-c-type-names.html)
+
+# Additions to C
+
+For Crowbar to be "the good parts of C, with a little bit extra", we must first decide what C lacks.
+C has several widely known footguns, some of which are misfeatures that can simply be not supported, but some of which are insecure-by-default.
+As such, new features must be added to engage the safeties on these proverbial footguns.
+
+- C is generous with memory in ways that are unreliable by default.
+ Crowbar adds [memory safety guarantees](safety.md) to make correctness the default behavior.
+
+# Syntax
+
+[Read the Syntax chapter of the spec.](syntax.md)
+
+# Semantics
+
+TODO
+
+[![Creative Commons BY-SA License](https://i.creativecommons.org/l/by-sa/4.0/80x15.png)](http://creativecommons.org/licenses/by-sa/4.0/)