Skip to content

Latest commit

 

History

History
44 lines (30 loc) · 1.96 KB

README.md

File metadata and controls

44 lines (30 loc) · 1.96 KB

uxntal-mode

A bare bones Emacs major mode for Uxntal, the programming language of the Uxn stack-machine.

I have tried to replicate the Sublime Text highlight rules already included in Uxn but multiline comments are not supported yet. I have never written an emacs mode before, so please be kind <3

Contributions welcomed!

Installation

The following configuration has been tested with a vanilla .emacs.d. Trying to get things working under prelude raised issues I was unable to address at the moment.

;; Uxntal

;;; Set location of uxntal-mode.el
(add-to-list 'load-path "~/.emacs.d/site-lisp")

;;; Make sure uxnasm and uxnemu are on your PATH if you want to use uxntal-eval-buffer.
;;; Include any other assemblers if you want to use them, for example ruxnasm.
;;; On OSX we need to set the exec-path.
;;; In linux it appears that if you have the executables in your shell's PATH you can probably skip this step.
(setq exec-path (append exec-path '("/Users/xyz/uxn/bin" "/Users/xyz/ruxnasm/target/release")))

;;; If you want to use a different assembler
(setq uxntal-assembler "ruxnasm")

;;; Enable the mode and associate with the .tal extension 
(require 'uxntal-mode)
(add-to-list 'auto-mode-alist '("\\.tal\\'" . uxntal-mode))

Key Bindings

binding command description
C-x C-e uxntal-eval-buffer Build and run the current buffer. The resulting rom is created in /tmp/{buffer-name}.rom
C-c t h uxntal-insert-decimal-as-hex Convert a user provided decimal to hex and insert at point
C-c t d uxntal-decimal-value Message the decimal value of a hex under the cursor in the mini-buffer

Screenshot

uxntal-mode on gruvbox-dark-medium and whiteboard theme on a vanilla Emacs installation

uxntal-mode screenshot with misterioso theme on a vanilla Emacs installation