diff --git a/.gitignore b/.gitignore index afe86f5..04c527d 100644 --- a/.gitignore +++ b/.gitignore @@ -10,3 +10,5 @@ patches/ .vamosrc activate test/report.txt +test/TestSuite.info +src/report.txt diff --git a/README.md b/README.md index a46a986..0a844d2 100644 --- a/README.md +++ b/README.md @@ -130,6 +130,7 @@ Socket Library Close * [Hop to the Top: Bunny's Revenge](https://rabbit.robsmithdev.co.uk/) * The game uses this extension to send and receive high score information. I also did some of the art for the game! +* [Gopherized](https://allanon71.itch.io/gopherized) Doing something cool with the extension? [Contact me](https://theindustriousrabbit.com/about) and I'll add it to the list! @@ -168,10 +169,12 @@ throw a link to theindustriousrabbit.com somewhere! You can also find a donate link on [the About section on The Industrious Rabbit](https://theindustriousrabbit.com/about). -## Feedback? Bug reports? +## Feedback? Bug reports? Patches? -Go to the [About section on The Industrious Rabbit](https://theindustriousrabbit.com/about) -to contact me. +First, run `test/TestSuite` to generate a `report.txt` file. + +Then, go to the [About section on The Industrious Rabbit](https://theindustriousrabbit.com/about) +to contact me, send the `report.txt` along with the details on your issue. ## Changelog @@ -213,13 +216,13 @@ Internal release. ### 1.1.4 (2024-04-26) -* Fix bug in fdset macro where using D3 for a parameter could cause corruption -* Copy a null-terminated copy of IP address for `SocketIPAddressPortToSockaddr` -* Add test suite to exercise extension functionality -* Fix several crash bugs found due to the test suite -* Retructure API docs for easier reading +* Fix bug in fdset macro where using D3 for a parameter could cause corruption. +* Copy a null-terminated copy of IP address for `SocketIPAddressPortToSockaddr`. +* Add test suite to exercise extension functionality. +* Fix several crash bugs found due to the test suite. +* Retructure API docs for easier reading. -# Development +## Development ### Environment @@ -251,9 +254,25 @@ Run `bin/setup` to do most of the setups above. ### Debugging +#### Cross-platform + Modify data in the `DebugArea` and read it by `Peek`/`Deek`/`Leek`ing from the base address provided by `Socket Get Debug Area`. +#### WinUAE/FS-UAE + +In the debugger, set a memory breakpoint at `$100` for two written bytes: + +``` +w 0 100 2 +``` + +Then, in your code, clear those two bytes to stop execution at that point: + +```asm + CLR.W $100 +``` + ### Releasing #### Ubuntu/Debian diff --git a/src/BSDSocket_Labels.s b/src/BSDSocket_Labels.s index edcfc99..83b9efb 100644 --- a/src/BSDSocket_Labels.s +++ b/src/BSDSocket_Labels.s @@ -1,5 +1,5 @@ ; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -; BSDSocket.s, list of the library functions on the 26-04-2024 20:54:05 +; BSDSocket.s, list of the library functions on the 26-04-2024 22:25:06 ; ; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ L_Cold: set 0 diff --git a/src/BSDSocket_Size.s b/src/BSDSocket_Size.s index 9109d2a..56fa0e9 100644 --- a/src/BSDSocket_Size.s +++ b/src/BSDSocket_Size.s @@ -1,5 +1,5 @@ ; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -; BSDSocket.s, library size on the 26-04-2024 20:54:05 +; BSDSocket.s, library size on the 26-04-2024 22:25:06 ; ; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Lib_Size equ 39