millfork/README.md

![](logo_transparent.png)

# Millfork

A middle-level programming language targeting 6502-based, 8080-based and Z80-based microcomputers. 

For binary releases, see: https://github.com/KarolS/millfork/releases
(latest: 0.3.2).  
For build instructions, see [Build instructions](./COMPILING.md).

## Features

* high performance, due to being designed and optimized for 8-bit microprocessors

* multiple targets:

    * Commodore 64 (the primary target)
    
    * Commodore 64 with SuperCPU (experimental, incomplete and very buggy)
    
    * other Commodore computers: C16, Plus/4, C128, PET, VIC-20 (stock or with RAM extensions)
    
    * other 6502-based machines: Famicom/NES, Atari 8-bit computers, BBC Micro, Apple II+/IIe/Enhanced IIe, Atari 2600 (experimental)
    
    * Z80-based machines: ZX Spectrum 48k, NEC PC-88, Amstrad CPC, MSX
    
    * CP/M
    
    * Game Boy (experimental)
    
    * MS-DOS (very experimental, via 8080-to-8086 translation)

* multiple supported target processors:

    * well supported: MOS 6502, Ricoh 2A03/2A07, WDC 65C02, Intel 8080, Intel 8085, Zilog Z80
    
    * reasonably well supported: Sharp LR35902, CSG 65CE02
    
    * partially supported: Hudson Soft HuC6280, WDC 65816, Intel 8086

* inline assembly

* simple macros

* pay only for what you use: not a single byte of memory is used unless for code or explicitly declared variables

* a simple memory model that avoids using the stack

* multi-pass whole-program optimizer (that will even optimize your hand-written assembly if you ask it to)

* support for multi-file programs (Commodore only) and banked cartridges

## Licensing

The compiler is distributed under GPLv3 (see [LICENSE](LICENSE)).

The standard include files (located in the `include` directory) are distributed under a more permissive Zlib license (see [include/LICENSE](include/LICENSE)).
Therefore, no attribution is needed if you are developing and distributing Millfork programs.

## More info

* [Documentation](docs/index.md)

* [Example programs](examples/README.md)

## Planned features

* stdlib improvements

* more 6502 targets: Oric computers, PC-Engine/Turbografx-16, Atari Lynx

* more Z80 targets: TI-83, Sega Master System
 
* better support for 65816, Sharp LR35902 and eZ80

* support for SuperFamicom/SNES and Apple IIgs
Logo 2018-01-21 01:24:56 +01:00			`![](logo_transparent.png)`

Empty repo initialization 2017-12-06 22:00:04 +01:00			`# Millfork`

Update readme and changelog 2018-12-19 19:04:19 +01:00			`A middle-level programming language targeting 6502-based, 8080-based and Z80-based microcomputers.`
Initial code upload 2017-12-07 00:23:30 +01:00
Documentation updates 2018-07-25 00:04:00 +02:00			`For binary releases, see: https://github.com/KarolS/millfork/releases`
Add build instructions 2019-06-28 18:43:24 +02:00			`(latest: 0.3.2).`
			`For build instructions, see [Build instructions](./COMPILING.md).`
Version 0.1 2018-01-24 17:47:20 +01:00
Empty repo initialization 2017-12-06 22:00:04 +01:00			`## Features`

Update readme and changelog 2018-12-19 19:04:19 +01:00			`* high performance, due to being designed and optimized for 8-bit microprocessors`

Empty repo initialization 2017-12-06 22:00:04 +01:00			`* multiple targets:`

			`* Commodore 64 (the primary target)`

Preliminary support for 65816, 65CE02 and HuC6280 2018-03-03 01:21:57 +01:00			`* Commodore 64 with SuperCPU (experimental, incomplete and very buggy)`

