Follow comments

doc/design/multi_language_interface/why_plain_c.md

@@ -23,8 +23,8 @@ Paddle的多语言接口实现包括一下几个方面:
 ### 使用动态库来分发Paddle
 
 * Paddle的链接方式比较复杂
-	* Paddle链接静态库使用了GCC的--whole-archieve参数，它要求使用Paddle静态库的二进制，在链接参数中指定`--whole-archieve paddle_xxx_lib --no-whole-archive`。且这个链接参数是GCC独有的。对于clang或者msvc，参数会不同。这增加了用户使用Paddle静态库的难度。
-* 编译型语言，例如C/C++使用静态库和动态库难度差不多。但是含有解释器的语言，例如[Python](http://stackoverflow.com/questions/19560594/how-to-import-static-library-in-python)或者[Java](http://stackoverflow.com/questions/24493337/linking-static-library-with-jni)，调用动态库远比调用静态库方便。
+    * 如果用户要把Paddle的静态库（libpaddle.a）链接到自己的程序里，得使用 `--whole-archive` (for GCC) 或者 `--force_load` (for Clang) 参数，来确保把 libpaddle.a 里所有的符号都写入自己的程序的二进制文件里。这是因为 Paddle 的源码里使用了[object factory design pattern](http://stackoverflow.com/a/1310326/724872)。
+* 编译型语言，例如C/C++使用静态库和动态库难度差不多。但是解释性语言，例如[Python](http://stackoverflow.com/questions/19560594/how-to-import-static-library-in-python)或者[Java](http://stackoverflow.com/questions/24493337/linking-static-library-with-jni)，只能调用Paddle的动态库，否则得把Paddle静态库链接到解释器里。
     * 解释性语言实际运行的二进制是解释器本身，如果调用静态库只能将静态库与解释器链接。例如对于Java来说，便是将静态库加入JVM中。这对于通常的Java的开发者来说，是不常见的做法。
 
 ### 动态库中不嵌入任何其他语言的解释器
@@ -51,25 +51,43 @@ Paddle的多语言接口实现包括一下几个方面:
 * Paddle内部的类为C++书写，直接导出到C的接口比较困难。
 * 在C-API中使用`void*`来表示Paddle内部类。再在每一个API中自己检查类型。
 
-```C
+在C的头文件 `paddle_matrix.h` 中:
 
-// in Paddle.h
+```C
 typedef void* paddle_matrix;
+typedef int paddle_error;
+
+extern "C"
+paddle_error paddle_matrix_shape(paddle_matrix matrix,
+                                 uint64_t* width,
+                                 uint64_t* height);
+```
+而在CPP里面实现这个C的接口，文件 `paddle_matrix.cpp`
+
+```cpp
+#include "paddle/math/matrix.hpp"
+extern "C"
+paddle_error paddle_matrix_shape(paddle_matrix matrix,
+                                 uint64_t *width,
+                                 uint64_t *height) {
+  auto m = (paddle::math::matrix*)(matrix);
+  *width = m->width();
+  *height = m->height();
+}
+```
 
-extern "C" paddle_error getShape(paddle_matrix mat, uint64_t* height, uint64_t* width);
+其中`paddle/math/matrix.hpp`文件内容为:
 
+```cpp
+namespace paddle {
+namespace math {  
 
-// in matrix.cpp
-struct PaddleMatrix {
-   int type;
-   paddle::MatrixPtr mat;
+class Matrix {
+  //...
 };
 
-paddle_error get_shape(paddle_matrix m, uint64_t* height, uint64_t* width) {
-	PaddleMatrix* realMat = (PaddleMatrix*)(m);
-	...
-}
-
+}  // namespace math
+}  // namespace paddle
 ```
 
 ### 不使用SWIG这种代码生成器，而是手写多语言绑定