diff --git a/src/platforms/pc-stlinkv2/README.md b/src/platforms/pc-stlinkv2/README.md
index ad2f78d8..d70b4d7b 100644
--- a/src/platforms/pc-stlinkv2/README.md
+++ b/src/platforms/pc-stlinkv2/README.md
@@ -1,18 +1,25 @@
-Stlink V2/3 with original STM firmware as Blackmagic Debug Probes
+ST-Link V2/3 with original STM firmware as Blackmagic Debug Probes
 
-Recent STM Stlink firmware revision (V3 and V2 >= J32) expose nearly all
-functionality that BMP needs. This branch implements blackmagic debug probe
-for the STM Stlink as a proof of concept.
+Recent STM ST-LINK  firmware revision (V3 and V2 >= J32) expose all
+functionality that BMP needs. This platform implements blackmagic debug
+probe for the STM ST-LINK.
 Use at your own risk, but report or better fix problems.
 
-Run the resulting blackmagic_stlinkv2 executable to start the gdb server
+Compile with "make PROBE_HOST=pc-stlinkv2"
 
-Crosscompling for windows with mingw succeeds.
+Run the resulting blackmagic_stlinkv2 executable to start the gdb server.
+
+You can also use on the command line alone, e.g
+- "blackmagic_stlinkv2 -t" to scan and display the results of the scan
+- "blackmagic_stlinkv2 <file.bin>" to flash <file.bin> at 0x08000000
+- "blackmagic_stlinkv2 -h" for more options
+
+Cross-compling for windows with mingw succeeds.
 
 Drawback:
 - JTAG does not work for chains with multiple devices.
-- STLinkV3 does only work on STM32 devices.
+- ST-LINKV3 seem to only work on STM32 devices.
+- St-LINKV3 needs connect under reset on more devices than V2
 
-This branch may get forced push. In case of problems:
-- git reset --hard master
-- git rebase
+ToDo:
+- Implement an SWO server
\ No newline at end of file