1
0
mirror of https://github.com/fadden/6502bench.git synced 2025-01-02 18:30:41 +00:00

Update README

This commit is contained in:
Andy McFadden 2019-07-29 14:16:32 -07:00
parent be47b8912b
commit 2a901cc373

View File

@ -4,15 +4,12 @@
[6502bench](https://6502bench.com/) is a code development "workbench" [6502bench](https://6502bench.com/) is a code development "workbench"
for 6502, 65C02, and 65802/65816 code. It currently features one tool, for 6502, 65C02, and 65802/65816 code. It currently features one tool,
the SourceGen disassembler. the SourceGen disassembler, and runs on Windows 7 or later.
You can download the source code and build it yourself, or click the You can download the source code and build it yourself, or click the
[Releases tab](https://github.com/fadden/6502bench/releases) for [Releases tab](https://github.com/fadden/6502bench/releases) for
pre-built downloads. pre-built downloads.
**NEEDED:** ROM/OS symbols for various systems, notably Commodore and Atari
home computers.
## SourceGen ## ## SourceGen ##
@ -99,20 +96,20 @@ There is currently no installer -- just unzip the archive and run the
executable. The data files used by the program are found automatically executable. The data files used by the program are found automatically
based on the path to the .EXE file. based on the path to the .EXE file.
SourceGen relies on the .NET Framework. For Windows, you need to have You need to have Microsoft .NET Framework v4.6.2 or later installed. Most
Microsoft .NET Framework v4.6.2 or later installed. Many people will already people will already have this. If SourceGen doesn't seem to want to start,
have this installed. If SourceGen doesn't seem to want to start, download download the latest version (currently v4.7.2)
the latest version (v4.7.2)
[directly from Microsoft](https://www.microsoft.com/net/download/dotnet-framework-runtime). [directly from Microsoft](https://www.microsoft.com/net/download/dotnet-framework-runtime).
The framework requires Win7 SP1, Win8.1, or Win10 updated through at least The framework requires Win7 SP1, Win8.1, or Win10 updated through at least
the Anniversary Update (1607). (One user who had trouble with the 4.7.2 the Anniversary Update (1607). (One user who had trouble with the 4.7.2
installer was able to get the 4.6.2 installer to work.) installer was able to get the 4.6.2 installer to work.)
In theory, SourceGen can work with Mono under Linux and Mac OS X. There SourceGen does not currently run on Linux or Mac OS X. Versions 1.0 and 1.1
appear to be many incompatibilities between .NET and Mono, which have to used the WinForms API, which has been implemented for Mono, but after
be worked around in SourceGen. Sometimes these are straightforward, encountering significant bugs that I wasn't able to work around I abandoned
sometimes they're [a little weird](https://faddensoft.com/sgbug/). Until the idea and switched to WPF. Besides working better under Windows, WPF
these issues are handled, running SourceGen under Mono is not recommended. uses a more modern approach (XAML) that may ease the transition to a modern
cross-platform GUI like Avalonia.
## Getting Started ## ## Getting Started ##
@ -133,8 +130,7 @@ display it.
All of the code is written in C# .NET, using the (free to download) Visual All of the code is written in C# .NET, using the (free to download) Visual
Studio Community 2017 IDE as the primary development environment. The user Studio Community 2017 IDE as the primary development environment. The user
interface uses the WinForms API. Efforts have been made to avoid doing interface uses the WPF API.
anything Windows-specific, in the hope of running it under Mono.
The Solution file is called "WorkBench.sln" rather than "6502bench.sln" The Solution file is called "WorkBench.sln" rather than "6502bench.sln"
because some things in Visual Studio got weird when it didn't start with a because some things in Visual Studio got weird when it didn't start with a