然而，有些用 Java 寫的重量級套件，會附上完整的啟動 script，自動進行相關的設定，如 CLASSPATH 等。而這些啟動 script，其實並不懂怎麼使用 javavm，因此需要人工設定如 JAVA_HOME 等環境變數。也就是說，要用這些 script，我們就沒辦法利用 javavm 聰明的功能，來幫我們管理 JVMs。

還好，UNIX 系統的強項，就是方便的指令組合功能。如果 JAVAVM_DRYRUN 環境變數存在的話，javavm 就不會真的執行 JVM，而是將相關的環境變數印出來。透過這個機制，我們就可以重用 javavm 的聰明管理機制。如下：

env `env JAVAVM_DRYRUN=yes java | xargs echo` bin/startup.sh

在 FreeBSD 裡，裝了 java/javavmwrapper 以後，/usr/local/bin/java 其實會指到 javavm，自動幫我們選擇 JVM，因此上面的指令我們可以直接使用 java 呼叫。利用 env，我們讓 javavm 一行一行地印出 Java 相關的環境變數，如下：

JAVA_HOME=/usr/local/diablo-jdk1.5.0JAVAVM_CONF=/usr/local/etc/javavmsJAVAVM_OPTS_CONF=/usr/local/etc/javavm_opts.confJAVAVM_PROG=/usr/local/diablo-jdk1.5.0/bin/javaJAVAVM_OPTS=JAVAVM_COMMAND=/usr/local/diablo-jdk1.5.0/bin/java

然後，pipe 給 xargs echo 將這幾行接起來，以空白隔開，然後再餵給 env，變成套件所需的 java 環境變數，以啟動 bin/startup.sh。

剛剛在逛 doxygen 網站，被我發現這個 script：《DoxyGen Syntax : DoxyGen Highlighting on top of c/c++/java》。簡單說，就是能夠在原本 Vim 對 C/C++/Java/... 的 syntax coloring 的基礎上，再增加對註解裡 doxygen 文件內容的 syntax coloring。於是趕緊抓下來試試。

網頁上的安裝方法比較複雜，我試了幾次沒有成功。所以就研究了一下 Vim 的 online document，發現 *mysyntaxfile-add* 這一節這麼說道：

If you are mostly satisfied with an existing syntax file, but would like to add a few items or change the highlighting, follow these steps:

1. Create your user directory from 'runtimepath', see above.
2. Create a directory in there called "after/syntax".  For Unix:

   mkdir ~/.vim/after
   mkdir ~/.vim/after/syntax

3. Write a Vim script that contains the commands you want to use.  For example, to change the colors for the C syntax:

   highlight cComment ctermfg=Green guifg=Green

4. Write that file in the "after/syntax" directory.  Use the name of the syntax, with ".vim" added.  For our C syntax:

   :w ~/.vim/after/syntax/c.vim

That's it.  The next time you edit a C file the Comment color will be different.  You don't even have to restart Vim.

也就是說，放在 ~/.vim/after/syntax 目錄下的檔案，會自動附加到對應檔名的 vim syntax coloring 檔案。如 ~/.vim/after/syntax/c.vim 就會自動附加到 /usr/locall/share/vim/syntax/c.vim 裡。因此，整件事就很簡單啦：為每一個想要增加 doxygen syntax coloring 的檔案類型，複製一份 doxygen syntax 檔以檔案類型為檔名，放在該目錄下即可，正常來說，連一行 ~/.vimrc 的設定都不必加。我的作法如下：

1. 建立 ~/.vim/after/syntax 目錄；
2. 自網頁上下載 doxygen.zip (v1.15)；
3. 解開後得到 doxygen.vim 與 doxygen.txt 兩個檔案，前者是 syntax 檔，後者是說明檔。都放到 ~/.vim/after/syntax 目錄下；
4. 對於每一個想要使用 doxygen syntax coloring 功能的檔案類型，做一個 soft link 如下：

   cd ~/.vim/after/syntax;
   ln -s doxygen.vim c.vim;
   ln -s doxygen.vim cpp.vim;
   ln -s doxygen.vim java.vim;

5. 如果是在 Windows 下，那就在第四步時改用 copy。

有圖有真相：

另外，以下是看到的幾套，doxygen 整合其他 IDE 的 solutions：

