Update readme

Author: mbtools

CHANGELOG.md

@@ -15,10 +15,10 @@ and [ISO Date Format](https://www.iso.org/iso-8601-date-and-time-format.html).
 ### Fixed
 
 
-## Version [1.0.0] - 2022-01-01
+## Version [1.0.0] - 2025-04-23
 
 Initial Release.
 
 
-[Unreleased]: https://github.com/Marc-Bernard-Tools/ABAP-.../compare/1.0.0...main
-[1.0.0]: https://github.com/Marc-Bernard-Tools/ABAP-.../releases/tag/1.0.0
+[Unreleased]: https://github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit/compare/1.0.0...main
+[1.0.0]: https://github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit/releases/tag/1.0.0

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright 2023 Marc Bernard <https://marcbernardtools.com/>
+Copyright 2025 Marc Bernard <https://marcbernardtools.com/>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,34 +1,60 @@
-![Version](https://img.shields.io/endpoint?url=https://shield.abap.space/version-shield-json/github/Marc-Bernard-Tools/ABAP-XXX/src/zcl_XXX.clas.abap/c_version&label=Version&color=blue)
+![Version](https://img.shields.io/endpoint?url=https://shield.abap.space/version-shield-json/github/Marc-Bernard-Tools/Debugger-Ext-for-abapGit/src/zabapgit_ext_debugger.enho.fa4cfd43.abap/version&label=Version&color=blue)
 
-[![License](https://img.shields.io/github/license/Marc-Bernard-Tools/ABAP-XXX?label=License&color=green)](LICENSE)
+[![License](https://img.shields.io/github/license/Marc-Bernard-Tools/Debugger-Ext-for-abapGit?label=License&color=green)](LICENSE)
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?color=green)](https://github.com/Marc-Bernard-Tools/.github/blob/main/CODE_OF_CONDUCT.md)
-[![REUSE Status](https://api.reuse.software/badge/github.com/Marc-Bernard-Tools/ABAP-XXX)](https://api.reuse.software/info/github.com/Marc-Bernard-Tools/ABAP-XXX)
+[![REUSE Status](https://api.reuse.software/badge/github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit)](https://api.reuse.software/info/github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit)
 
-# XXX
+# Debugger Extension for abapGit
 
-<description>
+Enhancement for the ABAP debugger to jump to the correct trigger location for exception classes that use static methods to raise exceptions like `ZCX_ABAPGIT_EXCEPTION` used in abapGit.
 
 Made by [Marc Bernard Tools](https://marcbernardtools.com/) giving back to the [SAP Community](https://community.sap.com/)
 
 NO WARRANTIES, [MIT License](LICENSE)
 
+## Background
+
+The ABAP debugger has a feature to "show the trigger location" of the last raised exception. The feature works well when `RAISE EXCEPTION` is used directly. However, if you embed `RAISE EXCEPTION` in a static method of your exception class, for example in `ZCX_ABAPGIT_EXCEPTION=>RAISE(...)`, then the debugger will jump to the location inside your static method and not to the location of the method call.  
+
+You can implement a `GET_SOURCE_POSITION` method in your exception class, but unfortunately, the debugger does not call it :shrug:.
+
 ## Usage
 
-<description>
+After installing this enhancement, the debugger will check if an exception class contains the `SRC_INFO` (or `MS_SRC_INFO`) attribute and use it to determine the trigger location of the exception. 
 
 ## Prerequisites
 
-SAP Basis 7.02 or higher
+- SAP Basis 7.02 or higher
+- Add `SRC_INFO` attribute to your exception class
 
-## Installation
+    ```abap
+    DATA src_info TYPE tpda_sys_srcinfo.
+    ```
+
+- Add `GET_SOURCE_POSITION` method in your exception class
 
-You can install ABAP XXX using [abapGit](https://github.com/abapGit/abapGit) either creating a new online repository for https://github.com/Marc-Bernard-Tools/ABAP-XXX or downloading the repository [ZIP file](https://github.com/Marc-Bernard-Tools/ABAP-XXX/archive/main.zip) and creating a new offline repository.
+- Add the following to the end of the `CONSTRUCTOR` method of your exception class
 
-Recommended SAP package: `$XXX`.
+    ```abap
+    METHOD constructor.
+
+      "...
+    
+      " Save for debugger
+      get_source_position(
+        IMPORTING
+          program_name = src_info-program
+          include_name = src_info-include
+          source_line  = src_info-line ).
+
+    ENDMETHOD.
+    ```
+
+## Installation
 
-```abap
+You can install the Debugger Extension for abapGit using [abapGit](https://github.com/abapGit/abapGit) either creating a new online repository for https://github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit or downloading the repository [ZIP file](https://github.com/Marc-Bernard-Tools/Debugger-Ext-for-abapGit/archive/main.zip) and creating a new offline repository.
 
-```
+Recommended SAP package: `$ABAPGIT-EXT-DEBUGGER`.
 
 ## Contributions
 
@@ -38,7 +64,7 @@ All contributions are welcome! Read our [Contribution Guidelines](CONTRIBUTING.m
 
 Made with :heart: in Canada
 
-Copyright 2023 Marc Bernard <https://marcbernardtools.com/>
+Copyright 2025 Marc Bernard <https://marcbernardtools.com/>
 
 Follow [@marcfbe](https://twitter.com/marcfbe) on Twitter