Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/v0_9_0 7fb86da92 -> e4e2803c5


added instructions to handle gcc6 warnings in get_started.md


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: 
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/e4e2803c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/e4e2803c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/e4e2803c

Branch: refs/heads/v0_9_0
Commit: e4e2803c52bd1b6d690aee447cb5fa300cc8f90f
Parents: 7fb86da
Author: aditihilbert <ad...@runtime.io>
Authored: Fri Sep 16 13:51:50 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Fri Sep 16 13:52:59 2016 -0700

----------------------------------------------------------------------
 docs/os/get_started/native_tools.md | 27 +++++++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/e4e2803c/docs/os/get_started/native_tools.md
----------------------------------------------------------------------
diff --git a/docs/os/get_started/native_tools.md 
b/docs/os/get_started/native_tools.md
index 97a2665..282d919 100644
--- a/docs/os/get_started/native_tools.md
+++ b/docs/os/get_started/native_tools.md
@@ -29,9 +29,7 @@ $ brew install gcc
 
 <br>
 
-Check the gcc version you have installed (either using brew or previously 
installed). If the gcc version is 6.1 rather the expected 5.x by the default 
.yml configuration file, you have to modify the 
`<mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml` 
file to change the default `gcc v-5` defined there.
-
-Replace the lines shown highlighted below:
+Check the gcc version you have installed (either using brew or previously 
installed). The brew-installed version can be checked using `brew list gcc`. 
The default compiler.yml configuration file in Mynewt expects version 5.x for 
Mac users, so if the installed version is 6.x and you wish to continue with 
this newer version, modify the 
`<mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml` 
file to change the default `gcc-5` defined there to `gcc-6`. In other words, 
replace the lines shown highlighted below:
 
 ```hl_lines="2 3"
 # OS X.
@@ -61,7 +59,28 @@ compiler.path.objsize.DARWIN.OVERWRITE: "objsize"
 compiler.path.objcopy.DARWIN.OVERWRITE: "gobjcopy"
 ```
 
-**Note:** Both the newer gcc 6.x and Clang report a few warnings but they can 
be ignored.
+<br>
+
+**NOTE:** Both the newer gcc 6.x and Clang report a few warnings but they can 
be ignored.
+
+<br>
+
+**FURTHER NOTE:** Mynewt developers mostly use gcc 5.x for sim builds; so it 
may take a little while to fix issues reported by the newer compiler. One 
option is to **disable warnings**. To do that, remove the `-Werror` flag as an 
option for the compiler in the  
`<mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml` 
file as shown below. 
+
+```hl_lines="2"
+compiler.flags.base: >
+    -m32 -Wall -ggdb
+```
+
+You may alternatively choose to **specify the precise warnings to ignore** 
depending on the error thrown by the compiler. For example, if you see a 
`[-Werror=misleading-indentation]` error while building the sim image, add 
`-Wno-misleading-indentation]` as a compiler flag in the same line from the 
`<mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml` 
file.
+
+```hl_lines="2"
+compiler.flags.base: >
+    -m32 -Wall -Werror -ggdb -Wno-misleading-indentation
+```
+
+
+A third option is to simply **downgrade to gcc 5.x**.
 
 <br>
 

Reply via email to