From 76e31e5b7589e479782d0dbd2093645c3da6a2d4 Mon Sep 17 00:00:00 2001
From: Daniel Serpell <daniel.serpell@gmail.com>
Date: Sun, 13 Dec 2020 20:15:19 -0300
Subject: [PATCH] Document usage of scope before definitions.

Note that before the last commit, the example did not assemble.
---
 doc/ca65.sgml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index 5e53fb002..019c808e9 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -1319,6 +1319,11 @@ if you want to access the "other" symbol <tt/bar/, you would have to write:
         .endscope
 </verb></tscreen>
 
+The above example also shows that to search a scope that is not yet defined in
+the code above the usage, you must use the namespace token (<tt/::/) and
+specify the full scope name, to allow the assembler to create the scope at the
+correct place.
+
 
 <sect>Address sizes and memory models<label id="address-sizes"><p>