ポジション

*page-scroll-keep-window-position*

next-page実行時にバッファの最後がウィンドウ内にある場合、バッフ
ァの最後に移動します。previous-pageも同様です。 

  t   移動しません
  nil 移動します 

*smart-indentation*

インデント処理の前後で全く変更する必要が無かった場合の制御を設定します。 

  nil      位置が同じでも従来通り常に変更する
  t        位置が違う場合のみ変更する（タブとスペースの組み合わせは気にする） 
  上記以外 位置が違う場合のみ変更する（タブとスペースの組み合わせは気にしない） 

back-to-indentation

カーソルをインデントの末尾（行の最初の空白でない文字）へ移動します。 

backward-char

指定された文字数だけ後方に移動します。行頭ならば前行の終端に位置します。 

互換性： 
   Emacsではバッファの先頭ではエラーが発生します。xyzzyではエラーは発生 
  しません。その代わり、動けたときは t、動けなければ nil を返します。 

backward-paragraph

カーソルを段落の先頭に移動します。 

backward-word

カーソルを後方の単語に移動します。 

beginning-of-buffer

カーソルをバッファの先頭に移動します。[ESC <]
元あったカーソル位置にはマークを設定します。 

マークを変更しないためには
(goto-char (point-min))を使います。 

beginning-of-line

行頭に移動します。goto-bolのinteractive版です。 

bobp

ポイントがバッファの先頭にあるか否かを返します。 
  t    ポイントがバッファの先頭にある。 
  nil  ポイントがバッファの先頭にはない。 

bolp

カーソルが行頭にあればt、そうでなければnilを返します。 

count-column

文字列 STRING を出力した場合の出力後の桁位置を返します。 
START と BUFFER はタブ文字の幅の計算に影響を与えます。 

  STRING : 対象文字列
  START  : 出力開始とする桁位置
        nil      桁位置 0 からの出力 
        INTEGER  桁位置 INTEGER からの出力 (0 未満の場合 range-error)
  BUFFER : 出力バッファ
        nil      タブ幅として (tab-column) の値を用います。 
                 (tab-column (selected-buffer)) の値ではありません。 
        BUFFER   タブ幅として (tab-column BUFFER) の値を用います。 

戻り値： 
  INTEGER   文字列 STRING 出力後の桁位置

補足： 
  改行文字 "\n" は桁位置の初期化としては働かず、幅 2 として扱われます。 

current-column

現在の桁位置を返します。 

current-line-columns

