4377

2 files changed, 4 insertions, 3 deletions

diff --git a/subx/011parse.cc b/subx/011parse.cc
index c6d66ff4..de62ac50 100644
--- a/subx/011parse.cc
+++ b/subx/011parse.cc
@@ -6,10 +6,11 @@ put(Help, "syntax",
   "Line-endings are significant; each line should contain a single instruction, macro or directive.\n"
   "Comments start with the '#' character. It should be at the start of a word (start of line, or following a space).\n"
   "Each segment starts with a header line: a '--' delimiter followed by the starting address for the segment.\n"
-  "The starting address for a segment has some finicky requirements. But just start with a round number, and `subx` will try to guide you to the right answer.\n"
-  "A good default is to try to start the first segment at the default address of 0x08048000, and to start subsequent segments at least 0x1000 (most common page size) bytes after.\n"
+  "The starting address for a segment has some finicky requirements. But just start with a round number, and `subx` will try to guide you to a valid configuration.\n"
+  "A good rule of thumb is to try to start the first segment at the default address of 0x08048000, and to start each subsequent segment at least 0x1000 (most common page size) bytes after the last.\n"
   "If a segment occupies than 0x1000 bytes you'll need to push subsequent segments further down.\n"
   "Currently only the first segment contains executable code (because it gets annoying to have to change addresses in later segments every time an earlier one changes length; one of those finicky requirements).\n"
+  "Check out some examples in this directory (ex*.subx)\n"
   "Programming in machine code can be annoying, but let's see if we can make it nice enough to be able to write a compiler in it.\n"
 );
 :(before "End Help Contents")
diff --git a/subx/013indirect_addressing.cc b/subx/013indirect_addressing.cc
index 4480e809..c192b35b 100644
--- a/subx/013indirect_addressing.cc
+++ b/subx/013indirect_addressing.cc
@@ -384,7 +384,7 @@ case 0x8b: {  // copy r32 to r/m32
 //:: jump
 
 :(before "End Initialize Op Names(name)")
-put(name, 0xff, "jump/push/call rm32 depending on subop");
+put(name, 0xff, "jump/push/call rm32 based on subop");
 
 :(scenario jump_mem_at_r32)
 % Reg[EAX].i = 0x60;