Update readme and changelog 2018-12-19 19:04:19 +01:00			`* other Commodore computers: C16, Plus/4, C128, PET, VIC-20 (stock or with RAM extensions)`
Empty repo initialization 2017-12-06 22:00:04 +01:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* other 6502-based machines: Famicom/NES, Atari 8-bit computers, BBC Micro, Apple II+/IIe/Enhanced IIe, Atari 2600 (experimental)`
Famicom support 2018-03-15 23:46:16 +01:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* Z80-based machines: ZX Spectrum 48k, NEC PC-88, Amstrad CPC, MSX`
Preliminary MSX support 2019-06-05 13:31:43 +02:00
Preliminary CP/M support 2018-07-31 01:02:55 +02:00			`* CP/M`
Update readme and changelog 2018-12-19 19:04:19 +01:00
Update documentation 2019-03-18 23:15:28 +01:00			`* Game Boy (experimental)`
Add 8080-to-8086 translation 2019-05-31 17:03:35 +02:00
			`* MS-DOS (very experimental, via 8080-to-8086 translation)`
Empty repo initialization 2017-12-06 22:00:04 +01:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* multiple supported target processors:`

			`* well supported: MOS 6502, Ricoh 2A03/2A07, WDC 65C02, Intel 8080, Intel 8085, Zilog Z80`

			`* reasonably well supported: Sharp LR35902, CSG 65CE02`

			`* partially supported: Hudson Soft HuC6280, WDC 65816, Intel 8086`

Empty repo initialization 2017-12-06 22:00:04 +01:00			`* inline assembly`

Version 0.2 2018-03-17 18:21:50 +01:00			`* simple macros`

Empty repo initialization 2017-12-06 22:00:04 +01:00			`* pay only for what you use: not a single byte of memory is used unless for code or explicitly declared variables`

Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* a simple memory model that avoids using the stack`
Empty repo initialization 2017-12-06 22:00:04 +01:00
Update readme and changelog 2018-12-19 19:04:19 +01:00			`* multi-pass whole-program optimizer (that will even optimize your hand-written assembly if you ask it to)`
Empty repo initialization 2017-12-06 22:00:04 +01:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* support for multi-file programs (Commodore only) and banked cartridges`

Less restrictive licensing for the standard library 2018-06-22 18:16:10 +02:00			`## Licensing`

			`The compiler is distributed under GPLv3 (see [LICENSE](LICENSE)).`

			The standard include files (located in the `include` directory) are distributed under a more permissive Zlib license (see [include/LICENSE](include/LICENSE)).
			`Therefore, no attribution is needed if you are developing and distributing Millfork programs.`

Readme update 2018-01-21 21:55:44 +01:00			`## More info`

Rename documentation files 2018-03-28 19:31:10 +02:00			`* [Documentation](docs/index.md)`
Readme update 2018-01-21 21:55:44 +01:00
Documentation improvements 2018-04-03 00:21:26 +02:00			`* [Example programs](examples/README.md)`
Readme update 2018-01-21 21:55:44 +01:00
Empty repo initialization 2017-12-06 22:00:04 +01:00			`## Planned features`

Documentation updates 2018-07-25 00:04:00 +02:00			`* stdlib improvements`
Really early and very incomplete PC-88 support 2018-07-02 00:31:47 +02:00
			`* more 6502 targets: Oric computers, PC-Engine/Turbografx-16, Atari Lynx`
Documentation updates 2018-07-25 00:04:00 +02:00
Preliminary MSX support 2019-06-05 13:31:43 +02:00			`* more Z80 targets: TI-83, Sega Master System`
Preliminary support for 65816, 65CE02 and HuC6280 2018-03-03 01:21:57 +01:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* better support for 65816, Sharp LR35902 and eZ80`
Documentation updates 2018-07-25 00:04:00 +02:00
Many big important things: – Add support for undocumented 8085 instructions – Convert undocumented 8085 instructions to 8086 – Add new CPU types and categorize CPU types correctly – Fix macro expansion in some situations – Improve 8080 optimizations – Improve documentation – Other improvements 2019-06-12 12:06:02 +02:00			`* support for SuperFamicom/SNES and Apple IIgs`