Fixes and updates to docs (#2611)

[qmk_firmware.git] / docs / faq_build.md

diff --git a/docs/faq_build.md b/docs/faq_build.md
index ff409f9c612efbfff988a89d60ea088eeaf7e097..2d1b91b60d8280d4144acf3cc8390902c8ece38b 100644 (file)
--- a/docs/faq_build.md
+++ b/docs/faq_build.md
@@ -88,3 +88,19 @@ Note that Teensy2.0++ bootloader size is 2048byte. Some Makefiles may have wrong
 #   USBaspLoader     2048
 OPT_DEFS += -DBOOTLOADER_SIZE=2048
 ```
+
+## `avr-gcc: internal compiler error: Abort trap: 6 (program cc1)` on MacOS
+This is an issue with updating on brew, causing symlinks that avr-gcc depend on getting mangled. 
+
+The solution is to remove and reinstall all affected modules. 
+
+```
+brew rm avr-gcc
+brew rm dfu-programmer
+brew rm gcc-arm-none-eabi
+brew rm avrdude
+brew install avr-gcc
+brew install dfu-programmer
+brew install gcc-arm-none-eabi
+brew install avrdude
+```