使用 vim script 協助閱讀程式碼

開啟多個 window 顯示各個符合搜尋結果的位置

在讀原始碼時, 我常常想知道某個變數或函式, 在這個檔案裡被用在那些地方, 而且希望在 vim 裡一次開多個 window, 每個 window 顯示一個位置, 方便同時觀看。若能一併尋找其它檔案更好, 不過那會難許多, 第一步先在同一檔案做到這點, 應該就很有幫助。

針對這個需求, 順便研究一下寫 vim function 需要知道的一些基本知識, 寫好的東西見 ShowMatched(pattern) 相關的程式。

以編輯 eglibc 的 stdlib/setenv.c 為例, 將游標移到 LOCK 後, 按下 \f, 會開個新 tab, 並呈現如下的畫面:

\f 最多會開兩個 tab, 一個 tab 最多六個 window, 待試用一陣子後再來調整它的行為。可用 :wind q 關掉目前 tab 內所有 window。由於很常用到這功能, 我會設個巨集做這件事:

map qq :q      # 關掉目前 window
map qa :wind q # 關掉目前 tab 的全部 window

vim script

在這裡整理一下寫 vim script 時需要知道的基本常識。

基本上 script 的每一行如同在 ex mode 執行:

g/^$/d  # 等同於 :g/^$/d, 砍掉空行

若需要使用 normal mode 的指令, 要配合使用指令 normal:

normal ggdd  # 砍掉第一行
execute "normal \<c-w>l"  # 切到右邊的 window

若需要讀取指令的輸出結果, 可用 redir 導到 register:

redir @a
:g/printf/p
reidr END
put a  # 將搜到 printf 的顯示結果寫到目前的檔案裡

若在導到 register 時, 不希望同時輸出到螢幕, 得將指令先包在函式裡, 再用 silent call FUNCTION:

silent call MyFunc

知道以上幾件事後, 剩下的就是熟悉語法、找些小範例、查查內建的函式, 就可以延伸原本熟悉的 vim 指令成為 script:

• script 語法 (:h script)
• list 和 for (:h Lists)
• function 的注意事項
• 內建函式列表 (:h functions)
• 實用的小範例程式 (foo.vim)、Filter buffer on a search result

如此一來, 不用花多少力氣, 即可讓 vim 的威力增加數倍。

Gtk+ 入門 (2)

上篇提到一點皮毛, 又寫了一陣子 Gtk+ 後, 筆記一下其它入門心得。

Gtk+ multi-thread

見 GDK Reference Manual - Threads、Is GTK+ thread safe? How do I write multi-threaded GTK+ applications? 和 Multi-threaded GTK applications – Part 1: Misconceptions - Operations and other mysteries。

心得如下:

• 要在 gtk_init() 以前呼叫 g_thread_init(NULL) 和 gdk_threads_init()。
• 總之就是在 main thread 裡做事, 若真的萬不得已想在 main thread 以外做事, 記得先呼叫 gdk_threads_enter(), 結束時再呼叫 gdk_threads_enter(), 這會取得和釋放 GDK 的 global lock。
• callback 不需呼叫 gdk_threads_..., 因為在進 callback 前後會呼叫。
• 注意 GDK 的 global lock 沒有加上 PTHREAD_MUTEX_RECURSIVE, 所以在 callback 裡呼叫 gdk_threads_enter() 會 deadlock。有 PTHREAD_MUTEX_RECURSIVE 會方便許多, 不確定 Gtk+ 這樣實作的考量為何。

另外我觀察 Gtk+ 的執行狀態, 平時就是兩個 thread, 一個是 main thread, 另一個大概是負責收 UI event, 而有任何 UI event, callback 會在 main thread 裡執行。雖說是廢話, 不過自己觀察過後感受更踏實。

上述提的 multi-thread, 是指有再另開 thread, 也有用到 UI 裡的東西時, 才需注意的事項。

Tutorial

The GTK+ programming tutorial 超級實用, 每篇文章精簡易讀, 附有簡短完整範例, 並且有 screenshot 可參考, 快速掃過一遍就能找到很多好東西。剩下不清楚的部份, 可用在 devhelp 查詢關鍵函式, 或 google 關鍵函式, 再連到 GTK+ 2 Reference Manual, 可以搞定多數情況。

devhelp 可透過 aptitude install devhelp 安裝。