• Eclox - Eclox is a simple doxygen frontend plug-in for eclipse.
• Doxbar - DoxBar is an add-in for using doxygen from within Developer Studio (VC6).
• DoxyComment for Visual Studio 2005 - DoxyComment is an add-in for Visual Studio 2005, which can help you insert comment blocks in C/C++ code. Comment blocks are generated based on the current context of the cursor. The add-in integrates nicely into Visual Studio, so you can bind your favourite short-cut keys to its commands.

• 將目前正在編輯的 Visio 檔案的目前頁面，以目前檔名去掉延伸檔名的部分，存檔成 PNG 格式的圖檔 (當然要再加上 .png 副檔名)。
• 理想上，透過 SVG 格式會更好。但是因為目前 OpenOffice.org2 對 SVG 的支援，只有一個半官方的 XML filter 叫 SVG Import Filter for OpenOffice 2.0 勉強可以用，所以暫時還是在 Visio 裡同時存檔成 PNG 與 SVG 檔，先用 PNG，以後有機會再用 SVG。

用 macro 錄製了一下，發覺關鍵很簡單，就是這麼一行：

Application.ActiveWindow.Page.Export <filename>

其中，Visio 會依據 <filename> 的副檔名，決定要 export 成哪種格式。再加上檔名的處理就一切搞定。以下以 Visio 2003 為準，完整 Sub routine 如下：

Sub ExportPageAsPNGandSVG()
'
' Save current diagram as PNG with default transparent color and SVG files.
'
    Dim DotPos
    DotPos= InStrRev(ThisDocument.Name, ".")
    If Not IsNull(DotPos) And DotPos > 0 Then
        Dim NoExtName
        NoExtName = Left(ThisDocument.Name, DotPos - 1)
'        MsgBox NoExtName
        Application.ActiveWindow.Page.Export ThisDocument.Path + NoExtName + ".png"
        Application.ActiveWindow.Page.Export ThisDocument.Path + NoExtName + ".svg"
    Else
        MsgBox "Cannot resolve path name to save, action cancelled."
    End If
End Sub

從 Visio 的選單裡，Tools -> Macros -> Macros，在 Macro name 欄位裡填上 ExportPageAsPNGandSVG，按 Create 按鈕，會出現 VBA editor，把上面的程式碼填進去，然後從 VBA editor 的選單裡選 File -> Close and Return to Visio 即可。以後就可以隨時從 Visio 選單的 Tools -> Macros 裡，選擇剛剛編輯的 ExportPageAsPNGandSVG 來用。

但是，官方的 posting bookmarklet 會取代掉目前的網頁，這樣在編輯文章時很麻煩，沒辦法回來參照原文編寫。所以只好下手改改這個 posting bookmarklet。基本上關鍵在這裡 (其中，Q 是目前被選取的文字，如果有的話)：

location.href
	= 'http://www.jeffhung.idv.tw/blog/wp-admin/post.php?text='
	+ encodeURIComponent(Q)
	+ '&popupurl='
	+ encodeURIComponent(location.href)
	+ '&popuptitle='
	+ encodeURIComponent(document.title);

因為是更改 location.href 來啟動 blog 編輯，所以目前頁面會被替換掉，換成 window.open() 開新視窗，應該就可以了。所以我把這段改成這樣：

window.open(
	'http://www.jeffhung.idv.tw/blog/wp-admin/post.php?text='
	+ encodeURIComponent(Q)
	+ '&popupurl='
	+ encodeURIComponent(location.href)
	+ '&popuptitle='
	+ encodeURIComponent(document.title)
);

卻沒想到，雖然新的 blog 編輯視窗有正確出現了，但原來的頁面卻被切換成這樣：

[object Window]

研究了網路上其他的 bookmarklet 的寫法，才恍然大悟，如果 bookmarklet 的最後一個 statement 有「值」的話，browser (firefox) 就會把這個值顯示在頁面上。所以在最後加一個 void(null); 就可以了。最後的 wordpress posting bookmarklet 完整如下：

javascript:
if (navigator.userAgent.indexOf('Safari') >= 0) {
	Q = getSelection();
}
else {
	Q = document.selection
	  ? document.selection.createRange().text
	  : document.getSelection();
}
window.open(
	'http://www.jeffhung.idv.tw/blog/wp-admin/post.php?text='
	+ encodeURIComponent(Q)
	+ '&popupurl='
	+ encodeURIComponent(location.href)
	+ '&popuptitle='
	+ encodeURIComponent(document.title)
);
void(null);

