diff options
author | Melody Horn <melody@boringcactus.com> | 2020-10-28 17:01:55 -0600 |
---|---|---|
committer | Melody Horn <melody@boringcactus.com> | 2020-10-28 17:01:55 -0600 |
commit | edf87f09045e8f56576b37078b4a0d220d6ddf55 (patch) | |
tree | 4503afb80ee7ea068db257c6381541a5fe1f716b /index.md | |
parent | 72e8cabe8e3c8ae272fb4771f0d1dabb306dc2ae (diff) | |
download | spec-edf87f09045e8f56576b37078b4a0d220d6ddf55.tar.gz spec-edf87f09045e8f56576b37078b4a0d220d6ddf55.zip |
start using Sphinx for doc generation
Diffstat (limited to 'index.md')
-rw-r--r-- | index.md | 39 |
1 files changed, 0 insertions, 39 deletions
diff --git a/index.md b/index.md deleted file mode 100644 index f20cb69..0000000 --- a/index.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Introduction ---- - -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 (or even true) in any way.** - -Crowbar is a language that is derived from (and, wherever possible, interoperable with) C, and aims to remove as many [footgun](https://en.wiktionary.org/wiki/footgun)s and as much needless complexity from C as possible while still being familiar to C developers. - -Ideally, a typical C codebase should be straightforward to rewrite in Crowbar, and any atypical C constructions not supported by Crowbar can be left as C. - -# Motivation - -- [Rust is not a good C replacement](https://drewdevault.com/2019/03/25/Rust-is-not-a-good-C-replacement.html) - -# Journal - -- [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) -- [Crowbar: Turns out, language development is hard](https://www.boringcactus.com/2020/10/19/crowbar-3-this-is-tough.html) - -# Comparison with C - -The [comparison with C](vs-c.md) is an informal overview of the places where Crowbar and C diverge. - -# Syntax - -[Read the Syntax chapter of the spec.](syntax.md) - -# Semantics - -TODO - -# Discuss - -- [announcement mailing list](https://lists.sr.ht/~boringcactus/crowbar-lang-announce) -- [permanent discussion mailing list](https://lists.sr.ht/~boringcactus/crowbar-lang-devel) -- ephemeral discussions via IRC: #crowbar-lang on freenode ([join via irc](ircs://chat.freenode.net/#crowbar-lang), [join via web](https://webchat.freenode.net/#crowbar-lang)) |