linux docs: Add note about precompiled gdb on Arch

Closes github #150: https://github.com/espressif/esp-idf/issues/150

diff --git a/docs/linux-setup.rst b/docs/linux-setup.rst
index cf5e78b63dd80cd1f3d44c15579257e2897c967b..20f460aa62df328b3d1e0acc3f67e37a4c7b2f84 100644 (file)
--- a/docs/linux-setup.rst
+++ b/docs/linux-setup.rst
@@ -17,7 +17,6 @@ To compile with ESP-IDF you need to get the following packages:
     
     sudo pacman -S --needed gcc git make ncurses flex bison gperf python2-pyserial
 
-
 Step 1: Download binary toolchain for the ESP32
 ==================================================
 
@@ -49,6 +48,16 @@ Alternatively, you may create an alias for the above command. This way you can g
 
 Then when you need the toolchain you can type ``get_esp32`` on the command line and the toolchain will be added to your ``PATH``.
 
+Arch Linux Users
+----------------
+
+To run the precompiled gdb (xtensa-esp32-elf-gdb) in Arch Linux requires ncurses 5, but Arch uses ncurses 6. Backwards compatibility libraries are available in AUR_ for native and lib32 configurations:
+- https://aur.archlinux.org/packages/ncurses5-compat-libs/
+- https://aur.archlinux.org/packages/lib32-ncurses5-compat-libs/
+
+(Alternatively, use crosstool-NG to compile a gdb that links against ncurses 6.)
+
+
 Alternative Step 1: Compile the toolchain from source using crosstool-NG
 ========================================================================
 
@@ -156,3 +165,4 @@ Further reading
 
 If you'd like to use the Eclipse IDE instead of running ``make``, check out the Eclipse setup guide in this directory.
 
+.. _AUR: https://wiki.archlinux.org/index.php/Arch_User_Repository