|
1 year ago | |
---|---|---|
ftplugin | 6 years ago | |
indent | 5 years ago | |
syntax | 1 year ago | |
.gitignore | 6 years ago | |
LICENSE | 6 years ago | |
README.md | 6 years ago |
Vim plugin for the ca65
assembly language.
This repository provides a Vim
syntax-highlighting plugin, auto-indent plugin, and filetype plugin for the
ca65
assembly language.
ca65
is a full-featured assembler for the MOS
6502 family of
microprocessors, which powered such historic platforms as the KIM I, Apple II,
Commodore 64, and Nintendo Entertainment System. It is a part of the popular
cc65
suite of development tools for the 6502,
which also includes a C compiler, linker, object dumper, etc. ca65
is
designed both for direct use by assembly programmers and as the compilation
target of the cc65
C compiler. ca65
is especially used by “homebrew”
communities for the NES, SNES, etc.
The stock Vim runtime distribution includes syntax modules for several dialects
of assembly, as well as a “generic” module (which is really for the GNU
Assembler), none of which works particularly well with 6502 assembly
conventions, and especially not with ca65
's many added features.
ca65
numeric and string literals, label
definitions, and comments, with special highlighting for TODOs, FIXMEs, etc..fileopt
, segment
names, includes, macro definitions, storage types, conditional assembly,
linker control commands, structs, unions, procedures, pseudo-functions, some
built-in macros, console output commands (.out
, .warn
, .etc.), and
assembler behavior switches..proc
s, .if
statements, macro definitions,
macro call parameters, scopes, unions, and structs. Automatically
de-dent when closing these structures.ca65
comment syntax for Vim's automatic comment formatting features..include
, .incbin
, and .macpack
statements for Vim's
include-aware features.asm_ca65.vim
currently has no awareness of, or support for, assembler
options that change the rules of valid labels, identifiers, and literals from
their defaults, for example the following .feature
options and related
command-line switches to ca65
.
.feature at_in_identifiers
.feature dollar_in_identifiers
.feature labels_without_colons
.feature underline_in_numbers
Install in the normal way (i.e., place the contents of the syntax/
, indent
/
and ftplugin/
directories in corresonding locations in your vim runtime
path), or, if you use Pathogen, clone
this repository under ~/.vim/bundle/
.
Everything is enabled by setting a buffer's filetype
to asm_ca65
. For
example, if all of your ca65
assembly source files end with the .s
and
.inc.
, suffixes, the follwing suffices in your .vimrc
:
filetype plugin indent on
augroup filetypedetect
au BufNewFile,BufRead *.s,*.inc set ft=asm_ca65
augroup END