縮成一行後如下 (為顯示美觀，以略做折行，請自行連接成一行)，把裡面的 blog 網址改一改，複製製成 bookmark 即可使用：

javascript:if(navigator.userAgent.indexOf('Safari')>=0){Q=g
etSelection();}else{Q=document.selection?document.selection
.createRange().text:document.getSelection();}window.open('h
ttp://www.jeffhung.idv.tw/blog/wp-admin/post.php?text='+enc
odeURIComponent(Q)+'&popupurl='+encodeURIComponent(location
.href)+'&popuptitle='+encodeURIComponent(document.title));v
oid(null);

不過，最後還是有個缺陷，似乎是 Tab Mix Plus 的關係，跳出來的新視窗不會取得焦點 (focus)，所以得手動切換把 blog 編輯視窗找回來才行。

#define WIDEN_(x) L##x
#define WIDEN(x)  WIDEN_(x)
#define __WFILE__ WIDEN(__FILE__)

這樣子我們就可以依據 output 的環境，選擇 __FILE__ 或 __WFILE__ 來使用了：

void fout(ostream& os)
{
    os << __FILE__ << endl;
}

void wfout(wostream& os)
{
    os << __WFILE__ << endl;
}

int main()
{
    fout(cout);
    wfout(wcout);
    return 0;
}

可是，如果是在 template class/function 裡面呢？Character/string 的真實型別，由 template parameter 決定，我們根本無從選擇該用 __FILE__ 還是 __WFILE__ 怎麼辦？這時候，如果有個 generic 版本的 __TFILE__，能夠自動選擇要用 __FILE__ 還是 __WFILE__ 的話，那該有多好？可惜 pre-processor 不支援 template resolution，無法做到 generic。

#define __TFILE__(char_type) \
        ((sizeof(char_type) == sizeof(char)) ? __FILE__ : __WFILE__)

如上列程式使用 conditional operator 將 __FILE__ 與 __WFILE__ 的選擇，留待 compile-time 再來解決，是不可行的。原本的想法是，(sizeof(char_type) == sizeof(char))__FILE__ 與 __WFILE__ 的型別不同 (分別為 const char* 與 const wchar_t*)，所以這樣子使用 conditional operator 是非法的。 山不轉路轉，「把 __FILE__ 與 __WFILE__ 的選擇，留待 compile-time 再來解決」的基本想法應該是對的，既然 conditional operator 不能用，那用 template specialization 如何？如下列程式：

是個 constant expression，所以 compiler 可以 optimize 選擇正確的版本。但因為 C++ standard 5.16.5 說，當 conditional operator 的第二個及第三個 operands 為 r-value 時，兩者的 type 必須匹配，除非可藉由 overload resolution 解決歧義。因為

#include <functional>

template <class CharT>
struct tfile_sel
    : public ::std::binary_function<const char*, const wchar_t*,
                                    const CharT*>
{
    const CharT* operator () (const char* f, const wchar_t* wf)
    {
        return 0;
    }
};

template <>
inline
const char* tfile_sel<char>::operator () (const char* f,
                                          const wchar_t* wf)
{
    return f;
}

template <>
inline
const wchar_t* tfile_sel<wchar_t>::operator () (const char* f,
                                                const wchar_t* wf)
{
    return wf;
}

#define __TFILE__(char_type) tfile_sel<char_type>()(__FILE__, __WFILE__)

利用 template specialization 選擇 __FILE__ 或 __WFILE__，然後因為 template specialization 以及 inline 的關係，最後的 run-time overhead 理論上也應該要蠻小的。就算有，也不大，反正大多在 debug mode 裡用，可以省略這一點點的 overhead。如此，完成的 __TFILE__ 可以這麼樣子用：

using namespace ::std;

template <class CharT>
void tfout(basic_ostream<CharT>& os)
{
    os << __TFILE__(CharT) << endl;
}

int main()
{
    tfout(cout);
    tfout(wcout);
    return 0;
}

總整理上面的 code，含測試程式如下：

#include <iostream>
#include <string>
#include <functional>

#define WIDEN_(x) L##x
#define WIDEN(x)  WIDEN_(x)
#define __WFILE__ WIDEN(__FILE__)

using namespace ::std;

template <class CharT>
struct tfile_sel
    : public ::std::binary_function<const char*, const wchar_t*,
                                    const CharT*>
{
    const CharT* operator () (const char* f, const wchar_t* wf)
    {
        return 0;
    }
};

