From f5b36afd2edd21edf6c8bffeedbfd009c5ad496d Mon Sep 17 00:00:00 2001 From: Andy McFadden Date: Thu, 8 Nov 2018 11:35:35 -0800 Subject: [PATCH] Add a bit to the tutorial In the data operand edit section, walk through selecting a single byte vs. multiple bytes when you want to set a multi-byte format. (inspired by issue #41) --- SourceGen/RuntimeData/Help/index.html | 4 ++-- SourceGen/RuntimeData/Help/tutorials.html | 27 ++++++++++++++--------- 2 files changed, 19 insertions(+), 12 deletions(-) diff --git a/SourceGen/RuntimeData/Help/index.html b/SourceGen/RuntimeData/Help/index.html index a791dd0..49b9021 100644 --- a/SourceGen/RuntimeData/Help/index.html +++ b/SourceGen/RuntimeData/Help/index.html @@ -146,8 +146,8 @@ and 65816 code. The official web site is
  • Tutorials
    • diff --git a/SourceGen/RuntimeData/Help/tutorials.html b/SourceGen/RuntimeData/Help/tutorials.html index cbb6294..bb1f065 100644 --- a/SourceGen/RuntimeData/Help/tutorials.html +++ b/SourceGen/RuntimeData/Help/tutorials.html @@ -13,17 +13,18 @@

    6502bench SourceGen: Tutorials

    Back to index

    +

    The tutorials introduce SourceGen and cover some of the basic +features. They skim lightly over some important concepts, like the +difference between numeric and symbolic references, so reading the +manual is recommended.

    + -

    Basic Features

    - -

    This tutorial introduces SourceGen and covers some of the basic -features. This skims lightly over some important concepts, so reading the -manual is recommended.

    +

    Tutorial #1: Basic Features

    Start by launching SourceGen. The initial screen has a large center area with some links, and some mostly-empty windows on the sides. @@ -275,9 +276,15 @@ instead. There's an easy way to do that: use Actions > Toggle Single-Byte Format (or hit Ctrl+B).

    The data starting at $2025 appears to be 16-bit addresses that point into the table of strings, so let's format them appropriately.

    -

    Select the line at $2025, then shift-click the line at $202E. Select -Actions > Edit Operand. If you selected the correct set of bytes, -the top should say, "10 bytes selected". Click the +

    Double-click the operand column on line $2025 ("$30") to open +the operand data format editor. Because you only have one byte selected, +most of the options are disabled. This won't do what we want, so +click "Cancel".

    +

    Select the line at $2025, then shift-click the line at $202E. Right-click +and select Edit Operand. If you selected the correct set of bytes, +the top line in the dialog should now say, "10 bytes selected". Because +10 is a multiple of two, the 16-bit formats are enabled. It's not a multiple +of 3 or 4, so the 24-bit and 32-bit options are not enabled. Click the "16-bit words, little-endian" radio button, then over to the right, click the "Address" radio button. Click "OK".

    We just told SourceGen that those 10 bytes are actually five numeric @@ -285,7 +292,7 @@ references. SourceGen determined that the addresses are contained in the file, and created labels for each of them. Labels only work if they're on their own line, so each string is now in a separate ".STR" statement.

    -

    Use File > Save (or hit Ctrl+S) to save your hard work.

    +

    Use File > Save (or hit Ctrl+S) to save your work.

    Generating Assembly Code

    @@ -315,7 +322,7 @@ it should always match exactly.)

    on to the next tutorial to learn more.

    -

    Advanced Features

    +

    Tutorial #2: Advanced Features

    This tutorial will walk you through some of the fancier things SourceGen can do. We assume you've already finished the Basic Features tutorial.