10.11. "dircache" --- キャッシュされたディレクトリ一覧の生成
************************************************************

バージョン 2.6 で非推奨: "dircache" モジュールは Python 3 で削除されま
した。

"dircache" モジュールはキャッシュされた情報を使ってディレクトリ一覧を
読み出すための関数を定義しています。キャッシュはディレクトリの *mtime*
に応じて無効化されます。さらに、一覧中のディレクトリにスラッシュ ('/')
を追加することでディレクトリであると分かるようにするための関数も定義し
ています。

"dircache" モジュールは以下の関数を定義しています:

dircache.reset()

   ディレクトリキャッシュをリセットします。

dircache.listdir(path)

   "os.listdir()" によって得た *path* のディレクトリ一覧を返します。
   *path* を変えない限り、以降の "listdir()" を呼び出してもディレクト
   リ構造を読み込みなおすことはしないので注意してください。

   返されるリストは読み出し専用であると見なされるので注意してください
   (おそらく将来のバージョンではタプルを返すように変更されるはず ? で
   す)。

dircache.opendir(path)

   "listdir()" と同じです。以前のバージョンとの互換性のために定義され
   ています。

dircache.annotate(head, list)

   *list* を *head* の相対パスからなるリストとして、各パスがディレクト
   リを指す場合には "'/'" をパス名の後ろに追加したものに置き換えます。

   >>> import dircache
   >>> a = dircache.listdir('/')
   >>> a = a[:] # Copy the return value so we can change 'a'
   >>> a
   ['bin', 'boot', 'cdrom', 'dev', 'etc', 'floppy', 'home', 'initrd', 'lib', 'lost+
   found', 'mnt', 'proc', 'root', 'sbin', 'tmp', 'usr', 'var', 'vmlinuz']
   >>> dircache.annotate('/', a)
   >>> a
   ['bin/', 'boot/', 'cdrom/', 'dev/', 'etc/', 'floppy/', 'home/', 'initrd/', 'lib/
   ', 'lost+found/', 'mnt/', 'proc/', 'root/', 'sbin/', 'tmp/', 'usr/', 'var/', 'vm
   linuz']
