cmake example

只要一段時間沒有寫某特定程式語言，就會忘記語法。

保留一下 sample code，看以後會不會比較快撈回來。

CMakeLists.txt:

cmake_minimum_required(VERSION 3.10) project(hello) find_package(DBus1 REQUIRED) include_directories(./inc ${DBus1_INCLUDE_DIRS}) add_executable(hello src/test.c) target_link_libraries(hello ${DBus1_LIBRARIES})

git command line

最近需要在 Linux 終端機介面用 git 做版本控制。

用習慣了 windows 的 TortoiseGit 後，在 command line 反而不會用。Linux GUI 介面的 gitk、 git-gui等等也因為沒有 GUI 不能使用。

所以記錄一下command line 的命令：

如何寫出好API文件

寫程式庫會需要寫 API 告訴使用者如何使用。
之前看過的  API 文件有些缺點。

• Doxygen：常常太簡陋。
• 仔細思考，問題出在寫的內容太少。
• 全部整理成為一個文件：覺得超長看不下去。
• 廠商的 reference manual 多半這樣寫。
• 仔細思考，因為用文件的唸法照順序念，當然太長。
• MSDN：很適合
• 內容很多，但是分頁下去後，可以只看想看的部分就好。

在 C 語言怎樣做物件導向

之前有機會看一個 open source 的 C 程式碼，看完了才發現居然是 C 語言。還以為是用 C++ 寫的。

https://github.com/gpac/gpac/blob/master/src/compositor/mpeg4_audio.c

如何解決 Refactoring 改很大很難下手的問題

程式寫久了都會亂，需要重整。但是整理程式碼是吃力不討好的工作：

• 做的好，程式看起來完全沒有差異。
• 改錯了，原本穩定的程式立刻收到 bug reports。

雖然吃力不討好，但是要長久維護一個程式，整理程式碼是必須的動作。不然專案會越維護越痛苦，直到最後改不動，只能砍掉重寫。

以下是要幫大型專案重整的技巧。

Getting start文件範本

開發程式常常會遇到要交接程式專案。

之前接手過幾次別人的程式，對方往往把什麼都不懂的狀態的交接的人叫到電腦前面，隨便快速的操作一通，就認為交接完成。事實上，不但來不及學，寶貴的經驗也無法傳承。

所以為了讓接手的人能夠快速上手，不要丟失經驗傳承，也為了不要在要交接給別人時手忙腳亂，我會在平時就寫好 Getting Start 的文件。

目前我寫過的 Getting Start 文件大概都長這樣

把既有程式改成 MVC Design Pattern

程式開發久了通常會遇到頁面上的控制項的關聯越來越亂的問題

• 可能 控制項A 會改狀態列的訊息，控制項B 卻忘了改。
• 可能 控制項A 改了，值卻沒有存下來。或是按了取消，值卻存下來了。

當頁面上的控制項越多，維護這些關聯就更困難。這時候最適合採用 MVC design pattern。