From 0b94ff16591752439ae6c9b619c428520046abeb Mon Sep 17 00:00:00 2001 From: Thomas Humper Date: Fri, 23 Aug 2024 02:14:12 +0200 Subject: [PATCH 1/2] Update README.md --- README.md | 58 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 32 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 3770c24..b93927d 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,42 @@ -# Callisto -Callisto is a reverse polish notation programming -language inspired by YSL-C3 and Forth - -It also has a subset called CallistoScript made for scripting languages like Lua, and -it's still sort of low level - -## Supported targets -- x86 real mode, MS-DOS (complete) -- x86_64 Linux, macOS (complete) -- ARM64 Linux (complete) -- Uxn (complete, `implement` broken, see #6) -- Lua (complete, subset CallistoScript) - -## Build -You need a [D compiler](https://dlang.org/download.html) to build the Callisto compiler +# Callisto 🚀 + +Callisto is a reverse Polish notation programming language, inspired by YSL-C3 and Forth. It also includes a subset called CallistoScript, designed for scripting languages like Lua, while still maintaining a relatively low-level approach. + +## Supported Targets 🛠️ + +- **x86 Real Mode, MS-DOS:** Fully supported ✅ +- **x86_64 Linux, macOS:** Fully supported ✅ +- **ARM64 Linux:** Fully supported ✅ +- **Uxn:** Fully supported (note: `implement` is broken, see [issue #6](#6)) ⚠️ +- **Lua:** Fully supported (subset: CallistoScript) 📝 + +## Build Instructions 🧑‍💻 + +To build the Callisto compiler, you will need a [D compiler](https://dlang.org/download.html). Once installed, build the project using the following command: + ``` dub build ``` -## Try it -Note: to use the example programs, you will need the `std` submodule in this repository, -which you can get by cloning recursively or -doing `git submodule update --init --remote --recursive` +## Getting Started 🎉 + +### Running Example Programs + +Before running example programs, ensure that the `std` submodule is included in your repository. You can achieve this by cloning the repository recursively or running the following command: + +``` +git submodule update --init --remote --recursive +``` + +Example programs are located in the `examples` directory. To compile and run an example, use: -There are some example programs in the `examples` folder, which you can compile -and run like this: ``` -cac examples/exampleNameHere.cal -i std -o out +cac examples/.cal -i std -o out ./out ``` -To learn more about Callisto, read the [docs](https://callisto.mesyeti.uk/docs) +For more detailed information about Callisto, please refer to the [official documentation](https://callisto.mesyeti.uk/docs). + +## Community and Support 💬 -## Support/talk -`#callisto-lang` on irc.libera.chat +For support or discussions, join the `#callisto-lang` channel on [irc.libera.chat](https://libera.chat). From 1c3dad35ecb904b5fc15893f88f796e973ea04d0 Mon Sep 17 00:00:00 2001 From: Thomas Humper Date: Fri, 23 Aug 2024 19:37:24 +0200 Subject: [PATCH 2/2] Update README.md --- README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index b93927d..f946495 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,16 @@ -# Callisto 🚀 +# Callisto Callisto is a reverse Polish notation programming language, inspired by YSL-C3 and Forth. It also includes a subset called CallistoScript, designed for scripting languages like Lua, while still maintaining a relatively low-level approach. -## Supported Targets 🛠️ +## Supported Targets -- **x86 Real Mode, MS-DOS:** Fully supported ✅ -- **x86_64 Linux, macOS:** Fully supported ✅ -- **ARM64 Linux:** Fully supported ✅ -- **Uxn:** Fully supported (note: `implement` is broken, see [issue #6](#6)) ⚠️ -- **Lua:** Fully supported (subset: CallistoScript) 📝 +- **x86 Real Mode, MS-DOS:** Fully supported +- **x86_64 Linux, macOS:** Fully supported +- **ARM64 Linux:** Fully supported +- **Uxn:** Fully supported (note: `implement` is broken, see [issue #6](#6)) +- **Lua:** Fully supported (subset: CallistoScript) -## Build Instructions 🧑‍💻 +## Build Instructions To build the Callisto compiler, you will need a [D compiler](https://dlang.org/download.html). Once installed, build the project using the following command: @@ -18,7 +18,7 @@ To build the Callisto compiler, you will need a [D compiler](https://dlang.org/d dub build ``` -## Getting Started 🎉 +## Getting Started ### Running Example Programs @@ -37,6 +37,6 @@ cac examples/.cal -i std -o out For more detailed information about Callisto, please refer to the [official documentation](https://callisto.mesyeti.uk/docs). -## Community and Support 💬 +## Community and Support For support or discussions, join the `#callisto-lang` channel on [irc.libera.chat](https://libera.chat).