From 426d9c9977489f7adba7f4b554e8466a47e520f1 Mon Sep 17 00:00:00 2001 From: Leo Tenenbaum Date: Wed, 29 Jan 2020 11:37:25 -0500 Subject: made #foreign a part of the language --- README.html | 31 ++++++++++++++----------------- 1 file changed, 14 insertions(+), 17 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index baa360d..e3ea45d 100644 --- a/README.html +++ b/README.html @@ -11,24 +11,24 @@ and there are almost definitely bugs right now. I would recommend against using it for anything big or important. Many parts of it may change in the future.

-

toc improves on C’s syntax (and semantics) in many ways, +

toc improves on C's syntax (and semantics) in many ways, To declare x as an integer and set it to 5, you can do:

-x := 5; // Declare x and set x to 5 (infer type) -x : int = 5; // Explicitly make the type int. -x : int; x = 5; // Declare x as an integer, then set it to 5. +x := 5; // Declare x and set x to 5 (infer type)
+x : int = 5; // Explicitly make the type int.
+x : int; x = 5; // Declare x as an integer, then set it to 5.

-

toc is statically typed and has many of C’s features, but +

toc is statically typed and has many of C's features, but it is nearly as fast in theory.

See docs for more information (in progress).

tests has some test programs written in toc.

-

To compile the compiler on a Unix-y system, just run ./build.sh release. You can supply a compiler by running CC=tcc ./build.sh release, or build it in debug mode without the release.

+

To compile the compiler on a Unix-y system, just run ./build.sh release. You can supply a compiler by running CC=tcc ./build.sh release, or build it in debug mode without the release. To disable compile time foreign function support (which you will need to do if you don't have ffcall/dl), prefix this with COMPILE_TIME_FOREIGN_FN_SUPPORT=no.

On other systems, you can just compile main.c with a C compiler. toc uses several C99 and a couple of C11 features, so it might not work on all compilers. But it does compile on quite a few, including clang, gcc, and tcc. It can also be compiled as if it were C++, so, MSVC and g++ can also compile it (it does rely on implicit casting of void * though). The outputted code should be C99-compliant.

@@ -37,11 +37,10 @@ it is nearly as fast in theory.

toc compiles to C. Here are some reasons why:

-

toc Compiler Source Code

@@ -54,15 +53,15 @@ it is nearly as fast in theory.

Build system

-

toc is set up as a unity build, meaning that there is only one translation unit. So, main.c #includes toc.c, which #includes all of toc’s files.

+

toc is set up as a unity build, meaning that there is only one translation unit. So, main.c #includes toc.c, which #includes all of toc's files.

Why?
-

This improves compilation speeds (especially from scratch), since you don’t have to include headers a bunch of times for each translation unit. This is more of a problem in C++, where, for example, doing #include <map> ends up turning into 25,000 lines after preprocessing. All of toc’s source code, which includes most of the C standard library, at the time of this writing (Dec 2019) is only 22,000 lines after preprocessing; imagine including all of that once for each translation unit which includes map. It also obviates the need for fancy build systems like CMake.

+

This improves compilation speeds (especially from scratch), since you don't have to include headers a bunch of times for each translation unit. This is more of a problem in C++, where, for example, doing #include <map> ends up turning into 25,000 lines after preprocessing. All of toc's source code, which includes most of the C standard library, at the time of this writing (Dec 2019) is only 22,000 lines after preprocessing; imagine including all of that once for each translation unit which includes map. It also obviates the need for fancy build systems like CMake.

New features

-

Here are all the C99 features which toc depends on (I might have forgotten some…):

+

Here are all the C99 features which toc depends on (I might have forgotten some...):

-

And here are all of its C11 features:

-

More

See main.c for a bit more information.

@@ -94,13 +91,13 @@ it is nearly as fast in theory.

VersionDescriptionDate 0.0Initial version.2019 Dec 6 0.1Constant parameter inference.2019 Dec 15 +0.2Foreign functions and #include.2020 Jan 29 -

Report a bug

-

If you find a bug, you can report it through GitHub’s issue tracker, or by emailing pommicket@gmail.com.

+

If you find a bug, you can report it through GitHub's issue tracker, or by emailing pommicket@gmail.com.

-

Just send me the toc source code which results in the bug, and I’ll try to fix it.

+

Just send me the toc source code which results in the bug, and I'll try to fix it.

-- cgit v1.2.3