Commit 41414b0a1fd5689f330af485918350c8f9c73760 - SixtyPical

+2

-2

HISTORY.markdown less more

0	0	History of SixtyPical
1	1	=====================
2	2
3		0.5-PRE
4		-------
	3	0.5
	4	---
5	5
6	6	* Added `byte table` type locations and indexed addressing (`+ x`, `+ y`).
7	7	* Integer literals may be given in hexadecimal.

+8

-6

README.markdown less more

12	12
13	13	It is a work in progress, currently at the proof-of-concept stage.
14	14
15		The current released version of SixtyPical is 0.4. The current development
16		version of SixtyPical, unreleased as of this writing, is 0.5-PRE.
	15	The current released version of SixtyPical is 0.5. The current development
	16	version of SixtyPical, unreleased as of this writing, is 0.6-PRE.
17	17
18	18	Documentation
19	19	-------------

30	30	TODO
31	31	----
32	32
33		For 0.5:
34
35	33	For 0.6:
36	34
37	35	* `interrupt` routines.
38	36	* `vector` type.
	37	* `with sei` blocks.
	38	* `copy` instruction.
	39	* A more involved demo for the C64 — one that sets up an interrupt.
39	40
40	41	For 0.7:
41	42
42	43	* `word` type.
43		* `copy` instruction.
44	44	* `trash` instruction.
	45	* indirect addressing.
45	46
46		For 0.8:
	47	At some point...
47	48
48	49	* add line number (or at least routine name) to error messages.
49	50	* 6502-mnemonic aliases (`sec`, `clc`)
50	51	* other handy aliases (`eq` for `z`, etc.)
	52	* add absolute addressing in shl/shr, absolute-indexed for add, sub, etc.

+9

-4

doc/SixtyPical.md less more

0	0	SixtyPical
1	1	==========
2	2
3		This document describes the SixtyPical programming language version 0.5-PRE,
	3	This document describes the SixtyPical programming language version 0.5,
4	4	both its execution aspect and its static analysis aspect (even though
5	5	these are, technically speaking, separate concepts.)
6	6

13	13	Types
14	14	-----
15	15
16		There are two TYPES in SixtyPical:
	16	There are three TYPES in SixtyPical:
17	17
18	18	* bit (2 possible values)
19	19	* byte (256 possible values)
	20	* byte table (256 entries, each holding a byte)
20	21
21	22	Memory locations
22	23	----------------

120	121
121	122	### ld ###
122	123
123		ld <dest-memory-location>, <src-memory-location>
	124	ld <dest-memory-location>, <src-memory-location> [+ <index-memory-location>]
124	125
125	126	Reads from src and writes to dest.
126	127

134	135	changed by this instruction; they must be named in the WRITES lists, and they
135	136	are considered initialized after it has executed.
136	137
	138	If and only if src is a byte table, the index-memory-location must be given.
	139
137	140	Some combinations, such as `ld x, y`, are illegal because they do not map to
138	141	underlying opcodes.
139	142
140	143	### st ###
141	144
142		st <src-memory-location>, <dest-memory-location>
	145	st <src-memory-location>, <dest-memory-location> [+ <index-memory-location>]
143	146
144	147	Reads from src and writes to dest.
145	148

151	154
152	155	After execution, dest is considered initialized. No flags are
153	156	changed by this instruction (unless of course dest is a flag.)
	157
	158	If and only if dest is a byte table, the index-memory-location must be given.
154	159
155	160	### add dest, src ###
156	161