docs: update download links for OpenOCD

Point to the latest release on Github, which can now be produced by CI.

Ref. https://github.com/espressif/openocd-esp32/issues/30
Ref. https://github.com/espressif/openocd-esp32/issues/18

diff --git a/docs/en/api-guides/jtag-debugging/setup-openocd-linux.rst b/docs/en/api-guides/jtag-debugging/setup-openocd-linux.rst
index 434e211eb3604f460e133696e4ca00d56525704a..a9b8286d97afa2c2ccff9805f4dabdf8c4008e95 100644 (file)
--- a/docs/en/api-guides/jtag-debugging/setup-openocd-linux.rst
+++ b/docs/en/api-guides/jtag-debugging/setup-openocd-linux.rst
@@ -1,19 +1,21 @@
-***********************
-Setup OpenOCD for Linux
-***********************
+************************
+Set up OpenOCD for Linux
+************************
 
 
-Setup OpenOCD
-=============
+Set up OpenOCD
+==============
 
-OpenOCD for 64-bit Linux is available for download from Espressif website:
+OpenOCD for 64-bit Linux is available for download from Github:
 
-https://dl.espressif.com/dl/openocd-esp32-linux64-a859564.tar.gz 
+https://github.com/espressif/openocd-esp32/releases
 
-Download this file, then extract it in ``~/esp/`` directory::
+Download latest release archive with `linux64` in its name, for example `openocd-esp32-linux64-0.10.0-esp32-20180418.tar.gz`.
+
+Extract the downloaded file in ``~/esp/`` directory::
 
     cd ~/esp
-    tar -xzf ~/Downloads/openocd-esp32-linux64-a859564.tar.gz 
+    tar -xzf ~/Downloads/openocd-esp32-linux64-<version>.tar.gz 
 
 
 Next Steps

diff --git a/docs/en/api-guides/jtag-debugging/setup-openocd-macos.rst b/docs/en/api-guides/jtag-debugging/setup-openocd-macos.rst
index 826667b44b9c48896277ad71cbff2cc74c252f88..64ecc4eff10a8ca2f498a7977b23147177476c1b 100644 (file)
--- a/docs/en/api-guides/jtag-debugging/setup-openocd-macos.rst
+++ b/docs/en/api-guides/jtag-debugging/setup-openocd-macos.rst
@@ -1,19 +1,26 @@
-***********************
-Setup OpenOCD for MacOS
-***********************
+************************
+Set up OpenOCD for MacOS
+************************
 
 
-Setup OpenOCD
-=============
+Install libusb
+==============
 
-OpenOCD for MacOS is available for download from Espressif website:
+Use `Homebrew <https://brew.sh/>`_ or `Macports <https://www.macports.org/>`_ to install `libusb` package.
 
-https://dl.espressif.com/dl/openocd-esp32-macos-a859564.tar.gz 
+Set up OpenOCD
+==============
 
-Download this file, then extract it in ``~/esp`` directory::
+OpenOCD for MacOS is available for download from Github:
+
+https://github.com/espressif/openocd-esp32/releases
+
+Download latest release archive with `macos` in its name, for example `openocd-esp32-macos-0.10.0-esp32-20180418.tar.gz`.
+
+Extract the downloaded file in ``~/esp/`` directory::
 
     cd ~/esp
-    tar -xzf ~/Downloads/openocd-esp32-macos-a859564.tar.gz 
+    tar -xzf ~/Downloads/openocd-esp32-macos-<version>.tar.gz 
 
 
 Next Steps

diff --git a/docs/en/api-guides/jtag-debugging/setup-openocd-windows.rst b/docs/en/api-guides/jtag-debugging/setup-openocd-windows.rst
index 829984d6331fc2256d7fc91028244129c4d1bb23..12e5560b0051564f75a08cc0a27641d780dfca42 100644 (file)
--- a/docs/en/api-guides/jtag-debugging/setup-openocd-windows.rst
+++ b/docs/en/api-guides/jtag-debugging/setup-openocd-windows.rst
@@ -1,17 +1,22 @@
-*************************
-Setup OpenOCD for Windows
-*************************
+**************************
+Set up OpenOCD for Windows
+**************************
 
 
-Setup OpenOCD
-=============
+Set up OpenOCD
+==============
 
-OpenOCD for Windows / MSYS2 is available for download from Espressif website:
 
-https://dl.espressif.com/dl/openocd-esp32-win32-a859564.zip
+OpenOCD for Windows / MSYS2 is available for download from Github:
 
-Download this file and extract ``openocd-esp32`` folder inside to ``~/esp/`` directory.
+https://github.com/espressif/openocd-esp32/releases
 
+Download latest release archive with `win32` in its name, for example `openocd-esp32-macos-0.10.0-win32-20180418.zip`.
+
+Extract the downloaded file in ``~/esp/`` directory.
+
+    cd ~/esp
+    unzip /c/Users/<user>/Downloads/openocd-esp32-win32-<version>.zip 
 
 Next Steps
 ==========