From 2937e578eb0b29c4d24c87b3f93fbc7fb8527292 Mon Sep 17 00:00:00 2001 From: Dagen Brock Date: Fri, 6 Mar 2020 09:06:41 -0600 Subject: [PATCH] add README.md --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d52ec64 --- /dev/null +++ b/README.md @@ -0,0 +1,22 @@ + +# install-merlin32-action +A Github Action for installing Merlin32 enabling 6502/65c02/65816 assembly in your workflows. + +# Example usage +``` + # This will install Merlin32 on your Github Runner machine + - name: Install Merlin32 + uses: digarok/install-merlin32-action@master + + # Now you can use it to assemble your source code + - name: Assembly Step + - run: merlin32 src/myprogram.s +``` +# Build recommendations + + 1. While you can call Merlin32 directly from [`run`](https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) commands as shown above, it makes sense to put your build command(s) in a script that you can also run locally to get the same results. I'd avoid making complex assembly workflows with Github Actions, but hey you totally can and that's whats so great about actions! + 2. This action is intended to pair really well with my [`install-cadius-action`](https://github.com/digarok/install-cadius-action) which let's you take your assembled object file and package it inside a ProDOS image file for immediate use in your emulator or flash drive. I use this workflow to handle build and release all via Github Actions. + +# About Merlin32 +Merlin32 is a disk image program originally by the amazing French team, Brutal Deluxe. They are not involved with this Open Source version, but I do recommend you view [their site](http://brutaldeluxe.fr/products/crossdevtools/merlin32/) for more information on Merlin32 and their other incredible tools and releases. +