バッファ

*buffer-bar-context-menu*

バッファ・バー上で右クリックしたときに出てくるコンテキストメニューです。
define-popup-menu で作成されています。（作成は app-menu.l）

*buffer-bar-context-menu-buffer*

バッファ・バー上で選択されているバッファです。ただし、バッファ・バー上の
コンテキストメニューで取得専用くらいしか使用できません。

*buffer-bar-context-menu-handler*

デフォルトのバッファ・バー用コンテキストメニューハンドラです。
setq-default によって定義されている標準の動作は、 
*buffer-bar-context-menu-buffer* を定義し、*buffer-bar-context-menu* を
返します。

*buffer-bar-selected-buffer-to-first*

non-nil なら、選択されたバッファがバッファバー上で一番先頭になります。
キーでタブを移動した場合は移動されません。デフォルトは nil です。
(setq *buffer-bar-selected-buffer-to-first* t) とやって、バッファバーを
クリックすれば分かると思います。

*dabbrevs-no-undo*

dabbrev-expand時のundoの方法を設定します。
dabbrev-expandを行なった際に候補が順次挿入されますが...
  non-nil  dabbrev-expandの直前まで一気に取り消す
  nil      途中の挿入過程を順番に取り消す

*default-buffer-mode*

新しくバッファを作成した場合のモードを指定します。
例えば、lisp-modeを指定しておけば、新しく作成したバッファは全てlisp-mode
になります。

