From d25f26f5ab3f1ef9720688a42d2f92a4a8c75d96 Mon Sep 17 00:00:00 2001
From: ruki <waruqi@gmail.com>
Date: Tue, 21 Nov 2017 22:44:47 +0800
Subject: add force flags

---
 manual.md    | 19 +++++++++++++++++++
 zh/manual.md | 22 +++++++++++++++++++++-
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/manual.md b/manual.md
index c7a3987c..14f98d6a 100644
--- a/manual.md
+++ b/manual.md
@@ -1647,6 +1647,13 @@ target("test")
 
 关于自定义构建规则的使用说明，详细见：[构建规则](#构建规则)。
 
+<p class="tips">
+默认情况下，添加的cxflags,cflags等编译选项的都是带自动检测和映射的，如果传入的选项，当前编译器不支持，就会自动忽略或者自动映射为当前编译器支持的选项。
+如果觉得传入的参数确实没问题，但是xmake确自动忽略了，这个时候可以通过`xmake -v`显示详细的检测失败信息。
+并且在2.1.9版本之后，可以通过force参数来强制禁用自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+`add_files("src/*.c", {force = {cxflags = "-DTEST", mflags = "-framework xxx"}})`
+</p>
+
 ##### target:del_files
 
 ###### 从前面的源代码文件列表中删除指定文件
@@ -1816,6 +1823,12 @@ add_cflags("-g", "-O2", "-DDEBUG")
 用户无需操心其兼容性，如果其他编译器没有对应的匹配值，那么xmake会自动忽略器设置。
 </p>
 
+在2.1.9版本之后，可以通过force参数来强制禁用flags的自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+
+```lua
+add_cflags("-g", "-O2", {force = true})
+```
+
 ##### target:add_cxflags
 
 ###### 添加c/c++编译选项
@@ -1838,6 +1851,12 @@ add_cflags("-g", "-O2", "-DDEBUG")
 add_mflags("-g", "-O2", "-DDEBUG")
 ```
 
+在2.1.9版本之后，可以通过force参数来强制禁用flags的自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+
+```lua
+add_mflags("-g", "-O2", {force = true})
+```
+
 ##### target:add_mxflags
 
 ###### 添加objc/objc++编译选项
diff --git a/zh/manual.md b/zh/manual.md
index 01c7b6c3..4e27ed39 100644
--- a/zh/manual.md
+++ b/zh/manual.md
@@ -1665,6 +1665,13 @@ target("test")
 
 关于自定义构建规则的使用说明，详细见：[构建规则](#构建规则)。
 
+<p class="tips">
+默认情况下，添加的cxflags,cflags等编译选项的都是带自动检测和映射的，如果传入的选项，当前编译器不支持，就会自动忽略或者自动映射为当前编译器支持的选项。
+如果觉得传入的参数确实没问题，但是xmake确自动忽略了，这个时候可以通过`xmake -v`显示详细的检测失败信息。
+并且在2.1.9版本之后，可以通过force参数来强制禁用自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+`add_files("src/*.c", {force = {cxflags = "-DTEST", mflags = "-framework xxx"}})`
+</p>
+
 ##### target:del_files
 
 ###### 从前面的源代码文件列表中删除指定文件
@@ -1834,6 +1841,13 @@ add_cflags("-g", "-O2", "-DDEBUG")
 用户无需操心其兼容性，如果其他编译器没有对应的匹配值，那么xmake会自动忽略器设置。
 </p>
 
+
+在2.1.9版本之后，可以通过force参数来强制禁用flags的自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+
+```lua
+add_cflags("-g", "-O2", {force = true})
+```
+
 ##### target:add_cxflags
 
 ###### 添加c/c++编译选项
@@ -1848,7 +1862,7 @@ add_cflags("-g", "-O2", "-DDEBUG")
 
 ##### target:add_mflags
 
-###### 添加objcc编译选项 
+###### 添加objc编译选项 
 
 仅对objc代码添加编译选项
 
@@ -1856,6 +1870,12 @@ add_cflags("-g", "-O2", "-DDEBUG")
 add_mflags("-g", "-O2", "-DDEBUG")
 ```
 
+在2.1.9版本之后，可以通过force参数来强制禁用flags的自动检测，直接传入编译器，哪怕编译器有可能不支持，也会设置：
+
+```lua
+add_mflags("-g", "-O2", {force = true})
+```
+
 ##### target:add_mxflags
 
 ###### 添加objc/objc++编译选项
-- 
cgit v1.2.3