| 1 | Release 3 (WiP)\r |
| 2 | ---------------\r |
| 3 | 0) Fixed the windows respawning in the next emulator launch within --alpine or --debugger options\r |
| 4 | 1) Added an Exception Vector Table browser window\r |
| 5 | 2) Modified the About window to update the credits list in a more appropriate way\r |
| 6 | -- Updated the emulator application credits line\r |
| 7 | 3) Added 'Rx' word to the emulator name\r |
| 8 | 4) Fixed a crash when reading the DWARF information in the case of the DWARF2 format has not been used\r |
| 9 | 5) Added ui, alpine & debugger groups in the settings\r |
| 10 | 6) Added the possibility to erase settings\r |
| 11 | 7) Added the --es-all, --es-ui, --es-alpine & --es-debugger options to erase specific settings\r |
| 12 | 8) Added a keybindings tab and adapted the configuration dialog tabs\r |
| 13 | -- User can modify the keybindings where appropriate\r |
| 14 | 9) Fixed a crash, in Release mode, when the HW labels setting is turn on\r |
| 15 | 10) Solved an interference between the HW labels setting and the one used by the debugger\r |
| 16 | -- The setting is now only the reference used\r |
| 17 | 11) Fixed the SP (Stack) window UI potential missing data\r |
| 18 | 12) Create a directory for EEPROMs (based on the EEPROMs setting) if it doesn't already exist\r |
| 19 | 13) Keep the scrollbar position in accordance of the M68K PC pointer\r |
| 20 | -- UI displays the source without the need to move down/up the scrollbar\r |
| 21 | 14) Fixed a crash when DWARF report a source line number exceeding the number of lines present in the source file\r |
| 22 | -- This may come from the linker vlink\r |
| 23 | \r |
| 24 | Release 2 (3rd September 2017)\r |
| 25 | ------------------------------\r |
| 26 | 0) Added some error detections when reading the ELF executable file\r |
| 27 | 1) Added all hardware labels (based on the document scans from the Version 2.4 - June 7, 1995)\r |
| 28 | 2) "Step Over" code function for BSR/JSR functions\r |
| 29 | 3) Added the .debug_ranges detection to avoid a detection error\r |
| 30 | 4) DWARF support\r |
| 31 | -- TAG: Compilation Unit, Subprogram, Variables, Types\r |
| 32 | -- Line numbers, symbols, functions\r |
| 33 | 5) Added an All Watch browser window for non-local variables\r |
| 34 | 6) Added a heap allocator browser window based on my own memory allocation functions\r |
| 35 | 7) Added additional 4 memory browser windows with address input based on hexa, decimal or symbol name\r |
| 36 | 8) Windows refreshing executed only if windows is visible\r |
| 37 | 9) Added a restart function\r |
| 38 | -- Restart only the 68000 program counter to his original set\r |
| 39 | 10) Modified the icons color backgound for the "Step In" and "Step Over" functions\r |
| 40 | 11) Updated the About window to update the credits list\r |
| 41 | 12) 64 bits Release executable\r |
| 42 | 13) Fixed (hacking) the display of the SP (Stack) memory browser\r |
| 43 | 14) Set the emulator in Halt mode when launched in alpine debug mode without a loaded rom\r |
| 44 | -- Otherwise the 68000 program counter will have a 0 value and will execute the code at this address\r |
| 45 | 15) Added some information in the --help/-h/-? option\r |
| 46 | 16) --debugger option no longer force the log file\r |
| 47 | 17) Added a --dram-max option to extend the DRAM size to 8MB\r |
| 48 | 18) Added the "enter" key support when setting the BPM (Breapoint)\r |
| 49 | 19) Save the windows positions, size and visibilities (show or hide) status\r |
| 50 | -- Such windows will automatically respawn in the next emulator launch\r |
| 51 | \r |
| 52 | Release 1 (12th February 2017)\r |
| 53 | ------------------------------\r |
| 54 | 0) BPM (Breapoint) now stop at the designated address and no longer stop after executing the code\r |
| 55 | 1) Clean-up the tracing / no-tracing flags for better U.I understanding\r |
| 56 | 2) Added SP (Stack) memory browser\r |
| 57 | 3) User can change now the number of lines of disassembly displayed in the tracing window\r |
| 58 | 4) User can turn on/off the op-codes associated in the disassembly lines displayed in the M68K tracing window\r |
| 59 | 5) Added an emulator status window (GPU status, M68K debugger & tracking status)\r |
| 60 | 6) Added a GPU disassembly tracing window - Display the current PC pointer\r |
| 61 | 7) Added a DSP disassembly tracing window - Display the current PC pointer\r |
| 62 | 8) Added possibility to change refresh rate of browser windows when emulation is launched\r |
| 63 | 9) Display partial hardware labels (Internal Memory & Graphics sub-system address space) in the disassembly lines displayed in the M68K tracing window\r |
| 64 | -- Display first the hardware labels (based from the Jag V8 dev. PDF) and then the ones possibly found in the ELF debug symbol\r |
| 65 | 10) Minor U.I cosmetic changes\r |
| 66 | 11) User can turn on/off the hardware labels associated in the disassembly lines displayed in the M68K tracing window\r |
| 67 | -- It doesn't apply to the hardware labels possibly found in the ELF debug symbol\r |
| 68 | \r |
| 69 | Release 0 (5th January 2017)\r |
| 70 | ----------------------------\r |
| 71 | 0) New option --debugger\r |
| 72 | 1) ELF format support\r |
| 73 | 2) ELF debug symbol support\r |
| 74 | 3) "Step Into" code function\r |
| 75 | 4) Menus layout dedicated to the debugger\r |
| 76 | 5) Added a dedicated main window for tracing (M68K)\r |
| 77 | 6) Added a Debugger tab in the config tab\r |
| 78 | 7) Visual Studio 2015 project support\r |
| 79 | 8) libelf-0.8.13 library support\r |
| 80 | 9) 64 bits debug executable only\r |
| 81 | \r |
| 82 | \r |
| 83 | Known issues\r |
| 84 | ============\r |
| 85 | 1) Video output is not displayed due to my OpenGL / QT5 integration with VS 2015\r |
| 86 | 2) The BPM (Breapoint) remains stuck on his address when user wants to continue the code execution\r |
| 87 | -- Need to trace over the BPM or unset the BPM\r |
| 88 | 3) To handle DWARF 2 issues with GCC, the code must be compiled with the -gdwarf-2 option\r |
| 89 | 4) The Watch variables list may display not available (N/A) type information\r |
| 90 | -- Such missing information may be included in future release\r |
| 91 | 5) The 2MB mirroring is no longer applied in case of --dram-max option usage\r |
| 92 | 6) Stack must reflect the --dram-max option usage otherwise the stack may be corrupted\r |
| 93 | -- The application needs to set the SP (Stack) in accordance\r |
| 94 | 7) The Exception Vector Table broswer window displays only 65 vectors\r |
| 95 | -- Missing vectors may be added in future release\r |
| 96 | 8) User needs to manualy check if the Atari Jaguar executable match his source code files\r |
| 97 | -- Otherwise, source code and assembly may not match or leads to instabilities\r |
| 98 | 9) Application needs to be restarted in case of keybindings changes\r |
| 99 | \r |
| 100 | Cosmetic / UX issues\r |
| 101 | ====================\r |
| 102 | 1) The SP (Stack) icon color backgound doesn't look similar with the other ones\r |
| 103 | 2) The emulator status option has no icon\r |
| 104 | 3) The SP (Stack) window size always open at a forced size no matter if the size has been changed\r |
| 105 | 4) Not every features have associated keybindings\r |
| 106 | \r |
| 107 | Legacy issues/hints\r |
| 108 | ===================\r |
| 109 | 1) Emulator seems to have easter egg(s)\r |
| 110 | -- The option --yarrr displays a single message and end the application\r |
| 111 | -- Pressing F8, while in the main window, will create an extra message in the log file\r |
| 112 | 2) The --alpine option force the log file but it can be override if --no-log option is set after the --alpine option\r |
| 113 | \r |
| 114 | Project information\r |
| 115 | ===================\r |
| 116 | 1) Code based on the Shamus Hammons source code available via Gethub by the 12th September 2017 (2.1.3 Final)\r |
| 117 | 2) Visual Studio 2015 project support for 64 bits\r |
| 118 | 3) libelf 0.8.13 library 64bits for VS 2015\r |
| 119 | 4) libdwarf 1.41 library 64bits for VS 2015, cygwin64 & Msys2/MinGW64\r |
| 120 | 5) QT 5.5.1 library 64bits for VS 2015\r |
| 121 | 6) Zlib 1.2.8 library 64bits for VS 2015\r |
| 122 | 7) SDL 1.2.15 library 64bits for VS 2015\r |
| 123 | 8) The original make files have been modified to follow the requirements and modifications\r |
| 124 | 9) The 'Rx' word has been added to the emulator name to make distinction with the official version\r |
| 125 | 10) The project source is set at https://github.com/djipi/Virtual-Jaguar-Rx\r |
| 126 | 11) GPLv3 file document has been renamed as LICENSE, to fit better the GitHub requirements\r |
| 127 | -- Text / License terms are the same\r |
| 128 | \r |
| 129 | \r |
| 130 | Download statistics\r |
| 131 | -------------------\r |
| 132 | jaguar64eu : 15 downloads for the Release 0 on the 12th Feb, 2017\r |
| 133 | jaguar64eu : 18 downloads for the Release 1 on the 21st May, 2017\r |
| 134 | No downloads statistics available for the Release 2 |