u6a/README.md

<!--
Copyright (C) 2020,2021  CismonX <admin@cismon.net>

Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty, provided the copyright notice and
this notice are preserved. This file is offered as-is, without any warranty.
-->

# U6a

[![Build Status](https://drone.cismon.net/api/badges/esolangs/u6a/status.svg)](https://drone.cismon.net/esolangs/u6a)
[![License](https://img.shields.io/badge/license-GPL--3.0--or--later-blue.svg)](LICENSE)

Implementation of Unlambda, an esoteric programming language.

## Description

The U6a project provides a bytecode compiler and a runtime system for the [Unlambda](http://www.madore.org/~david/programs/unlambda/) programming language.

Ideas behind this implementation can be found [here](https://git.cismon.net/esolangs/u6a/wiki/Developer%27s-Notes-on-Implementing-Unlambda).

U6a is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

## Getting Started

To install U6a from source, see [INSTALL](INSTALL).

Usage (See [**u6ac**(1)](man/u6ac.1) and [**u6a**(1)](man/u6a.1) man pages for details):

```bash
# Compile an Unlambda source file into bytecode.
u6ac -o foo.unl.bc foo.unl
# Execute the bytecode file.
u6a foo.unl.bc
```

## Future Plans

* Interactive debugger: `u6adb`
* More compile-time optimizations
* More test cases
* LLVM backend for `u6ac`
cleaning up 2020-10-10 19:31:31 +00:00			`<!--`
Switch to self-hosted CI (Drone). 2021-01-26 07:07:14 +00:00			`Copyright (C) 2020,2021 CismonX <admin@cismon.net>`
cleaning up 2020-10-10 19:31:31 +00:00
			`Copying and distribution of this file, with or without modification, are`
			`permitted in any medium without royalty, provided the copyright notice and`
			`this notice are preserved. This file is offered as-is, without any warranty.`
			`-->`

Update copyright notice 2020-10-10 19:50:45 +00:00			`# U6a`
initial commit 2020-01-30 10:11:10 +00:00
Switch to self-hosted CI (Drone). 2021-01-26 07:07:14 +00:00			`[![Build Status](https://drone.cismon.net/api/badges/esolangs/u6a/status.svg)](https://drone.cismon.net/esolangs/u6a)`
			`[![License](https://img.shields.io/badge/license-GPL--3.0--or--later-blue.svg)](LICENSE)`
initial commit 2020-01-30 10:11:10 +00:00
			`Implementation of Unlambda, an esoteric programming language.`

			`## Description`

Update copyright notice 2020-10-10 19:50:45 +00:00			`The U6a project provides a bytecode compiler and a runtime system for the [Unlambda](http://www.madore.org/~david/programs/unlambda/) programming language.`
initial commit 2020-01-30 10:11:10 +00:00
Switch to self-hosted CI (Drone). 2021-01-26 07:07:14 +00:00			`Ideas behind this implementation can be found [here](https://git.cismon.net/esolangs/u6a/wiki/Developer%27s-Notes-on-Implementing-Unlambda).`
initial commit 2020-01-30 10:11:10 +00:00
Update copyright notice 2020-10-10 19:50:45 +00:00			`U6a is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.`

update 2020-02-01 14:45:48 +00:00			`## Getting Started`
initial commit 2020-01-30 10:11:10 +00:00
Update copyright notice 2020-10-10 19:50:45 +00:00			`To install U6a from source, see [INSTALL](INSTALL).`
initial commit 2020-01-30 10:11:10 +00:00
cleaning up 2020-10-10 19:31:31 +00:00			`Usage (See [u6ac(1)](man/u6ac.1) and [u6a(1)](man/u6a.1) man pages for details):`
initial commit 2020-01-30 10:11:10 +00:00
			```bash
update 2020-02-01 14:45:48 +00:00			`# Compile an Unlambda source file into bytecode.`
initial commit 2020-01-30 10:11:10 +00:00			`u6ac -o foo.unl.bc foo.unl`
update 2020-02-08 16:51:31 +00:00			`# Execute the bytecode file.`
initial commit 2020-01-30 10:11:10 +00:00			`u6a foo.unl.bc`
			```

update 2020-02-01 14:45:48 +00:00			`## Future Plans`
initial commit 2020-01-30 10:11:10 +00:00
update 2020-02-01 14:45:48 +00:00			* Interactive debugger: `u6adb`
initial commit 2020-01-30 10:11:10 +00:00			`* More compile-time optimizations`
update 2020-02-01 14:45:48 +00:00			`* More test cases`
			* LLVM backend for `u6ac`