From 8d34a9b74e3103707950dfeedfa1b43aa30f67e7 Mon Sep 17 00:00:00 2001
From: Rangi <35663410+Rangi42@users.noreply.github.com>
Date: Mon, 1 Dec 2025 13:57:09 -0500
Subject: [PATCH] Comment that `farcall` and `callfar` are interchangable
 (#1209)

Fixes #1208
---
 macros/farcall.asm | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/macros/farcall.asm b/macros/farcall.asm
index b884c8f0..6a5dfd14 100644
--- a/macros/farcall.asm
+++ b/macros/farcall.asm
@@ -1,5 +1,9 @@
 ; Far calls to another bank
 
+; There is no difference between `farcall` and `callfar`, except the arbitrary
+; order in which they set `a` and `hl` before calling `FarCall`.
+; We use the more natural name "farcall" for the more common order.
+
 MACRO farcall ; bank, address
 	ld a, BANK(\1)
 	ld hl, \1