デバッグ初体験03【ruby-debug v0.9.3 マニュアルお気楽翻訳】
2007年07月09日 (月)
ruby-debug v0.9.3 のヘルプファイルを今日は目標10分で超訳してみたいと思います。
ちなみにRails2.0対応のもっと新しい v0.10.0の内容はこちらからどうぞ。
翻訳が間違ってても責任は負いかねますよ！Good Luck To Myself!!
やりたいこと別にリンクを付けてみましたよ。
※ 以下のコマンドのうち、[ホニャララ] の、ホニャララの部分は省略できます。
---------------------
★変数の値を見たい
★今どの行をデバッグしているか見たい
★ブレークポイントを追加・削除したい
★ステップ実行をしたい
★一気に実行したい
★watch式のように、ある値を繰り返し見たい
★全部の変数について一覧したい
★スレッドを操作したい
★スレッドにトレースモードを設定したい
★例外をキャッチしたい
★今の状態をセーブしたい・ロードしたい（ドラクエの教会のように）
★デバッグ中のオプションを設定したい
★irbを使いたい
★デバッグをやめたい
★ヘルプを使いたい
★その他
---------------------
★変数の値を見たい (↑topへ)
■p EXPRESSION
■e[val] EXPRESSION
EXPRESSION を評価してその結果を出力する。（←訳注：pp の方が見やすい形で出力されます。）
set autoeval を使うと autoval が有効になります。
■pp EXPRESSSION
EXPRESSION を評価してその結果を出力する。（←訳注：p よりも見やすい形で出力されます。）
★今どの行をデバッグしているか見たい (↑topへ)
■l[ist][ (-|=|nn-mm)]
プログラムソースコードを表示する。list を実行する度に次のページのソースコードが表示される。- を指定すると前のページのソースコードが表示される。=を指定すると、現在の行を表示する。nn-mm を指定すると nn 行目から mm 行目までのソースコードを表示する。
set autolist を使うと、autolist が有効になります。
■up[count]
上位レベルのフレームへ移動する。
■down[count]
下位レベルのフレームへ移動する。
■f[rame] フレーム番号
指定されたフレーム番号のフレームへ移動する。フレーム番号に負の値が指定された場合、逆順になる。frame -1 の場合は、一番古いフレームへ、frame 0 の場合は、一番新しいフレームへ移動する。
■w[here]
■bt|backtrace
スタックを表示する。
■r[eload]
ソースコードをリロードする。
★ブレークポイントを追加・削除したい (↑topへ)
■b[reak]
breakpointを一覧表示する。
■b[reak] [file:]行番号 [if expr]
■b[reak] [class(.|#)]メソッド名 [if expr]
breakpointを指定された場所に設定する。if expr が指定された場合、 expr == true の時だけbreakpointを設定する
■del[ete][ nnn]
break コマンドで表示される番号を指定して、breakpoint を消す。番号が指定されていなかったら、全部の breakpoint を消す。
★ステップ実行をしたい (↑topへ)
■s[tep][ nnn]
今の行の step into。nnn が指定されていると、nnn 行までの step into。
■fin[ish]
上位レベルのフレームへ処理を戻す。
■n[ext][+][ nnn]
1 行 step over する。もしくは nnn 回 step over する。+ を指定すると、強制的に次の行へ移動する。
★一気に実行したい (↑topへ)
■c[ont] [ nnn]
次の breakpoint が見つかるか nnn 行目までプログラムを実行する。
■restart|R [args]
デバッグを最初からやり直す。args が指定されている場合、やり直す時のコマンド引数として使用する。
★watch式のように、ある値を繰り返し見たい (↑topへ)
■disp[lay]
expression を一覧表示する。
■disp[lay] EXPRESSION
expression 一覧に EXPRESSION を加える。（←訳注：watch みたいなものでしょう。）
■undisp[lay][ nnn]
指定された番号の expression を消す。番号が指定されていなかったら、全部の expression を消す。（←訳注：今試してみたら expression が消されなかったのですけど・・・orz）
★全部の変数について一覧したい (↑topへ)
■v[ar] g[lobal]
グローバル変数を表示する。
■v[ar] l[ocal]
ローカル変数を表示する。
■v[ar] c[onst] オブジェクト名
オブジェクトの定数を表示する。
■v[ar] i[nstance] オブジェクト名
オブジェクトのインスタンス変数を表示する。
■m[ethod] i[nstance] オブジェクト名
オブジェクトのメソッド名を表示する。
■m[ethod] クラス名|モジュール名
クラスやモジュールのインスタンスメソッド名を表示する。
★スレッドを操作したい (↑topへ)
■th[read] l[ist]
スレッド一覧を表示する。
■th[read] [sw[itch]] nnn
スレッドコンテキストを nnn 番に切り替える。
■th[read] stop nnn
nnn 番のスレッドを停止する。
■th[read] c[ur[rent]]
現在実行しているスレッドを表示する。
■th[read] resume nnn
nnn 番のスレッドを開始する。
★スレッドにトレースモードを設定したい (↑topへ)
■tr[ace] (on|off)
現在のスレッドにトレースモードを設定する。
■tr[ace] (on|off) all
全てのスレッドにトレースモードを設定する。
★例外をキャッチしたい (↑topへ)
■cat[ch]
catchpoint を表示する。
■cat[ch] 例外名
指定された例外名に catchpoint を設定する。
★今の状態をセーブしたい・ロードしたい（ドラクエの教会のように） (↑topへ)
■save ファイル名
現在の breakpoint や catchpoint をスクリプトファイルとして保存する。
■script ファイル名
スクリプトファイルを実行する。
★デバッグ中のオプションを設定したい (↑topへ)
■set
には以下の値を使用できる。
autolist
- 全部のブレークポイントに対して list コマンドを実行する。
autoeval
- コマンドとして認識されないものは全部評価する。
autoreload
- ソースコードの自動再読み込みを行う。
autoirb
- デバッガが止まる度に IRB を入れる。
trace
- eval 評価されるときには、必ずスタックトレースを表示する。
framefullpath
- フルパス名のファイル名でフレームを表示する。
frameclassname
- フレームと一緒にクラス名も表示する。
forcestep
- next/step コマンドは、必ず次の行へ進むようにする。
★irbを使いたい (↑topへ)
■irb
irb セッションを開始する。（まだ実験段階）
★デバッグをやめたい (↑topへ)
■q[uit]
■exit
デバッガから抜ける。（←訳注：Web サーバも止まっちゃうみたいです。）
★ヘルプを使いたい (↑topへ)
■h[elp]
ヘルプを表示する
■h[elp] command
指定されたコマンドのヘルプを表示する。
★その他 (↑topへ)
■エンターキー
前のコマンドを繰り返す。
■その他
入力された式をそのまま評価する。
結局45分ぐらい掛かってもうた orz
【広告】
ちなみにRails2.0対応のもっと新しい v0.10.0の内容はこちらからどうぞ。
翻訳が間違ってても責任は負いかねますよ！Good Luck To Myself!!
やりたいこと別にリンクを付けてみましたよ。
※ 以下のコマンドのうち、[ホニャララ] の、ホニャララの部分は省略できます。
---------------------
★変数の値を見たい
★今どの行をデバッグしているか見たい
★ブレークポイントを追加・削除したい
★ステップ実行をしたい
★一気に実行したい
★watch式のように、ある値を繰り返し見たい
★全部の変数について一覧したい
★スレッドを操作したい
★スレッドにトレースモードを設定したい
★例外をキャッチしたい
★今の状態をセーブしたい・ロードしたい（ドラクエの教会のように）
★デバッグ中のオプションを設定したい
★irbを使いたい
★デバッグをやめたい
★ヘルプを使いたい
★その他
---------------------
★変数の値を見たい (↑topへ)
■p EXPRESSION
■e[val] EXPRESSION
EXPRESSION を評価してその結果を出力する。（←訳注：pp の方が見やすい形で出力されます。）
set autoeval を使うと autoval が有効になります。
■pp EXPRESSSION
EXPRESSION を評価してその結果を出力する。（←訳注：p よりも見やすい形で出力されます。）
★今どの行をデバッグしているか見たい (↑topへ)
■l[ist][ (-|=|nn-mm)]
プログラムソースコードを表示する。list を実行する度に次のページのソースコードが表示される。- を指定すると前のページのソースコードが表示される。=を指定すると、現在の行を表示する。nn-mm を指定すると nn 行目から mm 行目までのソースコードを表示する。
set autolist を使うと、autolist が有効になります。
■up[count]
上位レベルのフレームへ移動する。
■down[count]
下位レベルのフレームへ移動する。
■f[rame] フレーム番号
指定されたフレーム番号のフレームへ移動する。フレーム番号に負の値が指定された場合、逆順になる。frame -1 の場合は、一番古いフレームへ、frame 0 の場合は、一番新しいフレームへ移動する。
■w[here]
■bt|backtrace
スタックを表示する。
■r[eload]
ソースコードをリロードする。
★ブレークポイントを追加・削除したい (↑topへ)
■b[reak]
breakpointを一覧表示する。
■b[reak] [file:]行番号 [if expr]
■b[reak] [class(.|#)]メソッド名 [if expr]
breakpointを指定された場所に設定する。if expr が指定された場合、 expr == true の時だけbreakpointを設定する
■del[ete][ nnn]
break コマンドで表示される番号を指定して、breakpoint を消す。番号が指定されていなかったら、全部の breakpoint を消す。
★ステップ実行をしたい (↑topへ)
■s[tep][ nnn]
今の行の step into。nnn が指定されていると、nnn 行までの step into。
■fin[ish]
上位レベルのフレームへ処理を戻す。
■n[ext][+][ nnn]
1 行 step over する。もしくは nnn 回 step over する。+ を指定すると、強制的に次の行へ移動する。
★一気に実行したい (↑topへ)
■c[ont] [ nnn]
次の breakpoint が見つかるか nnn 行目までプログラムを実行する。
■restart|R [args]
デバッグを最初からやり直す。args が指定されている場合、やり直す時のコマンド引数として使用する。
★watch式のように、ある値を繰り返し見たい (↑topへ)
■disp[lay]
expression を一覧表示する。
■disp[lay] EXPRESSION
expression 一覧に EXPRESSION を加える。（←訳注：watch みたいなものでしょう。）
■undisp[lay][ nnn]
指定された番号の expression を消す。番号が指定されていなかったら、全部の expression を消す。（←訳注：今試してみたら expression が消されなかったのですけど・・・orz）
★全部の変数について一覧したい (↑topへ)
■v[ar] g[lobal]
グローバル変数を表示する。
■v[ar] l[ocal]
ローカル変数を表示する。
■v[ar] c[onst] オブジェクト名
オブジェクトの定数を表示する。
■v[ar] i[nstance] オブジェクト名
オブジェクトのインスタンス変数を表示する。
■m[ethod] i[nstance] オブジェクト名
オブジェクトのメソッド名を表示する。
■m[ethod] クラス名|モジュール名
クラスやモジュールのインスタンスメソッド名を表示する。
★スレッドを操作したい (↑topへ)
■th[read] l[ist]
スレッド一覧を表示する。
■th[read] [sw[itch]] nnn
スレッドコンテキストを nnn 番に切り替える。
■th[read] stop nnn
nnn 番のスレッドを停止する。
■th[read] c[ur[rent]]
現在実行しているスレッドを表示する。
■th[read] resume nnn
nnn 番のスレッドを開始する。
★スレッドにトレースモードを設定したい (↑topへ)
■tr[ace] (on|off)
現在のスレッドにトレースモードを設定する。
■tr[ace] (on|off) all
全てのスレッドにトレースモードを設定する。
★例外をキャッチしたい (↑topへ)
■cat[ch]
catchpoint を表示する。
■cat[ch] 例外名
指定された例外名に catchpoint を設定する。
★今の状態をセーブしたい・ロードしたい（ドラクエの教会のように） (↑topへ)
■save ファイル名
現在の breakpoint や catchpoint をスクリプトファイルとして保存する。
■script ファイル名
スクリプトファイルを実行する。
★デバッグ中のオプションを設定したい (↑topへ)
■set
autolist
- 全部のブレークポイントに対して list コマンドを実行する。
autoeval
- コマンドとして認識されないものは全部評価する。
autoreload
- ソースコードの自動再読み込みを行う。
autoirb
- デバッガが止まる度に IRB を入れる。
trace
- eval 評価されるときには、必ずスタックトレースを表示する。
framefullpath
- フルパス名のファイル名でフレームを表示する。
frameclassname
- フレームと一緒にクラス名も表示する。
forcestep
- next/step コマンドは、必ず次の行へ進むようにする。
★irbを使いたい (↑topへ)
■irb
irb セッションを開始する。（まだ実験段階）
★デバッグをやめたい (↑topへ)
■q[uit]
■exit
デバッガから抜ける。（←訳注：Web サーバも止まっちゃうみたいです。）
★ヘルプを使いたい (↑topへ)
■h[elp]
ヘルプを表示する
■h[elp] command
指定されたコマンドのヘルプを表示する。
★その他 (↑topへ)
■エンターキー
前のコマンドを繰り返す。
■その他
入力された式をそのまま評価する。
結局45分ぐらい掛かってもうた orz
【広告】