From cc373cc41dc4387e9936288047e892daafc44217 Mon Sep 17 00:00:00 2001
From: Jeremy Chadwick <jdc@koitsu.org>
Date: Fri, 23 Aug 2019 23:36:43 -0700
Subject: [PATCH] doc: clarify need for .IMPORT on some special symbols

---
 doc/ld65.sgml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/ld65.sgml b/doc/ld65.sgml
index 36489b0c6..6add0f0fd 100644
--- a/doc/ld65.sgml
+++ b/doc/ld65.sgml
@@ -562,7 +562,8 @@ segment, where this attribute is true, the linker will export three symbols.
 </verb></tscreen>
 
 Replace <tt/NAME/ by the name of the segment, in the example above, this would
-be <tt/BSS/. These symbols may be accessed by your code.
+be <tt/BSS/. These symbols may be accessed by your code once the symbol has
+been imported using the <tt>.IMPORT</tt> directive.
 
 Now, as we've configured the linker to write the first three segments and
 create symbols for the last one, there's only one question left: Where does
@@ -766,7 +767,8 @@ useful for things like a software stack, or an I/O area.
         }
 </verb></tscreen>
 
-This will define some external symbols that may be used in your code:
+This will define some external symbols that may be used in your code once
+the symbol has imported using the <tt>.IMPORT</tt> directive:
 
 <tscreen><verb>
         __STACK_START__         This is set to the start of the memory