現在の表示行の桁数を返します。 
改行文字 (#\LFD) は 2 桁と扱われます。 

current-line-number

現在の物理行の行番号を返します。 

current-virtual-column

カーソル位置の表示桁を返します。 
※実際の表示が表示行／物理行には依存しません。 
(current-virtual-column)

current-virtual-line-number

現在のポイントが表示行で何行目かを返します。 

delete-marker

マーカーを削除します。 
オブジェクトはマーカーとして使えなくなります。 
成功した場合 t、すでに削除されていた場合は nil を返します。 

使用例： 
  (delete-marker m)
  => t
  m
  => #<deleted-marker 128914348>

down-list

カーソルを前方にある ARG 個内側の括弧の後ろに移します。 

  (setq lst '(a b c)) ; ここから
       ^
  (setq lst '(a b c)) ; ここへ
              ^

前方に括弧が見つからなかった場合、 
NO-ERRORS が nil の場合にはエラーを、 t の場合には nil を返します。 
また、直近にある括弧しか見つけられないようです。 

  (defun test () (setq lst '(a b c))) ; ここから ARG = 2 で down-list すると
     ^                                ; エラーになる 

ed::get-selection-start-end

セレクションの開始位置と終了位置を多値で返します。 
ただし、矩形選択状態ではnilを返します。 

ed::map-selection

セレクションの開始位置と終了位置を引数にして関数を呼び出します。 

  FN : 呼び出す関数を指定します。呼び出し時には開始位置と終了位置を渡し 
       ますので、そのような関数のI/Fにしておかなければなりません。 

使用例： 
  ;;;
  (defun map-test ()
    (interactive)
    (ed::map-selection #'(lambda (start end) (message (format nil "~s ~s" start end)))))

補足： 
  editorパッケージからエクスポートされてないので、ed::をつける必要があります。 
  選択の開始位置と終了位置を正確に渡すので、前後関係に注意して下さい。 

end-of-buffer

カーソルをバッファの末尾に移動します。[ESC >]
元あったカーソル位置にはマークを設定します。 

マークを変更しないためには
(goto-char (point-max))を使います。 

end-of-line

現在行の終りに移動します。 

eobp

ポイントがバッファの最後にあるかどうか調べます。 

使用例： 
  ;;; バッファの最後までカーソルをひとつひとつ進める？ 
  (while (not (eobp))
    (forward-char))

eolp

カーソルが行末にあるかどうか調べます。 

  t     カーソルが行末にある
  nil   カーソルは行末にはない 

fill-column

詰め込み時の折り返しの桁数を保持します。 
既定値は 72 です。 

使用例:
  ;;; 既定値を 62 に変更する。 
  (setq-default fill-column 62)

カレントバッファの値を変更する場合は、Function set-fill-column 
を使用します。 

forward-char

指定された文字数だけ右に移動します。改行があれば次行に移動します。 

この関数は、ポイントを右に ARG 文字動かします(ARG が負の場合、左に動 
かします)。バッファ(もしくは clipped 領域)の先頭や終端を越えてしまう場合、 
beginning-of-buffer か end-of-buffer エラーを出します。 

インタラクティブに呼ばれた場合、 ARG は数値のプレフィックスアーギュメ
ントになります。 

互換性： 
  Emacsではバッファの先頭ではエラーが発生します。xyzzyではエラーは発生し
  ません。その代わり、動けたときは t、動けなければ nil を返します。 

forward-line

次行に移動します。 

--- muleの説明 ---
Command: forward-line &optional count

この関数は、ポイントを今の位置から count 行下の行の先頭に動かします。 
count が負の場合、上に動かします。 

バッファ(もしくは clipped 領域)中に十分な行が存在しない場合、ポイントを
バッファ(もしくは clipped 領域) の先頭(もしくは終端)に動かします。 

count と実際に動いた行数との差を返します。 3 行しかないバッファの頭から 
5 行下に動かすよう指示すると、ポイントをその最後の行の終りに位置付け、2 
を返すことになります。 

インタラクティブに呼ばれた場合、 count は数値のプレフィックスアーギュメ
ントになります。

forward-list

前方のリストの終端へ移動します。 
  
  使用例:
    ;;; forward-list で移動する 
    ;;; 
    ;;; ^ でポイント位置を表す 
    (let ((hoge '(1 2))) (foo hoge) ...)
      ^ 最初はこの位置
    (let ((hoge '(1 2))) (foo hoge) ...)
                        ^ 一回 
    (let ((hoge '(1 2))) (foo hoge) ...)
                              二回 ^

forward-paragraph

カーソルを段落の末尾に移動します。 

forward-virtual-line

表示行で次行へ移動します。 

forward-word

カーソルを前方の単語に移動します。 

goal-column

現在のゴールカラムを取得します。 
[xyzzy:06371] あたりのスレッドを見ると、save-excursionでゴールカラムが保 
存されないのは仕様のようです。 

goto-bol

行頭に移動します。 

互換性： 
  xyzzyオリジナルのようです。 
  効率がいいのでこれを使うのが推奨されているみたい。 

goto-char

指定された位置にカーソルを移動します。この位置はpoint, point-min, 
point-max等のポイントを返す関数を使用することで得ることが可能です。 

--- muleの説明 ---
この関数は、カレントバッファのポイントを(カレントバッファの) position に
設定します。 position が 1 以下の場合、ポイントをバッファの先頭に設定し
ます。バッファの長さ以上の場合、ポイントをバッファの終端に設定します。 

clipping 制限が用いられた場合も、この position は(以前として)そのバッフ 
ァの先頭から計られますが、 clipped 領域の外に示された position は clipped 
領域の先頭か終端の位置となります。 

インタラクティブに呼ばれた場合、(それが与えれている場合) position はプレ
フィックスアーギュメントになり、(与えられてない場合) ミニバッファから読
み込みます。 
goto-char は position を返します。

goto-column

指定された桁位置に移動します。移動した後の桁位置を返します。 
current-line-columnsが返す値よりも大きな値を指定した場合には、行の終端に
位置します。負の数を指定した場合には、行の先頭に位置します。 

  COLUMN : 桁数

goto-eol

行末に移動します。 

互換性： 
  xyzzyオリジナルのようです。 
  効率がいいのでこれを使うのが推奨されているみたい。 

goto-line

指定された行番号にジャンプします。折り返しを有効にしていて表示行にジャン
プしたい場合には、goto-virtual-lineを使用します。 

この関数は、(バッファの先頭を 1 行目と数え) line 行目の行の先頭にポイン
トを設定します。 line が 1 より小さい場合、ポイントをバッファの先頭に置
きます。バッファ中の行数より大きい場合、バッファ最後の行の終りに設定しま
す。 

clipping 制限が用いられた場合、 line は(まだ)そのバッファの先頭から数え 
ますが、clipped 領域の外に line が指定されると、ポイントは clipped 領域
の先頭か終りに位置付けられることになります。 

インタラクティブに呼ばれた場合、(与えられている場合) line は数値のプレフ 
ィックスアーギュメントになります。そうでない場合、 line をミニバッファか 
ら読み込みます。

goto-marker

マーカーのポジションへポイントを移動します。 
goto-char と違い、ポイント（数字）を引数として受け取ることはできません。 

goto-matched-parenthesis

ポイントに存在するキャラクタが、syntax-open-pもしくはsyntax-close-pを満
たす場合に、対応するキャラクタに移動します。対応する各種括弧に移動するの
に使われます。 

goto-virtual-bol

表示行の行頭に移動します。 
※実際の表示が表示行／物理行には依存しません。 

goto-virtual-column

指定された表示桁へ移動します。 

  COLUMN   : 移動する表示桁位置を指定します。 
  EXCEED-P : （詳細不明） 

表示桁が折り返しの桁位置よりも大きいときは、折り返しの桁位置で止まります。 
※実際の表示が表示行／物理行には依存しません。 

goto-virtual-eol

表示行の行末に移動します。 
※実際の表示が表示行／物理行には依存しません。 

goto-virtual-line

表示行での指定行に移動します。 
ウィンドウの表示行／物理行の切替は、「共通設定」−「表示」−「行番号は表示行(D)」 
で行います。 

参考： 
  ファイルイメージ： 
    001| ABCDEFGHIJKLMNOPQR
    002| ABCDEFGHIJKLMNOPQRS
    003| ABCDEFGHIJKLMNOPQRST
    004| ABCDEFGHIJKLMNOPQRSTU
    005| ABCDEFGHIJKLMNOPQRSTUV

                    │ 
      ┌──────┴──────┐ 
      ↓                          ↓ 

  物理行：                        表示行：                      
    001| ABCDEFGHIJKLMNOPQR         001| ABCDEFGHIJKLMNOPQR
    002| ABCDEFGHIJKLMNOPQRS        002| ABCDEFGHIJKLMNOPQRS
    003| ABCDEFGHIJKLMNOPQRST       003| ABCDEFGHIJKLMNOPQRST
    004| ABCDEFGHIJKLMNOPQRST       004| ABCDEFGHIJKLMNOPQRST
       | U                          005| U
    005| ABCDEFGHIJKLMNOPQRST       006| ABCDEFGHIJKLMNOPQRST
       | UV                         007| UV

make-marker

空のマーカーを作って返します。 

  BUFFER : マーカーを作るバッファを指定します。 

mark

マークの位置を数値で返します。 

  FORCE：マークが設定されていない場合に処理を継続するか？ 
        t       エラーとしない、関数はnilを返す
        nil     エラーとする

marker-buffer

マーカーが設定されているバッファを返します。 

使用例： 
  (marker-buffer m)
  => #<buffer: *scratch*>

marker-point

マーカーの位置を数値で返します。 
マーカーの位置が設定されていなかったり削除されていたりした場合は nil を返します。 

使用例： 
  (marker-point m)
  => 62

narrow-to-region

指定した範囲以外を移動・編集できないようにします。[C-x n]
save-restrictionのブロックが終了するか、widenすると元に戻ります。 
point-min, point-maxの値も変わります。 

使用例： 
  C-SPCでマークを付けて、どっかに移動して、C-x n(narrow-to-region)とする
  と、指定したリージョンの外には移動できなくなります。私は置換のときに置き 
  換える範囲を制限したり、キーボードマクロの範囲を制限したりするのによく使
  います。あとは、Lispコードの中で特定の範囲だけいじるときなんかにも使いま
  す。 

newline-and-indent

改行後、文字が存在する直前の行と同じ桁数だけインデントをします。 
モードに依存したインデントコマンドは使用しません。 

next-line

N行後の物理行に移動します。 
  t    最終行以外の場合 
  nil  最終行の場合 

next-line-add-newlines

バッファの最後尾でnext-line系の移動をしたときの動作を設定します。 

  t   空行を挿入します 
  nil 何もしません

使用例： 
  (setq next-line-add-newlines t)

next-virtual-line

N行後の表示行に移動します。 
  t    最終行以外の場合 
  nil  最終行の場合 

point

この関数は、ポイントの位置を integer として返します。 
goto-char でその位置に飛ぶことが出来ます。バッファの先頭ではpoint-minに
等しく、バッファの最後ではpoint-maxに等しいです。 

使用例： 
  (point)
  => 175

point-max

カレントバッファの一番大きなポイント値を返します。narrow-to-region等で、 
clipping 制限が用いられてない限り、カレントバッファの大きさになります。 

使用例： 
  (point-max)
  => 189568

point-min

カレントバッファの一番小さなポイント値を返します。narrow-to-region等で、 
clipping 制限が用いられてない限り 0 になります。 

使用例： 
  (point-min)
  => 0

pre-selection-p

セレクションが存在すれば t しなければ nil を返します。 

previous-line

1行前に移動します。 

使用例： 
  (previous-line)

previous-virtual-line

N行前の表示行に移動します。 
  t    先頭行以外の場合 
  nil  先頭行の場合 

save-excursion

処理の前後でカレントバッファとポイントを保存します。ウィンドウのレイアウ
トは保存しないので注意してください。 

ウィンドウのレイアウトも保存したい場合には、save-window-excursionを使います。 

--- muleの説明 --- 
この特殊フォームは、カレントバッファのポイントとマークをセーブし、 forms 
を評価し、ポイントとマークをリストアします。 (throw や error による) 異
常 exit の場合もポイントとマークの値をリストアします。マーカーはバッファ
中のポジションとともにそのバッファも指しているため、マークをリストアする
ことは (Emacs の) カレントバッファの notion (訳注：??) もリストアするこ 
とになります。 

カレントバッファの notion を変更しなくてはいけない場合や、カレントバッフ
ァのポイントを動かさなくてはいけない場合、カレントバッファとポイントをリ
ストアできるようにするのは (標準的な)方法です。 

別のバッファのポイントやマークはセーブされません。このため(それらの)ポイ
ントやマークに対する変更は save-excursion の exit 後も保持されます。 

save-excursion は、switch-to-buffer のような関数で破壊されたウィンドウと 
バッファの対応はリストアしません。 selected ウィンドウをリストアする方法 
の 1つは save-excursion 中で save-window-excursion を用いることです(セク
ショ ン 25.11 [save-window-excursion]、ページ 248 参照)。 

返される値は(最後に)評価されたフォームの返す値か、フォームが与えられてい 
ない場合 nil になります。 

save-restriction

narrow-to-regionする前の状態を保存します。ポイントやバッファの位置は保存 
しません。ポイントやバッファの位置を保存したい場合には、save-excursionを 
使用します。 

特定の処理の前後でrestrictionの状態とポイントの両方を保存したい場合には、 
以下の様にします。 

  ;;; うまくいく書き方
  (save-excursion (save-restriction ... )) 

以下の様に書いてしまった場合、処理の中でrestrictionを掛けると内側の
save-excursionでのポイントの復元がうまくいかないことがあります。注意しま
しょう。 

  ;;; うまくいかないことがある書き方
  (save-restriction (save-excursion ... ))

使用例： 
    ;;; この時点では narrow-to-region してないとする。 
    (save-restriction
      (narrow-to-region FROM-1 TO-1)             ; FROM-1からTO-1に制限する 
      (save-restriction
        (narrow-to-region FROM-2 TO-2)           ; FROM-2からTO-2に制限する 
        (msgbox "~A ~A" (point-min) (point-max))
      )                                          ; FROM-1からTO-1に制限されている
                                                 ; 状態に戻る 
      (msgbox "~A ~A" (point-min) (point-max))
    )                                            ; 制限されなくなる 
    (msgbox "~A ~A" (point-min) (point-max))

selection-mark

セレクションの開始のポイントを返します。 

selection-point

セレクションの終端のポイントを返します。 

set-fill-column

詰め込み桁数を指定します。 
指定された値は、変数 fill-column に代入されます。 

  COL : 詰め込み桁数
        引数がない場合は、現在のカーソル位置の桁数を詰め込み桁数に設定し
        ます。 

set-goal-column

ゴールカラムを設定します。save-excursionしてもgoal-columnが破壊されない 
ように使用するぐらいでしょうか。 

使用例： 
  ;;; goal-columnを大事にして編集してみる。 
  (let ((g (goal-column)))
    (save-excursion ... )
    (set-goal-column g))
  => t

set-marker

マーカーにポジションを設定します。 
POINT が nil の場合は現在の位置を設定します。 

  POINT : マーカーに設定する位置

使用例： 
  (setq m (make-marker))
  => #<marker: *scratch*: ->
  (set-marker m)
  => #<marker: *scratch*: 62>
  (marker-point m)
  => 62

skip-token

多分シンボル構成文字と単語構成文字をスキップします。 
（詳細不明） 

skip-white-backward

空白文字を後方にスキップします。 
シンタックステーブル上でwhitespaceとして規定されている文字を後方に
スキップします。他にも影響する要素があるようですが詳細は不明。 

skip-white-forward

空白文字を前方にスキップします 
シンタックステーブル上でwhitespaceとして規定されている文字を前方に
スキップします。他にも影響する要素があるようですが詳細は不明。 

stop-selection

セレクションを解除します。 

unset-marker

マーカーのポジションを解除します。 
オブジェクトはマーカーとして残ります。 

使用例： 
  (unset-marker m)
  => t
  m
  => #<marker: *scratch*: ->

up-list

カーソルを ARG 個外側の括弧の後ろに移します。 

  (setq lst '(a b c)) ; ここから
               ^
  (setq lst '(a b c)) ; ここへ
                    ^

ARG が負の場合には、前の方の括弧へ移動します。 

  (setq lst '(a b c)) ; ここから
               ^
  (setq lst '(a b c)) ; ここへ
             ^

外側に括弧が見つからなかった場合、 
NO-ERRORS が nil の場合にはエラーを、 t の場合には nil を返します。 

virtual-bolp

仮想行の行頭にあるかを返します。 
バッファが行を折り返して表示している場合に有効です。 

  t     仮想行の行頭にある
  nil   仮想行の行頭にない 

virtual-eolp

仮想行の行末にあるかを返します。 
バッファが行を折り返して表示している場合に有効です。 

  t     仮想行の行末にある
  nil   仮想行の行末にない 

widen

narrow-to-regionで制限された領域を元に戻します。