summaryrefslogtreecommitdiff
path: root/spec/README.md
blob: 6b788cc3c37131862b6887a91ca58a42caaebff7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Version 0.0.1
# The TNSL Language Specification

## Forward

As of writing this forward, TNSL is not even a language yet.  Right now, it's mostly just a stupid idea that I've devoted too much brain-space to, and I'm not confident will ever take off.  The hard-core C folk probably will hate it, as well as the new-fangled rust/golangers with all their type safty.

I'm trying not to think too hard about that.

Right now, TNSL isn't a language.  But it *could* be.  And, really, I think it's a cool challenge to try to pack high-level features into a low-level environment.  I hope you find it interesting as well.

-Kyle

## Chapter Index

1. The Language

	- Files
	- Blocks
	- Statements
	- Types
	- Operators
	- `raw` and `asm`

2. Related features

	- Style guide
	- Compiler Options
	- The Pre-Processor
	- Included Tools

3. The TNSL Calling ABI

	- Differences from C
	- Link tables
	- Exporting C-like Functions
	- Types and Arrays in Memory

4. Features in Position

	- Bare Metal
	- `libtnsl` as it relates to Types
	- Cross Calling to C

### Credits

	Copyright 2021 Kyle Gunger

	This file is licenced under the CDDL 1.0 (the Licence)
	and may only be used in accordance with the Licence.
	You should have recieved a copy of the Licence with this
	software/source code. If you did not, a copy can be found
	at the following URL:

	https://opensource.org/licenses/CDDL-1.0

	THIS SOFTWARE/SOURCE CODE IS PROVIDED "AS IS" WITH NO
	WARRENTY, GUARANTEE, OR CLAIM OF FITNESS FOR ANY PURPOSE
	EXPRESS OR IMPLIED