template <>
inline
const char*
tfile_sel<char>::operator () (const char* f, const wchar_t* wf)
{
    return f;
}

template <>
inline
const wchar_t*
tfile_sel<wchar_t>::operator () (const char* f, const wchar_t* wf)
{
    return wf;
}

#define __TFILE__(char_type) tfile_sel<char_type>()(__FILE__, __WFILE__)

template <class CharT>
void tfout(basic_ostream<CharT>& os)
{
    os << __TFILE__(CharT) << endl;
}

int main()
{
    tfout(cout);
    tfout(wcout);
    return 0;
}

以上技巧有待統整的地方很多，好比 WIDEN() 可以提出來變成一個獨立的模組以便再利用 (reuse)。另外，雙底線開頭的識別字，在 C/C++ 裡是保留給 standard 與 compiler vendor 用的，所以最好另外換個名字。最後，應該也可以參考 Boost 的 preprocessor library，也許可以有其他不一樣的作法也說不定。

由於平常工作時，網路是設定在部門獨立使用的 ADSL 這邊，必須透過 terminal service 連到 server 開 Outlook 才能看信。如果信件裡有夾檔，就很難傳回本機電腦，必須要到外面找台 server，用 command-line FTP 先傳上去，再從本機抓回來，非常麻煩。現在有了這個 TSDropCopy，收夾檔從此就不再是個問題了。

1. 設條件寫作法 (Contingency)：沒有做 XXX 之前 (XXX 是和寫作看書有關)，不可以做 YYY (就是喜歡做的事)；
2. 改變環境：要把會分心的東西拿掉；
3. 設定目標無法達成的懲罰：寫一張支票給你最討厭的機構，如果沒有照達成計畫的目標，保管那張支票的人就可以把它寄出去。

所以，，就此規定，在我沒有寫好程式以前，不能上網。 可是，寫程式需要上網找資料啊！><

# Search Plug-in for FreeBSD man-page search

<search
  version = "1.0"
  name="FreeBSD Man"
  description="FreeBSD Hypertext Man Pages"
  method="GET"
  action="http://www.freebsd.org/cgi/man.cgi"
>

<input name="query" user>

</search>

<browser
  update="http://www.jeffhung.net/~jeffhung/firefox/search-plugin/freebsd-man.src"
  updateIcon="http://www.jeffhung.net/~jeffhung/firefox/search-plugin/freebsd-man.png"
  updateCheckDays="7"
>

不過還好，想通了話其實就很簡單：用 iconv 試轉不就得了：

SHELL> find . -type f -name '*.xml' \
       | xargs -n 1 -t -x iconv -f UTF-8 -t CP950 \
       > /dev/null 2> conv.log

這裡需注意的是，必須要用 sh 或 bash 跑這個指令，因為 csh/tcsh 不能夠把 stdout 與 stderr 分開 redirect。又，CP950 是 Windows 中文版用的 charset，是 BIG5 的其中一個變種。

然後用 grep 把有問題的檔案過濾出來：

SHELL> cat conv.log | grep 'cannot convert'
iconv: ./Sogi0300.xml: cannot convert
iconv: ./Sogi0420.xml: cannot convert
iconv: ./Sogi0869.xml: cannot convert
iconv: ./Sogi1068.xml: cannot convert
iconv: ./Sogi1275.xml: cannot convert

再一個一個重跑 iconv 找出問題點即可：

SHELL> iconv -f UTF-8 -t CP950 ./Sogi0300.xml
<?xml version="1.0" ?>
<sogi-spec id="Sogi0300" name="Alcatel OT512" imgsrc="Sogi0300.jpg">
        <category name="螢幕">
                <property name="螢幕背光燈" value="藍白背光加強型顯示幕" />
                <property name="螢幕" value=":可使用縮放效果, 最多6行文字, 最少4行文字" />
                <property name="主螢幕解析度" value="96 * 65  pixels" />
                <property name="螢幕娛樂" value="開機動畫, 關機動畫, 遊戲, 待機圖案" />
        </category>
        <category name="機身外觀">
                <property name="尺寸" value="97 * 42 * 20  mm" />
iconv: SogiDB-v0.4-r190-20050509-163814/Sogi0300.xml: cannot convert
                <property name="機身顏色" value="浮世金、雅仕銀，螢幕的外框和液晶改Exit 1

噹噹！錯誤發生在「改」字的後面。

更新 2005-11-04：我這篇《List non utf-8 encoded files》講的是一樣的事情。