Modifications to emphasize the options available to apps vs porting

SenRamakri · SenRamakri · commit b706d08d93ee · 2019-03-15T14:19:26.000-05:00
diff --git a/docs/tools/tools_intro.md b/docs/tools/tools_intro.md
@@ -49,7 +49,7 @@ You can export your project from any of our tools to third party tools. For inst
 
 To force Arm Compiler 5, you can use the following options:
 
-- Create or update your `mbed_app.json` with:
+- Create or update your `mbed_app.json` as below. This is the recommended method for applications to use ARM Compiler 5.
 
 ```
 {
@@ -61,7 +61,7 @@ To force Arm Compiler 5, you can use the following options:
 }
 ```
 
-- Modify the `supported_toolchains` entry in targets.json to replace all `ARM`, `ARMC6` entries with `ARMC5`: 
+- For porting a target that cannot use Arm Compiler 6 at this time, modify the `supported_toolchains` entry in targets.json to replace all `ARM`, `ARMC6` entries with `ARMC5` as below.  
 
 ```
 "MY_TARGET_NAME": {

Original file line number	Diff line number	Diff line change
`@@ -49,7 +49,7 @@ You can export your project from any of our tools to third party tools. For inst`
`49`	`49`
`50`	`50`	`To force Arm Compiler 5, you can use the following options:`
`51`	`51`
`52`		-- Create or update your `mbed_app.json` with:
	`52`	+- Create or update your `mbed_app.json` as below. This is the recommended method for applications to use ARM Compiler 5.
`53`	`53`
`54`	`54`	```
`55`	`55`	`{`
`@@ -61,7 +61,7 @@ To force Arm Compiler 5, you can use the following options:`
`61`	`61`	`}`
`62`	`62`	```
`63`	`63`
`64`		-- Modify the `supported_toolchains` entry in targets.json to replace all `ARM`, `ARMC6` entries with `ARMC5`:
	`64`	+- For porting a target that cannot use Arm Compiler 6 at this time, modify the `supported_toolchains` entry in targets.json to replace all `ARM`, `ARMC6` entries with `ARMC5` as below.
`65`	`65`
`66`	`66`	```
`67`	`67`	`"MY_TARGET_NAME": {`