2021-10-19 00:56:08 +00:00
|
|
|
<!DOCTYPE html>
|
|
|
|
<html lang="en">
|
2018-09-28 17:05:11 +00:00
|
|
|
|
|
|
|
<head>
|
2021-10-19 00:56:08 +00:00
|
|
|
<meta charset="utf-8"/>
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="main.css"/>
|
|
|
|
<title>Contents - 6502bench SourceGen</title>
|
2018-09-28 17:05:11 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
<body>
|
2018-10-09 17:04:10 +00:00
|
|
|
<div id="content">
|
2021-10-08 00:24:12 +00:00
|
|
|
<h1>6502bench SourceGen Reference Manual</h1>
|
2019-08-18 23:42:40 +00:00
|
|
|
<p>SourceGen is an interactive disassembler for 6502, 65C02,
|
2018-09-28 17:05:11 +00:00
|
|
|
and 65816 code. The official web site is
|
|
|
|
<a href="https://6502bench.com/">https://6502bench.com/</a>.</p>
|
|
|
|
|
2021-06-08 00:49:23 +00:00
|
|
|
<p>If you want to get up to speed quickly, start with the
|
|
|
|
<a href="https://6502bench.com/sgtutorial/">tutorials</a>.</p>
|
2018-10-01 18:09:04 +00:00
|
|
|
|
2021-10-08 18:01:03 +00:00
|
|
|
<div id="webwarn" style="display:none;">
|
|
|
|
<p style="color:red;">
|
|
|
|
NOTE: the version of the manual on the web may be older or newer
|
|
|
|
than the version of the program you're using. To ensure you're
|
|
|
|
reading the correct version, open the manual from within SourceGen,
|
|
|
|
using the <samp>Help > Help</samp> menu item or by hitting
|
|
|
|
<kbd class="key">F1</kbd>.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
|
2018-09-28 17:05:11 +00:00
|
|
|
<h2>Contents</h2>
|
|
|
|
<ul>
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="intro.html">Overview</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2021-10-19 00:56:08 +00:00
|
|
|
<li><a href="intro.html#fundamental-concepts">Fundamentals</a>
|
2019-08-18 23:42:40 +00:00
|
|
|
<ul>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro.html#begin">About 6502 Code</a>
|
2019-08-18 23:42:40 +00:00
|
|
|
<li><a href="intro.html#charenc">Character Encoding</a></li>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro.html#sgconcepts">SourceGen Concepts</a></li>
|
2019-08-18 23:42:40 +00:00
|
|
|
</ul></li>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro.html#sgintro">How SourceGen Works</a></li>
|
|
|
|
</ul></li>
|
|
|
|
<li><a href="intro-details.html">Digging Deeper</a>
|
|
|
|
<ul>
|
|
|
|
<li><a href="intro-details.html#about-symbols">All About Symbols</a>
|
|
|
|
<ul>
|
|
|
|
<li><a href="intro-details.html#connecting-operands">Connecting Operands With Labels</a></li>
|
|
|
|
<li><a href="intro-details.html#internal-address-symbols">Internal Address Symbols</a></li>
|
|
|
|
<li><a href="intro-details.html#external-address-symbols">External Address Symbols</a></li>
|
|
|
|
<li><a href="intro-details.html#unique-local-global">Unique vs. Non-Unique and Local vs. Global</a></li>
|
|
|
|
<li><a href="intro-details.html#weak-refs">Weak Symbolic References</a></li>
|
|
|
|
<li><a href="intro-details.html#symbol-parts">Parts and Adjustments</a></li>
|
|
|
|
<li><a href="intro-details.html#nearby-targets">Automatic Use of Nearby Targets</a></li>
|
|
|
|
</ul></li>
|
|
|
|
<li><a href="intro-details.html#width-disambiguation">Width Disambiguation</a></li>
|
|
|
|
<li><a href="intro-details.html#address-regions">Address Regions</a>
|
2019-08-18 23:42:40 +00:00
|
|
|
<ul>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro-details.html#fixed-float">Fixed vs. Floating</a></li>
|
|
|
|
<li><a href="intro-details.html#non-addr">Non-Addressable Areas</a></li>
|
|
|
|
<li><a href="intro-details.html#pre-labels">Pre-Labels</a></li>
|
|
|
|
<li><a href="intro-details.html#relative-addr">Relative Addressing</a></li>
|
2019-08-18 23:42:40 +00:00
|
|
|
</ul></li>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro-details.html#pseudo-ops">Data and Directive Pseudo-Opcodes</a></li>
|
|
|
|
<li><a href="intro-details.html#atags">Directing the Code Analyzer</a>
|
2019-08-18 23:42:40 +00:00
|
|
|
<ul>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro-details.html#scripts">Extension Scripts</a></li>
|
2019-08-18 23:42:40 +00:00
|
|
|
</ul></li>
|
2021-10-08 00:24:12 +00:00
|
|
|
<li><a href="intro-details.html#pseudo-ops">Data and Directive Pseudo-Opcodes</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="mainwin.html">Using SourceGen</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="mainwin.html#starting-new">Starting a New Project</a></li>
|
|
|
|
<li><a href="mainwin.html#opening">Opening an Existing Project</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="mainwin.html#working">Working With a Project</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="mainwin.html#code-list">Code List</a></li>
|
|
|
|
<li><a href="mainwin.html#undo">Undo & Redo</a></li>
|
|
|
|
<li><a href="mainwin.html#references">References Window</a></li>
|
|
|
|
<li><a href="mainwin.html#notes">Notes Window</a></li>
|
|
|
|
<li><a href="mainwin.html#symbols">Symbols Window</a></li>
|
|
|
|
<li><a href="mainwin.html#info">Info Window</a></li>
|
2019-10-21 01:02:23 +00:00
|
|
|
<li><a href="mainwin.html#messages">Messages Window</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="mainwin.html#navigation">Navigation</a></li>
|
2020-10-14 22:02:53 +00:00
|
|
|
<li><a href="mainwin.html#atags">Adding and Removing Analyzer Tags</a></li>
|
2019-09-15 20:37:38 +00:00
|
|
|
<li><a href="mainwin.html#address-table">Format Address Table</a></li>
|
Instruction operand editor rework, part 2
Implemented local variable editing. Operands that have a local
variable reference, or are eligible to have one, can now be edited
directly from the instruction operand edit dialog.
Also, updated the code list double-click handler so that, if you
double-click on the opcode of an instruction that uses a local
variable reference, the selection and view will jump to the place
where that variable was defined.
Also, tweaked the way the References window refers to references
to an address that didn't use a symbol at that address. Updated
the explanation in the manual, which was a bit confusing.
Also, fixed some odds and ends in the manual.
Also, fixed a nasty infinite recursion bug (issue #47).
2019-09-08 01:57:22 +00:00
|
|
|
<li><a href="mainwin.html#toggle-single">Toggle Single-Byte Format</a></li>
|
2018-11-12 01:20:12 +00:00
|
|
|
<li><a href="mainwin.html#format-as-word">Format As Word</a></li>
|
2018-10-08 04:51:15 +00:00
|
|
|
<li><a href="mainwin.html#toggle-data">Toggle Data Scan</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="mainwin.html#clipboard">Copying to Clipboard</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="editors.html">Editors</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2021-10-20 16:06:53 +00:00
|
|
|
<li><a href="editors.html#address">Create/Edit Address Region</a></li>
|
2021-10-08 15:36:44 +00:00
|
|
|
<li><a href="editors.html#flags">Override Status Flags</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="editors.html#label">Edit Label</a></li>
|
2021-10-08 15:36:44 +00:00
|
|
|
<li><a href="editors.html#instruction-operand">Edit Operand (Instruction)</a>
|
2019-09-09 04:56:47 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="editors.html#explicit-format">Explicit Formats</a></li>
|
|
|
|
<li><a href="editors.html#shortcut-nar">Numeric Address References</a></li>
|
|
|
|
<li><a href="editors.html#shortcut-local-var">Local Variable References</a></li>
|
|
|
|
</ul></li>
|
2021-10-08 15:36:44 +00:00
|
|
|
<li><a href="editors.html#data-operand">Edit Operand (Data)</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="editors.html#comment">Edit Comment</a></li>
|
|
|
|
<li><a href="editors.html#long-comment">Edit Long Comment</a></li>
|
2020-07-10 20:29:36 +00:00
|
|
|
<li><a href="editors.html#data-bank">Edit Data Bank (65816 only)</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="editors.html#note">Edit Note</a></li>
|
|
|
|
<li><a href="editors.html#project-symbol">Edit Project Symbol</a></li>
|
2021-10-08 15:36:44 +00:00
|
|
|
<li><a href="editors.html#lvtable">Create / Edit Local Variable Table</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2019-12-06 22:49:35 +00:00
|
|
|
<li><a href="visualization.html">Visualizations</a>
|
|
|
|
<ul>
|
|
|
|
<li><a href="visualization.html#overview">Overview</a></li>
|
|
|
|
<li><a href="visualization.html#vis-and-sets">Visualizations and Visualization Sets</a></li>
|
|
|
|
<li><a href="visualization.html#runtime">Scripts Included with SourceGen</a></li>
|
|
|
|
</ul></li>
|
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="codegen.html">Code Generation & Assembly</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="codegen.html#generate">Generating Source Code</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="codegen.html#localizer">Label Localizer</a></li>
|
2020-10-17 23:10:48 +00:00
|
|
|
<li><a href="codegen.html#reserved-labels">Reserved Label Names</a></li>
|
|
|
|
<li><a href="codegen.html#platform-features">Platform-Specific Features</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="codegen.html#assemble">Cross-Assembling Generated Code</a></li>
|
2021-07-31 21:42:36 +00:00
|
|
|
<li><a href="codegen.html#supported">Supported Assemblers</a>
|
2018-10-23 23:06:29 +00:00
|
|
|
<ul>
|
2021-07-31 21:42:36 +00:00
|
|
|
<li><a href="codegen.html#version">Version-Specific Code Generation</a></li>
|
|
|
|
<li><a href="codegen.html#quirks">Assembler-Specific Bugs & Quirks</a>
|
|
|
|
<ul>
|
|
|
|
<li><a href="codegen.html#64tass">64tass</a></li>
|
|
|
|
<li><a href="codegen.html#acme">ACME</a></li>
|
|
|
|
<li><a href="codegen.html#cc65">cc65</a></li>
|
|
|
|
<li><a href="codegen.html#merlin32">Merlin 32</a></li>
|
|
|
|
</ul></li>
|
2018-10-23 23:06:29 +00:00
|
|
|
</ul></li>
|
2019-09-27 20:43:58 +00:00
|
|
|
<li><a href="codegen.html#export-source">Exporting Source Code</a>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="settings.html">Properties & Settings</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="settings.html#app-settings">Application Settings</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="settings.html#appset-codeview">Code View</a></li>
|
2019-08-18 23:42:40 +00:00
|
|
|
<li><a href="settings.html#appset-textdelim">Text Delimiters</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="settings.html#appset-asmconfig">Asm Config</a></li>
|
|
|
|
<li><a href="settings.html#appset-displayformat">Display Format</a></li>
|
|
|
|
<li><a href="settings.html#appset-pseudoop">Pseudo-Op</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
|
|
|
<li><a href="settings.html#project-properties">Project Properties</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="settings.html#projprop-general">General</a></li>
|
|
|
|
<li><a href="settings.html#projprop-projsym">Project Symbols</a></li>
|
|
|
|
<li><a href="settings.html#projprop-symfiles">Symbol Files</a></li>
|
|
|
|
<li><a href="settings.html#projprop-extscripts">Extension Scripts</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="tools.html">Tools</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2020-07-04 00:37:04 +00:00
|
|
|
<li><a href="tools.html#instruction-chart">Instruction Chart</a></li>
|
|
|
|
<li><a href="tools.html#ascii-chart">ASCII Chart</a></li>
|
2020-09-21 00:42:40 +00:00
|
|
|
<li><a href="tools.html#apple2-screen-chart">Apple II Screen Chart</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="tools.html#hexdump">Hex Dump Viewer</a></li>
|
2019-12-29 01:14:29 +00:00
|
|
|
<li><a href="tools.html#file-concat">File Concatenator</a></li>
|
2020-07-04 00:37:04 +00:00
|
|
|
<li><a href="tools.html#file-slicer">File Slicer</a></li>
|
|
|
|
<li><a href="tools.html#omf-converter">OMF Converter</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="advanced.html">Advanced Topics</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2018-10-08 22:30:43 +00:00
|
|
|
<li><a href="advanced.html#platform-symbols">Platform Symbol Files (.sym65)</a></li>
|
2021-10-16 18:36:13 +00:00
|
|
|
<li><a href="advanced.html#extension-scripts">Extension Scripts</a>
|
|
|
|
<ul>
|
|
|
|
<li><a href="advanced.html#built-in">Built-In Scripts</a>
|
|
|
|
<li><a href="advanced.html#script-dev">Script Development</a>
|
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="advanced.html#multi-bin">Working With Multiple Binaries</a></li>
|
|
|
|
<li><a href="advanced.html#overlap">Overlapping Address Spaces</a></li>
|
2020-07-10 20:29:36 +00:00
|
|
|
<li><a href="advanced.html#reloc-data">OMF Relocation Dictionaries</a></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="advanced.html#debug">Debug Menu Options</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="analysis.html">Appendix: Instruction and Data Analysis</a>
|
2018-09-28 17:05:11 +00:00
|
|
|
<ul>
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="analysis.html#analysis-process">Analysis Process</a>
|
2018-10-04 01:03:04 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="analysis.html#auto-format">Automatic Formatting</a></li>
|
|
|
|
<li><a href="analysis.html#undo-redo">Interaction With Undo/Redo</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
|
|
|
<li><a href="analysis.html#code-analysis">Code Analysis</a>
|
2018-10-04 01:03:04 +00:00
|
|
|
<ul>
|
|
|
|
<li><a href="analysis.html#extension-scripts">Extension Scripts</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
<li><a href="analysis.html#data-analysis">Data Analysis</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2021-10-19 00:56:08 +00:00
|
|
|
<li><a href="end-notes.html">End Notes</a></li>
|
2018-10-04 01:03:04 +00:00
|
|
|
|
2021-06-08 00:49:23 +00:00
|
|
|
<!--
|
2018-10-09 17:04:10 +00:00
|
|
|
<li><a href="tutorials.html">Tutorials</a>
|
2018-10-04 01:03:04 +00:00
|
|
|
<ul>
|
2018-11-08 19:35:35 +00:00
|
|
|
<li><a href="tutorials.html#basic-features">Tutorial #1: Basic Features</a></li>
|
|
|
|
<li><a href="tutorials.html#advanced-features">Tutorial #2: Advanced Features</a></li>
|
2019-10-30 16:49:11 +00:00
|
|
|
<li><a href="tutorials.html#address-tables">Tutorial #3: Address Table Formatting</a></li>
|
|
|
|
<li><a href="tutorials.html#extension-scripts">Tutorial #4: Extension Scripts</a></li>
|
2019-12-29 01:14:29 +00:00
|
|
|
<li><a href="tutorials.html#visualizations">Tutorial #5: Visualizations</a></li>
|
2018-10-09 17:04:10 +00:00
|
|
|
</ul></li>
|
2021-06-08 00:49:23 +00:00
|
|
|
-->
|
2018-10-04 01:03:04 +00:00
|
|
|
|
2018-09-28 17:05:11 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2018-10-09 17:04:10 +00:00
|
|
|
<div id="footer">
|
|
|
|
<hr/>
|
2020-09-21 00:42:40 +00:00
|
|
|
<p>Copyright 2020 faddenSoft</p>
|
2018-09-28 17:05:11 +00:00
|
|
|
</div>
|
2021-10-08 18:01:03 +00:00
|
|
|
|
|
|
|
<script>
|
|
|
|
// Show a warning when reading the manual on the web (rather than
|
|
|
|
// from a file in the SourceGen installation directory).
|
|
|
|
var proto = window.location.protocol;
|
|
|
|
console.log(proto);
|
|
|
|
if (proto == "http:" || proto == "https:") {
|
|
|
|
document.getElementById("webwarn").style.display = "block";
|
|
|
|
}
|
|
|
|
</script>
|
|
|
|
|
2018-09-28 17:05:11 +00:00
|
|
|
</body>
|
|
|
|
</html>
|