vimはファイル名のところでgfとタイプすると該当のファイルを開く機能があります。

例えば以下のようなソースでjs/jquery.jsの上でgfと押すとカレントファイルからの相対パスを探して、ファイルがあればファイルを開きます。

<script type="text/javascript" src="js/jquery.js"></script>

でもHTML書くときにドキュメントルートからの絶対パスで書くときもあるわけで、そのときはどのディレクトリがドキュメントルートになるかvimはわからないので開くことができません。

そこで以下の様な関数を定義して、ドキュメントルートをあらかじめ指定しておくことで絶対パスのファイルでも開けるようにしました。

カレントファイルのディレクトリを見て設定したディレクトリと合っているところから探すので複数ドキュメントルートを設定できるようにしてます。それと絶対パスじゃなかったら相対パスを探すので絶対パスと相対パスでコマンドを使い分ける必要もないです。