ポジション

*gmark-keep-column*

non-nil なら、global-mark-goto と back-tag-jump の移動の時に行頭へ移動し
ないようになります。

*page-scroll-keep-window-position*

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

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

*smart-indentation*

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

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

back-to-indentation

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

backward-char

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

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

backward-line

N 行後方へ移動します。
移動の前後で goal-column を保存しません。

(backward-line n) と (forward-line (- n)) は同じです。

backward-page

後方の改ページまで移動します。[C-x ]]
改ページが無い場合はバッファの先頭に移動します。
一般には制御文字のform feedが単独である行で改ページを表します。

  ARG : ページ数を指定します。デフォルトは 1 です。
        負の値の場合、逆向きに移動します。

backward-paragraph

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

backward-virtual-line

表示行で N 行後方へ移動します。

backward-word

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

beginning-of-buffer

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

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

beginning-of-line

行頭に移動します。goto-bolのinteractive版です。[C-a], [C-Left]

beginning-of-virtual-line

表示行の行頭に移動します。
goto-virtual-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 個内側の括弧の後ろに移します。[ESC C-d]

  (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

現在行の終りに移動します。[C-e], [C-Right]

end-of-virtual-line

表示行の行末に移動します。
goto-virtual-eol の interactive 版です。

eobp

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

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

eolp

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

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

exchange-point-and-mark

カーソルとマークの位置を入れ替えます。[C-x C-x]

fill-column

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

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

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

forward-char

指定された文字数だけ右に移動します。改行があれば次行に移動します。
[C-f], [Right]

互換性： 
  Emacsでは移動できない場合エラーが発生します。xyzzyではエラーは発生し
  ません。その代わり、動けたときは t、動けなければ nil を返します。

forward-line

N行後に物理行に移動します。
移動の前後で goal-column を保存しません。

戻り値:
  移動した行数を返します。全く移動できなかったときは nil です。

forward-list

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

forward-page

前方の改ページまで移動します。[C-x []
改ページが無い場合はバッファの末尾に移動します。
一般には制御文字のform feedが単独である行で改ページを表します。

  ARG : ページ数を指定します。デフォルトは 1 です。
        負の値の場合、逆向きに移動します。

forward-paragraph

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

forward-virtual-line

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

forward-word

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

goal-column

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

goto-bol

行頭に移動します。

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

goto-char

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

  POINT: バッファ上の位置です。整数またはマーカーを利用できます。
         移動できる最小の位置は point-min で取得でき、これよりも小さい
         値を指定した時は point-min の位置に移動します。
         移動できる最大の位置は point-max で取得でき、これよりも大きい
         値を指定した時は point-max の位置に移動します。

戻り値：
  mule では、POINT が返されますが、 xyzzy では常に t です。 

goto-column

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

  COLUMN : 桁数

goto-eol

行末に移動します。

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

goto-line

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

goto-marker

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

goto-matched-parenthesis

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

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

jump-to-register

レジスタ R に格納されたマーカーの位置へジャンプします。[C-x r j]
R にマーカーが入っていないとエラーになります。

make-marker

空のマーカーを作って返します。
バッファを編集することで、マーカーの位置もそれに追随して変わります。
マーカーは、 goto-char や buffer-substring、delete-region などのバッ
ファ上の位置を引数にとる関数の引数として使用できます。

  BUFFER : マーカーを作るバッファを指定します。
           指定しなければ、現在のバッファになります。

使用例：
  ;; スクラッチでマーカーを作る
  (setq marker (make-marker (find-buffer "*scratch*")))
  => #<marker: *scratch*: ->

  ;; マーカーに位置を設定する
  (set-marker marker 3)
  => #<marker: *scratch*: 3>

  ;; マーカー位置に移動する
  (goto-char marker)
  => t

  ;; マーカーより手前の内容を削除する
  (goto-char (point-max))
  (delete-region 0 1)
  (marker-point marker)
  => 2

  ;; マーカーより手前に文字列を挿入する
  (goto-char 0)
  (insert "abc")
  (marker-point marker)
  => 5

  ;; マーカー位置に文字列を挿入する
  (goto-char marker)
  (insert "xyz")
  (marker-point marker)
  => 5

mark

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

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

mark-page

改ページで区切られた領域をリージョンに設定します。[C-x C-p]
改ページが無い場合、バッファ全体がリージョンになります。

  ARG : ページ位置を指定します。デフォルトは 0 です。

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

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

next-line

N行後の物理行に移動します。 
移動の前後で goal-column を保存します。

戻り値:
  1行でも移動できたときは t 、それ以外は nil です。

next-line-add-newlines

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

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

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

next-virtual-line

N行後の表示行に移動します。 [C-n], [Down]
  t    最終行以外の場合
  nil  最終行の場合

next-word

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

point

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

使用例：
  (point)
  => 175

point-marker

新しいマーカーを作成し、現在のカーソル位置にセットして返します。

point-max

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

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

point-min

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

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

point-to-register

新しいマーカーを作って現在位置にセットし、レジスタ R に格納します。
[C-x r SPC]

pre-selection-p

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

previous-line

N行前に移動します。
移動の前後で goal-column を保存します。
(previous-line n) と (next-line (- n)) は同じです。

使用例:
  (previous-line)

previous-virtual-line

N行前の表示行に移動します。 [C-p], [Up]
  t    先頭行以外の場合
  nil  先頭行の場合

previous-word

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

region-beginning

リージョンの開始のポイントを返します。

  ; markやpointとの関係
  (= (region-beginning) (min (mark) (point)))
  =>t

region-end

リージョンの終端のポイントを返します。

  ; markやpointとの関係
  (= (region-end) (max (mark) (point)))
  =>t

save-excursion

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

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

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

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

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

set-goal-column

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

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

set-mark

ポイントの位置にマークを設定します。

  POINT: マークを設定する位置を指定します。
         範囲外の値を指定してもエラーにはならないようです。

set-mark-command

マークを設定します。[ESC SPC], [C-@]
ビルトイン関数の set-mark を対話に行うためのものです。

使用例：
  ;;; マークを設定してその位置を取得する。
  (set-mark-command)
  => t
  (mark)
  => 2554

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   仮想行の行末にない

what-cursor-position

カーソル位置の情報をステータスバーに表示します。[C-x =]
カーソル位置の文字の内部コード値、UNICODE値、
カーソル位置のバッファにおける位置、
桁数などが表示されます。

使用例:
  "w"の位置で情報を見る
  Char: w (0x77 / U+0077 / 0x77[us-ascii])  point=46 of 518(8%)  column 7

  "カ"の位置で情報を見る
  Char: カ (0x834a / U+30ab / 0x252b[jisx0208])  point=152 of 395(38%)  column 0

widen

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