使用例：  
  (setq *default-buffer-mode* 'lisp-mode)
  => lisp-mode
  (switch-to-buffer "*new*")
  => #<buffer: *new*>
  buffer-mode
  => lisp-mode

*move-forward-after-undo-deletion*

削除をundoした場合のカーソルの位置を制御します。
  non-nil  削除範囲の最後尾
  nil      削除範囲の先頭

*next-buffer-in-tab-order*

next-bufferで次に移動するバッファを、タブでの順番どおりにするか否かを設
定します。もちろんprevious-bufferにも影響します。
  t    バッファバーでの次のバッファに移動する。
  nil  どうなるでしょうか？

*show-cursor-line-always*

カレントでないウィンドウでもカーソルラインを表示します。

使用例：
  (setq *show-cursor-line-always* t)

*show-matched-parenthesis*

対応する括弧の表示を制御します。括弧に使用する文字は
set-syntax-matchで指定します。
  non-nil  対応する括弧を表示する
  nil      対応する括弧を表示しない

backward-sexp

lisp-modeでS式を1つ戻します。

使用例：
  (backward-sexp)

buffer-can-redo-p

バッファがredo可能な状態ならt、そうでなければnilを返します。

buffer-can-undo-p

bufferがundo可能ならt、そうでなければnilを返します。

buffer-fileio-encoding

バッファの漢字コードを返します。変更する場合には、
set-buffer-fileio-encodingを使用します。

使用例：
  (buffer-fileio-encoding)
  => #.(make-iso2022-encoding "jis" ... )

参照：
  kanji.l

buffer-lines

バッファの物理行数を返します。

使用例：  
  (buffer-lines)
  => 5014

buffer-list

全バッファをリストで返します。

使用例:
  (buffer-list)
  =>(#<buffer:  *Minibuf0*> #<buffer: *grep*> #<buffer: *scratch*> #<buffer: *untitled*> #<buffer: addref.xml> #<buffer: reference.xml>)
  
  (buffer-list :buffer-bar-order t)
  =>(#<buffer: *scratch*> #<buffer: reference.xml> #<buffer: *untitled*> #<buffer: addref.xml> #<buffer: *grep*> #<buffer:  *Minibuf0*>)
  
  ;;ミニバッファの名前はスペースで始まる点に注意
  (mapcar #'buffer-name (buffer-list))
  =>(" *Minibuf0*" "*grep*" "*scratch*" "*untitled*" "addref.xml" "reference.xml")

buffer-local-value

指定されたバッファのローカル変数の値を返します。

  BUFFER : ローカルな値を取得したいバッファ
  SYMBOL : ローカル変数

使用例：
  (buffer-local-value (selected-buffer) 'mode-name)
  => "xmldoc"

buffer-menu

バッファ一覧を表示します。
一覧の中ではバッファの選択、削除などができます。

buffer-mode

カレントバッファのモードを格納しています。

使用例：
  ;;; list-interaction-modeの場合
  buffer-mode
  => lisp-interaction-mode

buffer-modified-count

（バッファが修正されたカウント数？）

buffer-modified-p

バッファ BUFFER が変更を加えられているかどうかを返します。
バッファが変更されていない時は nil を、変更されている時はバッファの編集
回数(buffer-modified-count の値)を返します。
BUFFER が指定されない、もしくは nil が指定された時はカレントバッファの結
果を返します。

buffer-name

バッファの名前を返します。

  BUFFER : 名前を返すバッファを指定します。

使用例：
  ;;; カレントバッファの名前を返します。
  (buffer-name (selected-buffer))
  => "reference.xml"

buffer-process

バッファに結び付けられているプロセスを返します。
プロセスはmake-processで作成します。

buffer-selector

バッファ選択ウィンドウを表示します。
バッファ選択されればそのバッファを、そうでなければnilを返します。

buffer-size

バッファのサイズを返します。2バイト文字があるので buffer-size の返す値と
ファイルサイズは一致しません。

使用例：
  (buffer-size)
  => 200170

bufferp

OBJECTがバッファならばt、そうでないならnilを返します。

bury-buffer

（詳細不明）
--- muleの説明 ---
この関数は、リスト上の他のバッファの順を変更することなく、バッファリスト
の終りに buffer-name を置きます。それは、other-buffer が(最も)返さないバ
ッファになります。 buffer-name が与えられない場合、デフォルトはカレント
バッファになります。 

buffer-name がカレントバッファの場合、それが selected ウィンドウで表示さ
れている場合、 other-buffer で選択されるバッファで置き換えます。 selected 
ウィンドウ以外のウィンドウで表示されている場合、それはそのままにします。 

インタラクティブに呼ばれた場合、 buffer-name はデフォルトでカレントバッ
ファになります。

clear-undo-boundary

UNDO情報から直近の境界を削除します。

使用例：
  (defun self-insert-space (&optional (arg 1))
    (interactive "*")
    (when (eq *last-command* 'self-insert-space)
      (clear-undo-boundary))
    (self-insert-command arg))
  (define-key ed::*lisp-mode-map* #\SPC 'self-insert-space)

count-buffers

全バッファの数を返します。

  ALL : " *Completion*"や" *Minibuf0*"等の先頭が空白のバッファも数えるか？
        t       先頭が空白のバッファも数える。
        nil     先頭が空白のバッファは数えない。

使用例：
  ;;; バッファの数を数えてみる。
  (count-buffers)
  => 20
  (count-buffers t)
  => 23

create-file-buffer

ファイルを参照するバッファを作成して返します。

create-new-buffer

名前がNAMEのバッファを作成して返します。もしその名前のバッファが存在すれ
ば、name<1>, name<2>...と番号を付けた名前になります。

使用例：
  (create-new-buffer "test")
  => #<buffer: test>
  (create-new-buffer "test")
  => #<buffer: test<2>>

delete-buffer

バッファを削除しますが、kill-bufferと違い対話的に削除するかどうかは聞き
ません。kill-bufferも内部的にはdelete-bufferを使っています。

delete-bufferでは以下の二つのフックが順番に実行されます。

  *before-delete-buffer-hook*
        delete-bufferを継続するかどうかを制御します。登録された関数が一
        つでもnilを返すとdelete-bufferを中止します。

  *delete-buffer-hook*
        delete-bufferされるバッファで何か処理を行う場合に使用します。

deleted-buffer-p

バッファが削除されているかどうかを調べます。
BUFFERにはバッファ型のものしか指定できません。

  t   指定されたバッファは既に削除されています。
  nil 指定されたバッファは未だ削除されていません。

enum-buffers

関数がnil以外を返すまでバッファを列挙し続けます。

使用例：
  ;;; バッファを列挙し続ける。
  (enum-buffers #'(lambda (x) (and (yes-or-no-p "~S" x) x)))
  => #<buffer:  *Completion*>

erase-buffer

バッファの内容を削除します。
以下の内容がクリアされます。
  ・バッファ上のテキスト
  ・変更フラグ
  ・修正日付
  ・restriction
  ・UNDO情報

fast-scroll-down

高速に下スクロールします。[C-Up]

fast-scroll-up

高速に上スクロールします。[C-Down]

find-buffer

名前がBUFFER-NAMEなバッファが存在すればそのバッファを返します。
存在しなければnilを返します。

使用例：
  (find-buffer "*scratch*")
  => #<buffer: *scratch*>
  (find-buffer "*hoge hoge*")
  => nil

find-name-buffer

名前がBUFFER-NAMEもしくはBUFFER-NAME<数字>なバッファのリストを返します。
存在しなければnilを返します。

使用例：
  (find-name-buffer " *TAGS*")
  => (#<buffer:  *TAGS*<2>> #<buffer:  *TAGS*>)
  (find-name-buffer "*hoge hoge*")
  => nil

forward-sexp

lisp-modeでS式を1つ進めます。

使用例：
  (forward-sexp)

get-buffer-alternate-file-name

バッファBUFFERに設定されたファイル名の別名を取得します。

get-buffer-create

指定した名前のバッファを返します。名前を指定しますが、同じ名前のバッファ
が既にあればそれを返します。無ければcreate-new-bufferで新しく作ります。

switch-to-bufferも良く似た動きをしますが、switch-to-bufferは
get-buffer-createを用いて実装されています。

  NAME : バッファの名前

使用例：
  ;;; *calc*がなければ作成する。
  (get-buffer-create "*calc*")
  => #<buffer: *calc*>

get-buffer-file-name

バッファが参照しているファイルのフルパスを返します。
ファイルを参照していなければnilを返します。

  BUFFER : ファイルのフルパスを返すバッファを指定します。

使用例：
  ;;; カレントバッファのファイルのフルパスを返します。
  (get-buffer-file-name)
  => "C:/xyzzy/site-lisp/xmldoc/reference.xml"

get-file-buffer

ファイルを表示しているバッファを返します。
なければnilを返します。

使用例：  
  (get-file-buffer "not-documented.xml")
  => #<buffer: not-documented.xml>

get-selection-type

バッファの選択状態を返します。

  nil   選択なし、
  1     行モード選択状態
  2     文字モード選択状態
  3     矩形選択状態

goto-last-modified-line

現在のバッファで最近変更された行の先頭に移動します。

insert-buffer

指定されたバッファの内容を現在のバッファに挿入します。

insert-buffer-substring

指定されたバッファの内容を現在のバッファに挿入します。
リージョンが指定されていればその領域を挿入します。

insert-file-contents

ファイルの内容をカーソル位置に挿入します。

  FILENAME : 挿入するファイル名
  VISIT-P  : ファイルを挿入後の動作を指定します。
        t       変更フラグ・UNDO情報のクリア、ファイルの日付の変更等を行います。
        nil     特に何もしません。
  OFFSET   : 挿入するオフセット
  SIZE     : 挿入する長さ

使用例：
  ;;; 簡単なテンプレートの挿入例
  ;;; site-lisp/template.lを用意しておくこと
  (defun insert-template ()
    (and (get-buffer-file-name)
         (not (file-exist-p (get-buffer-file-name)))
         (insert-file-contents (merge-pathnames "site-lisp/template.l" (si:system-root)) t)
         (message "template inserted")))
  => insert-template
  (add-hook '*lisp-mode-hook* 'insert-template)
  => (insert-template lisp-load-keyword-file)

kept-undo-information

undo 可能回数を指定する変数です。

  <integer> : 指定回数分の undo 情報を保持します。
  上記以外  : undo 情報を保持しません。(undo できません。)

使用例：
  ;;; 現在開いているファイルではundoできないようにします。
  (make-local-variable 'kept-undo-information)
  => t
  (setq kept-undo-information nil)
  => nil

kill-all-buffers

全バッファをkill-bufferします。
NOT-VERBOSEで保存するか否かを指定できます。

  NOT-VERBOSE :
        t       何も確認せずに保存しようとします。
        nil     変更があるバッファは確認のダイアログ表示されます。

kill-all-local-variables

全てのローカル変数が現在のバッファで独自の値を持てないようにします。
setq-defaultされていなかったローカル変数は参照できなくなります。

使用例：
  ;;; defvar-localした変数の値を設定してからkillしてみる。
  (defvar-local abc 123)        => abc
  (setq abc 456)                => 456
  abc                           => 456
  (kill-all-local-variables)    => t
  abc                           => 123

kill-buffer

バッファを削除します。ただし、kill-bufferはバッファが変更されていると削
除していいかどうか聞いてきます。マクロ中で使う際には、delete-bufferを使
ったほうがいいでしょう。(ユーザに聞かずにいきなり削除します）

また、*query-kill-buffer-hook*にフック関数を設定すると、独自の用件でバッ
ファの破棄を確認できます。

使用例：
  ;;; 現在のバッファを削除する。
  (kill-buffer (selected-buffer))
  => t

kill-local-variable

SYMBOLが現在のバッファで独自の値を持てない様にします。
kill-local-variableを実行した後では、SYMBOLの値はグローバルなSYMBOLの値
になります。setq-defaultされていなかったローカル変数は参照できなくなります。

使用例：
  ;;; defvar-localした変数の値を設定してからkillしてみる。
  (defvar-local abc 123)        => abc
  (setq abc 456)                => 456
  abc                           => 456
  (kill-local-variable 'abc)    => t
  abc                           => 123

kill-selected-buffer

名前のとおりselected-bufferをkill-bufferします。

参考：
  ;;; buffer.l
  (defun kill-selected-buffer ()
    (interactive)
    (kill-buffer (selected-buffer)))

lock-file

ロックファイルを作るかどうかを指定する変数です。

  t   : ロックファイルを作る。
  nil : ロックファイルを作らない。

使用例：
  ;;; 現在開いているファイルではロックファイルを作らないようにする。
  (make-local-variable 'lock-file)
  => t
  (setq lock-file nil)
  => nil

make-backup-files

バックアップファイルを作るかどうかを指定する変数です。

  t   : バックアップファイルを作る
  nil : バックアップファイルを作らない

使用例：
  ;;; 現在開いているファイルをバックアップとらないようにする。
  (make-local-variable 'make-backup-files)
  => t
  (setq make-backup-files nil)
  => nil

make-local-variable

SYMBOLを現在のバッファで独自の値を持てるようにローカル変数にします。
make-variable-buffer-localとは異なり、現在のバッファだけです。

使用例：
  ;;; 現在のバッファは自動保存しないようにする。
  (make-local-variable 'auto-save)
  => t  
  (setq auto-save nil)
  => nil

make-variable-buffer-local

SYMBOLを個々のバッファで独自の値を持てるようにローカル変数にします。
make-local-variableとは異なり、全てのバッファが対象です。
余程のことが無い限りdefvar-localを使えば良いと思います。

need-buffer-save-p

バッファが保存が必要かを返します。
need-not-saveと関連しています。

  t     バッファの保存が必要
  nil   バッファの保存が必要ではない

next-buffer

次のバッファに切替えます。エディタ上で現在選択されているウィンドウの
中のバッファが変わるだけです。

バッファタブの順番にそってnext-bufferしたいのならば、
*next-buffer-in-tab-order*を参照して下さい。

not-modified

バッファの変更フラグをクリアします。
つまり変更されてないことになります。
(set-buffer-modified-p nil)のinteractive版です。

other-buffer

最近(?)表示されていたバッファに切替えます。

previous-buffer

一つ前のバッファに切替えます。next-bufferの反対です。

print-buffer

バッファを印刷します。

redo

元に戻した処理を再度実行します。[C-_],[S-End],[F12]

buffer-can-redo-p が t の時のみ実行可能です。

rename

バッファに関連づけられたファイル名を変更します。バッファ名も同時に変更されます。
変更に成功したらnil以外の値を、失敗したらnilを返します。

使用例：
  ;;; カレントバッファのファイル名が"c:/foo.baz"に変更されます。
  ;;; 同時に、バッファ名も"foo.baz"になります。
  (rename "c:/foo.baz")

rename-buffer

ファイル名は変えずにバッファ名だけを変更します。

--- muleの説明 ---
この関数は、カレントバッファを buffer-name にリネームします。 

buffer-name がストリングでなかったりその名前のバッファがすでに存在している場
合、エラーになります。 nil を返します。

select-buffer

バッファを選択するダイアログを表示します。
デフォルトではC-p/C-nで上下し、C-mで選択します。
buffer-menuのようなバッファの削除などはできません。
※正確には*std-control-xxx-char*の設定に依ります。

selected-buffer

現在操作中のバッファ（カレントバッファ）を返します。

使用例：
  (selected-buffer)
  => #<buffer: reference.xml>

互換性：
  この関数はmuleにはありません。
  muleでのcurrent-bufferに相当します。

set-buffer

バッファを選択します。

--- muleの説明 ---
この関数は、 buffer をカレントバッファにしますが、このバッファを今 
select されているウィンドウに表示することはしません。これは(Emacs が)コ
マンドレベルに戻ると(すぐに) select されているウィンドウのバッファが(再
び)カレントになることを意味しています。 

この関数は、(カレントバッファ以外のバッファでエディットを行なう)コマンド
を書く際に用いられます。 buffer で示されるバッファを返します。 

buffer が(既存の)バッファを指さない場合、エラーになります。

set-buffer-alternate-file-name

バッファBUFFERにファイル名の別名NAMEをつけます。set-buffer-file-nameでは、
ありえないパスを指定するとエラーになります。
set-buffer-alternate-file-nameではどのような文字列でも指定可能です。

使用例：
  ; c:/abc/は存在しないパス
  (set-buffer-file-name "c:/abc/def.txt")
  => c:/abc/def.txt
     指定されたパスが見つかりません。 

  ; URLでもなんでも任意の文字列を設定可
  (set-buffer-alternate-file-name "http://www.asahi.com")
  => t

指定した文字列は、バッファのファイル名がnilの場合（つまり、
get-buffer-file-nameの戻り値がnilの場合）に限り、
以下の個所で使用されます

  1)select-bufferで表示されるダイアログのファイル名
  2)mode-line-format/title-bar-formatのファイル名

set-buffer-colors

バッファの色を設定します。設定した色は現状のバッファにだけ適用されます。

  COLORS : BGRを表す数値をベクタで指定します。

set-buffer-file-name

バッファと結び付けられているファイルをFILE-NAMEにします。

set-buffer-fileio-encoding

バッファの漢字コードをCODEにします。設定した漢字コードは
buffer-fileio-encodingで参照することができます。

  CODE   : 漢字コードを指定します。
  BUFFER : 変更するバッファを指定します。

使用例：
  (set-buffer-fileio-encoding *encoding-sjis*)
  (set-buffer-fileio-encoding *encoding-euc-jp*)
  (set-buffer-fileio-encoding *encoding-jis*)
  (set-buffer-fileio-encoding *encoding-utf8*)

参照：
  kanji.l

set-buffer-fold-type-column

カレントバッファを指定位置で折り返しします。

set-buffer-fold-type-column-update

カレントバッファが指定位置で折り返しになっているかどうかを返します。

戻り値は以下のとおりです。
  :check  なっている
  nil     なっていない

set-buffer-fold-type-none

カレントバッファを折り返しなしにします。

set-buffer-fold-type-none-update

カレントバッファが折り返し無しになっているかどうかを返します。

戻り値は以下のとおりです。
  :check  なっている
  nil     なっていない

set-buffer-fold-type-window

カレントバッファをウィンドウ幅で折り返します。

set-buffer-fold-type-window-update

カレントバッファがウィンドウ幅で折り返しになっているかどうかを返します。

戻り値は以下のとおりです。
  :check  なっている
  nil     なっていない

set-buffer-modified-p

バッファが変更されたかどうかのフラグを設定します。

  FLAG   : フラグを指定します。
        t       変更されている状態にします。
        nil     変更が存在しない状態にします。
  BUFFER : 対象のバッファ

使用例： 
  ;;; 変更フラグの設定・クリア
  (set-buffer-modified-p t)
  (set-buffer-modified-p nil)

setup-temp-buffer

BUFFER を一時バッファ用に初期化します。
具体的には以下のようにバッファローカル変数を設定します。

  buffer-read-only      -> nil
  need-not-save         -> t
  kept-undo-information -> nil
  auto-save             -> nil

switch-to-buffer

指定されたバッファに移動し、ウィンドウに移動します。バッファが存在しなけ
ればバッファを作成します。そのバッファを操作中のウィンドウに表示するとこ
ろ以外は、get-buffer-createのinteractive版と言えます。

使用例：
  ;;; *calc*があろうとなかろうと*calc*に移動する。
  (switch-to-buffer "*calc*")
  => #<buffer: *calc*>

switch-to-buffer-other-window

他のウィンドウに移ってからバッファを切り替えます。
ウィンドウ数が1の時は、ウィンドウを分割します。

  BUFFER : このバッファにカレントウィンドウを切り替えます。
  NOWARN : non-nilならば、指定したバッファが他のアプリケーションにより更
           新されているかのチェックを行いません。

toggle-read-only

バッファの書き込み禁止をトグルします。

undo

直前の操作を取り消します。
UNDO情報の直近の境界まで戻ります。

undo-boundary

UNDO情報に境界を設定します。
以後undoを実行すると、この境界まで戻ります。

verify-visited-file-modtime

バッファがファイルに関連付けられていない、もしくはバッファとそれに関連付
けられたファイルとの更新時間が一致していると t を返します。バッファとそ
れに関連付けられたファイルとの更新時間が一致していない時、つまり他のプロ
セスによってファイルが変更された時などに nil を返します。

activate 時のバッファの最終更新日チェックを制御します。
  :auto    更新されていれば自動的に読み直す
  non-nil  チェックする
  nil      チェックしない

window-buffer

ウィンドウが表示しているバッファを返します。
  
使用例：
  (window-buffer (selected-window))

with-set-buffer

BODY を実行する際に、ポイントがミニバッファ以外にあることを保証します。
ポイントがミニバッファにあった場合、BODY を実行した後ポイントはミニバッファに戻ります。

ミニバッファで set-buffer するとエラーが起きるので、それを回避するためにあるようです。

使用例:
  ;; lisp/misc.l より
  (defun setup-temp-buffer (buffer)
    (with-set-buffer
      (save-excursion
        (set-buffer buffer)
        (setq buffer-read-only nil)
        (setq need-not-save t)
        (setq kept-undo-information nil)
        (setq auto-save nil))))

バッファの内部構造

各々のバッファは、(プログラマが直接アクセスすることのできない) 変数の集合を
持っています。 (どのような形であれ)それらに与えられた名前をプログラマが用いる
ことはできませんが、それらの値をアクセスし変更を行なう関数がしばしば存在して
います。 (Emacs 18 において)それらは、

  name 
    バッファ名は、バッファを名指すストリングです。これは一意であることが保
    証されています。セクション 24.1 [buffer-name]、ページ 224 参照。

  save-modified 
    この変数は、バッファが(最後に)セーブされた時間を持ちます。xref??

  modtime 
    この変数は、visit されたファイルの modification time を持ちます。これ
    はそのファイルが書かれるか読まれるかした時に設定されます。バッファが
    ファイルに書かれるたびに、この変数は(その) ファイルの modification と
    比較されます。セクション 22.3 [verify-visited-file-modtime]、ページ
    204 参照

  auto-save-modified 
    この変数は、バッファが(最後に)オートセーブされた時間を持ちます。

  last-window-start 
    この変数は、(最後に)バッファがウィンドウに表示された際、その表示を開始
    したバッファ中のポジションを持ちます。

  undodata 
    この変数は、バッファに対し(最後に)行なわれたいくつかの(訳注：set of)変
    更を undo するための方法を、(Emacs に)示す記録を持ちます。セクション
    24.8 [undo]、ページ 233 参照。

  syntax_table_v 
    この変数は、バッファに対するシンタックステーブルを持ちます。セクション
    37.3 [シンタックステーブル]、ページ 354 参照。

  markers 
    この変数は、バッファの中を指す(全ての)マーカーのリストを持ちます。バッ
    ファの内容を変更する際は、これらのマーカーは(常に) アップデートされな
    くてはいけません。チャプター 28 [マーカー]、ページ 267

  backup_up 
    この変数は、 visit されたファイルがバックアップされているか否かを示す
    フラグです。

  mark 
    この変数は、バッファに対するマークを持ちます。マークはマーカーですか
    ら、マークはリスト markers にも含まれます。

  local_var_alist 
    この変数は、ローカル変数(の全て)とそれに対応する値とを含む association
    リストを持ちます。関数 buffer-local-variables は、このリストのコピーを
    返します。

--- 追加分 ---
  mode-line-format 
    モードラインのフォーマットです。

  title-bar-format
    タイトルバーのフォーマットです。