From 924d242b390199f82f93af4416f6db50901f3f62 Mon Sep 17 00:00:00 2001
From: Jimmy Brisson <theotherjimmy@gmail.com>
Date: Thu, 15 Sep 2016 15:01:22 -0500
Subject: [PATCH] Add documentation about profiles to the toolcahins

---
 tools/toolchains/arm.py | 3 +++
 tools/toolchains/gcc.py | 3 +++
 tools/toolchains/iar.py | 3 +++
 3 files changed, 9 insertions(+)

diff --git a/tools/toolchains/arm.py b/tools/toolchains/arm.py
index a7ecc848a4..4629cadaa9 100644
--- a/tools/toolchains/arm.py
+++ b/tools/toolchains/arm.py
@@ -32,6 +32,9 @@ class ARM(mbedToolchain):
     DEP_PATTERN = re.compile('\S+:\s(?P<file>.+)\n')
 
 
+    # ANY changes to these default flags is backwards incompatible and require
+    # an update to the mbed-sdk-tools and website that introduces a profile
+    # for the previous version of these flags
     DEFAULT_FLAGS = {
         'common': ["-c", "--gnu",
             "-Otime", "--split_sections", "--apcs=interwork",
diff --git a/tools/toolchains/gcc.py b/tools/toolchains/gcc.py
index 27bc11fede..3df4d17a42 100644
--- a/tools/toolchains/gcc.py
+++ b/tools/toolchains/gcc.py
@@ -29,6 +29,9 @@ class GCC(mbedToolchain):
     DIAGNOSTIC_PATTERN = re.compile('((?P<file>[^:]+):(?P<line>\d+):)(\d+:)? (?P<severity>warning|error): (?P<message>.+)')
     INDEX_PATTERN  = re.compile('(?P<col>\s*)\^')
 
+    # ANY changes to these default flags is backwards incompatible and require
+    # an update to the mbed-sdk-tools and website that introduces a profile
+    # for the previous version of these flags
     DEFAULT_FLAGS = {
         'common': ["-c", "-Wall", "-Wextra",
             "-Wno-unused-parameter", "-Wno-missing-field-initializers",
diff --git a/tools/toolchains/iar.py b/tools/toolchains/iar.py
index 74591ab8cd..d8f5bbc5fc 100644
--- a/tools/toolchains/iar.py
+++ b/tools/toolchains/iar.py
@@ -30,6 +30,9 @@ class IAR(mbedToolchain):
     DIAGNOSTIC_PATTERN = re.compile('"(?P<file>[^"]+)",(?P<line>[\d]+)\s+(?P<severity>Warning|Error)(?P<message>.+)')
     INDEX_PATTERN  = re.compile('(?P<col>\s*)\^')
 
+    # ANY changes to these default flags is backwards incompatible and require
+    # an update to the mbed-sdk-tools and website that introduces a profile
+    # for the previous version of these flags
     DEFAULT_FLAGS = {
         'common': [
             "--no_wrap_diagnostics",