ASM6f 项目使用与配置指南

1. 项目的目录结构及介绍

ASM6f 项目是一个基于 ASM6 的 6502 汇编器，用于 NES/Famicom 开发。以下是项目的目录结构及其简要介绍：

• patches/：包含针对不同问题的修复和更新。
• test_cases/：存放用于测试汇编器的测试用例。
• .gitignore：定义 Git 忽略的文件和目录。
• LICENSE.txt：项目的许可协议文件。
• Makefile：用于构建项目的 Makefile 文件。
• asm6f.c：汇编器的主要源代码文件。
• readme-original.txt：项目的原始自述文件。
• readme.txt：项目的自述文件。

2. 项目的启动文件介绍

Makefile 是项目的启动文件，用于构建和编译 ASM6f 汇编器。以下是 Makefile 的基本使用方法：

make

执行上述命令将编译 asm6f.c 并生成可执行文件 asm6f。如果需要指定输出文件和列表文件，可以使用以下命令：

make [-options] sourcefile [outputfile] [listfile]

其中 -options 包含了多种编译选项，例如 -l 创建列表文件，-L 创建详细列表文件等。

3. 项目的配置文件介绍

ASM6f 项目中的配置主要是通过命令行参数来完成的。以下是一些常用的配置选项：

• -d<name>:：定义一个符号并使其等于 1。
• -l：创建列表文件。
• -L：创建详细列表文件，展开 REPT 和 MACRO。
• -n：输出 FCEUX 兼容的 .nl 文件。
• -f：输出 Lua 符号文件。
• -c：输出 .cdl 文件，用于 FCEUX/Mesen。
• -m：输出新格式的 Mesen 标签文件 .mlb。
• -M：输出旧格式的 Mesen 标签文件 .mlb。

通过这些配置选项，用户可以根据自己的需求来定制汇编器的输出和行为。例如，以下命令将定义一个符号 DEBUG 并输出列表文件：

make DEBUG=1 -l sourcefile.asm

以上就是关于 ASM6f 项目的基本介绍和配置方法。在实际使用过程中，可能需要进一步阅读项目的官方文档以获取更详细的指导。