MatthiasQuintern/vim-ca65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A vim plugin for the ca65 assembler providing syntax highlighting, convenience functions and help pages.
1 Commit 1 Branch 0 Tags 204 KiB
Vim Script 100%
5bb56a54a3
Go to file
matthias@arch 5bb56a54a3 initial commit
2023-12-09 23:24:28 +01:00
doc initial commit 2023-12-09 23:24:28 +01:00
ftdetect initial commit 2023-12-09 23:24:28 +01:00
ftplugin initial commit 2023-12-09 23:24:28 +01:00
syntax initial commit 2023-12-09 23:24:28 +01:00
README.md initial commit 2023-12-09 23:24:28 +01:00

README.md

vim-ca6502 Support for the ca65 assembler

This plugin provides syntax highlighting, convenience functions and help pages for the ca65 assembler. It is focused on the 65C02 processor, please open an issue/a pull request if you find anything that is missing.

By default, the plugin loads for files having a .s65 or .h65 extension. To load it for your preferred extension, write this into ~/.vim/ftdetect/ca6502.vim:

" in ~/.vim/ftdetect/ca6502.vim
au BufRead,BufNewFile *.myExtension setfiletype ca6502

Syntax

The syntax highlighting currently supports the 65C02 opcodes, the ca65 assembler functions and the macro packs generic and longbranch.

If the labels and instructions have the same color in your colorscheme, link ca65Opcode or ca65Label to another class, eg: hi link ca65Label Typedef.

Convenience

This plugin provides the b:match_words variable for jumping between words. Supported are the assembler commands like .if .endif, .macro .endmacro as well as stack instructions. This allows for easier checking of stack push/pull order.

There is also a function that opens a header/source file with the same name in a vsplit. For example if ~/project/main.s65 is opened, ~/project/main.h65 would be opened. To use it, map it and set your preferred assembly filetypes.

" in ~/.vim/ftplugin/ca6502.vim (or vimrc) 
nnoremap <buffer> <leader>h :call SplitHeader("h65", "s65")<Cr>

Help

I compiled the datasheet of the WDC 65C02 into a vim help page. Type :help <opcode> to see info about the opcode (addressing modes, updated flags...).