Options concernant les fichiers:
Option concernant les chemins en entrée
-I<chemin>
Spécifie un chemin pour lire les fichiers que RASM ne trouvera pas dans le répertoire courant. Il est possible de cumuler autant de répertoires que l'on veut en succédant plusieurs fois l'option. Les fichiers seront alors recherchés dans l'ordre des répertoires définis.
Options générales de nommage de fichier
-oa
Cette option prendra pour racine de fichier, le nom du fichier en entrée (sans extension)
-o <racine>
Choisir un nom pour tous les fichiers en sortie (sans extension)
-or <racine>
Options spécifiques de nommage de fichier
Choisir un nom pour les fichiers ROM en sortie
-ob <nom complet>
Choisir un nom pour le fichier binaire en sortie
-oc <nom complet>
Choisir un nom pour le fichier cartouche en sortie
-oi <nom complet>
Choisir un nom pour le fichier snapshot en sortie
-os <nom complet>
Choisir un nom pour le fichier des symboles en sortie
-ot <nom complet>
Choisir un nom pour le fichier K7 en sortie
-ok <nom complet>
Choisir un nom pour le fichier des points d'arrêt en sortie
-ol <nom complet>
Choisir un nom pour le fichier des labels de ROM
Option spéciale
-no
désactive toute sortie de fichier
Options de dépendance:
-depend=make
produit les dépendances du source sur une seule ligne, pour intégration dans un makefile.
-depend=list
produit les dépendances du source en tant que liste, pour être parsé ultérieurement par exemple.
-Dvariable=value
définir une variable pour l'assemblage
Options d'export des symboles et points d'arrêt
-wu
Avertir si des symboles déclarés n'ont pas été utilisés
-s
Exporter les symboles au format RASM (label, adresse, banque)
LABEL1 #100 B0
LABEL2 #4378 B2-sp
Exporter les symboles au format Pasmo
LABEL1 EQU 00100H
LABEL2 EQU 04378H-sw
Exporter les symboles au format Winape
LABEL1 #100
LABEL2 #1234-er
Exporter les labels des ROM. Quand on assigne des libellés à des ROM avec la directive NAMEBANK, ces noms peuvent être exportés dans un fichier. L'extension par défaut du fichier est ".romlabel" ajouté à la racine courante.
0: Libellé de la ROM 0
1: Libellé de la ROM 1-eb
Exporter les points d'arrêt
-ec
Exporter les labels avec la casse originale (peut prendre quelques secondes sur d'énormes projets)
-sm
Exporter les symboles à raison d'un fichier par banque mémoire utilisée
-ss
Exporter les symboles dans les snapshots (chunk SYMB pour ACE emulator)
-sc <format>
Exporter les symboles avec un format particulier. La chaine de format ne doit posséder que deux champs. Le premier champ sera systématiquement %s et le deuxième doit être un champ numérique de type %d %x ou autre, avec un formatage possible. À utiliser avec précaution.
Note
Il est possible de définir des blocs de code pour lesquels l'exportation de symbole est désactivée.
Options de compatibilité:
-m
RASM réalisera les calculs à la manière de l'assembleur Maxam ou Dams. Les valeurs utilisées seront tronquées, non signées et 16 bits. La priorité des opérateurs ne sera pas respectée.
-dams
Utiliser la convention de nommage des labels avec le point
-amper
Convertir tous les & en # avant assemblage, surtout utile pour traiter de vieux sources DAMS
-ass
Comportement similaire à l'assembleur AS80 (premières versions)
-uz
Comportement similaire à l'assembleur UZ80 (premières versions)
-pasmo
Comportement similaire à l'assembleur Pasmo (Anciennes versions, je ne m'amuse pas à suivre chaque assembleur)
-msep <separateur>
Choisir le caractère séparateur pour les modules (par défaut, le "_" )
-utf8
L'usage de cette option permet la conversion des symboles UTF8 ¿ ¡ ù é è ç à Ñ ñ présents sur les claviers français ou espagnol dans leur équivalent du Basic Azerty ou Hispanique. La conséquence directe de la présence de cette option est qu'il n'est plus possible de mettre n'importe quoi entre quotes, il faut utiliser l'option -fq (décrite ci-dessous) pour garder une compatibilité avec RASM 1.6
à = 64 ou @
ç = 92 ou
é = 123 ou {
ù = 124 ou |
è = 125 ou }
Ñ = 161
ñ = 171
¿ = 174
¡ = 175-fq
Ne pas sortir en erreur si un caractère UTF8 est présent dans une chaine de caractère
Options hors catégorie ^_^
-quick
Utiliser le mode rapide pour la compression ZX0
-cprquiet
Ne pas produire le listing d'information des ROM d'une cartouche
-map
Assemblage verbeux, produire le listing, les adresses et les opcodes à la volée. Les valeurs immédiates sont à zéro, à cause du comportement mono-passe de RASM.
Bnk|Real|Logic Bytecode [Time] Assembly
-----------------------------------------
IX EQU 0 ; alias definition
IY EQU 0 ; alias definition
000|0000 | LZ4_DECOMPRESS_RAW:
000|0000 | D5 [04] PUSH DE (L4:decrunch/lz4_docent.asm)
000|0001 | E5 [04] PUSH HL (L5:decrunch/lz4_docent.asm)
000|0002 | 09 [03] ADD HL,BC (L6:decrunch/lz4_docent.asm)
000|0003 | 44 [01] LD B,H (L7:decrunch/lz4_docent.asm)
000|0004 | 4D [01] LD C,L (L8:decrunch/lz4_docent.asm)
000|0005 | E1 [03] POP HL (L9:decrunch/lz4_docent.asm)
000|0006 | C5 [04] PUSH BC (L10:decrunch/lz4_docent.asm)
000|0007 | 06 00 [02] LD B,0 (L12:decrunch/lz4_docent.asm)
000|0009 | LZ4_GETTOKEN:
000|0009 | AF [01] XOR A (L16:decrunch/lz4_docent.asm)
000|000A | 7E [02] LD A,(HL) (L17:decrunch/lz4_docent.asm)
000|000B | 23 [02] INC HL (L18:decrunch/lz4_docent.asm)-eo
Écraser les fichiers présents sur la disquette en modification, si ils ont le même nom que les fichiers à écrire
Options pour les snapshots
-sb
Exporter les points d'arrêt (chunks BRKS et BRKC pour Winape et ACE)
-ss
Exporter les symboles (chunk SYMB pour ACE)
-v2
Exporter un snapshot version 2 plutôt que version 3, par exemple pour la carte M4 qui ne sait pas les gérer
Options d'analyse
-me <valeur>
Définir un nombre maximum d'erreurs. Utiliser la valeur zéro signifie une désactivation de la limite.
-twe
Considérer les avertissements comme des erreurs
-xr
Affichage étendu des erreurs (ligne du source sous le message d'erreur)
-w
Désactiver les avertissements (déconseillé)
-void
Forcer l'utilisation du paramètre (void) avec les macros sans paramètre (option vivement recommandée)
-mml
Autoriser l'envoi des paramètres d'une macro sur plusieurs lignes
_COPY Scanline_RAM_End-Scanline_RAM_Begin,
ROM_BonusStage,
ROM_BonusStageAnimFrames,
#E000,
RAM_BonusStage_ScanlineRoutines