|RGBASM(1)||General Commands Manual||RGBASM(1)|
rgbasm— Game Boy assembler
rgbasmprogram creates an RGB object file from an assembly source file. The input file can be a file path, or
Note that options can be abbreviated as long as the abbreviation
--ver is invalid because it
could also be
arguments are as follows:
name’ in code, or ‘
name’ if value is not specified.
nopinstruction immediately after any
-hoption disables this behavior.
LD [$FF00+n8],Ainto the opcode
LDH [$FF00+n8],Ain order to have full control of the result in the final ROM.
-M. This makes
rgbasmassume that missing files are auto-generated: when
INCBINis attempted on a non-existent file, it is added as a dependency, then
rgbasmexits normally instead of erroring out. This feature is used in automatic updating of makefiles.
-M. The exact string provided will be written, including spaces and special characters.
-MQis specified, the output file name is used.
-MT, but additionally escapes any special make(1) characters, essentially ‘$’.
-Werror=obsolete), and this warning is implicitly enabled and turned into an error. This is an error if used with a meta warning, such as
The following warnings are “meta” warnings, that enable a collection of other warnings. If a specific warning is toggled via a meta flag and a specific one, the more specific one takes priority. The position on the command-line acts as a tie breaker, the last one taking effect.
The following warnings are actual warning flags; with each
description, the corresponding warning flag is included. Note that each of
these flag also has a negation (for example,
-Wempty-entry enables the warning that
-Wno-empty-entry disables). Only the non-default
flag is listed here. Ignoring the “no-” prefix, entries are
WARN-type assertions fail. (See “Aborting the assembly process” in rgbasm(5) for
STRSUB() with indexes outside of the string's bounds. This warning is enabled by
dllist. This warning is enabled by
jp [hl]instruction or
HOMEsection type are encountered.
db) loses some bits.
WARNbuilt-in is executed. (See “Aborting the assembly process” in rgbasm(5) for
$ rgbasm -o bar.o foo.asm
$ cat foo.asm | rgbasm -o bar.o -
$ rgbasm -o bar.o - < foo.asm
rgbasmwas originally written by Carsten Sørensen as part of the ASMotor package, and was later packaged in RGBDS by Justin Lloyd. It is now maintained by a number of contributors at https://github.com/rednex/rgbds.
|July 8, 2019||General|