Skip to content

Conversation

@t-mochizuki
Copy link
Member

@t-mochizuki t-mochizuki commented Jul 28, 2018

#207
お時間があるときにご確認よろしくお願いします。

entry や entries を「項目」と訳していますが、他に適当な訳があればコメントいただけると幸いです。

訳文の近くに英文があるほうがレビューしやすいかと思い、下記リンク先にそのような状態のブランチを残しています。もしレビューのときに使えそうであればご利用下さい。

https://github.com/vim-jp/vimdoc-ja-working/compare/master...t-mochizuki:wip_update_quickfix_8.1.0026?expand=1

doc/quickfix.jax Outdated
echo getqflist({'lines' : systemlist('grep -Hn quickfix *')})
これは'items'キーの値がlinesをパースしたQuickFix項目のリストの値から成る辞書を
返す。下記はどのように'errorformat'オプションを変更することなしにlinesをパース
するためにカスタム'errorformat'を使うべきかを示す。>
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'>' の前に半角スペースが必要だと思いますので半角スペースを追加する予定です。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こんな感じでどうでしょうか。
「これは 'items' キーに行からパースされたQuickFixの項目のリストが含まれている辞書を返す。以下は 'errorformat' オプションを変更せずにカスタム 'errorformat' を使って行をパースする方法を示している。」

getqflist()関数とgetloclist()関数はそれぞれQuickFixリストとロケーションリスト
のさまざまな属性を取得するために使われる。これらの関数を使用するためのいくつか
の例は以下です:
>
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここにも半角スペースを追加する予定です。

setqflist()関数とsetloclist()関数はそれぞれQuickFixリストとロケーションリスト
のさまざまな属性を設定するために使われる。これらの関数を使用するためのいくつか
の例は以下です:
>
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここにも半角スペースを追加する予定です。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/使われる/使用できる/
s/これらの関数を使用するためのいくつかの例は以下です:/これらの関数の使用例を以下に示す:/

Copy link
Member

@h-east h-east left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

細かい指摘なしで代替文章の提示が多めになってしまいました。「そこ、もとの文章でも通じるだろ」ってとこも直している箇所もあるかもしれません。確認頂いて納得のいかないところがあれば k-takata さんに判断を委ねようと思います。お手数ですがよろしくお願いします。

あと、全体的に|~|'~'の前後には空白をお願いします。
wikiのvim-ドキュメント翻訳者の手引きを「引用符でくくられている部分」で検索ください。

doc/quickfix.jax Outdated

*quickfix-ID*
各QuickFixリストはQuickFix IDと呼ばれる一意な識別子を持ち、この番号はVimセッ
ションの中で変わらない。getqflist()関数はリストに割り当てられた識別子を得るた
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

getqflist()関数はリストに割り当てられた識別子を得るために使われる。

getqflist()は識別子取得専用の関数ではないので以下のような表現がいいと思います。
「getqflist()関数はリストに割り当てられた識別子の取得に使用できる。」

doc/quickfix.jax Outdated
各QuickFixリストはQuickFix IDと呼ばれる一意な識別子を持ち、この番号はVimセッ
ションの中で変わらない。getqflist()関数はリストに割り当てられた識別子を得るた
めに使われる。10個以上のリストがQuickFixスタックに追加されるときはいつでも、変
わるかもしれないQuickFixリスト番号もある。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

QuickFixリスト番号

この名称は文章の前半に出てきた方がわかりやすいと思いました。こんな感じでどうでしょうか。
「QuickFixリスト番号もある。この番号は、10個以上のリストがQuickFixスタックに追加されるたびに変更される可能性がある。」

doc/quickfix.jax Outdated
する読み込み専用のchangedtick変数を持つ。QuickFixリストが変更されるたびに、こ
の総数は増加される。そのリストが変更されたときにだけ、これはアクションを行うた
めに使われる。getqflist()関数とgetloclist()関数はchangedtickの現在の値を問うた
めに使われる。あなたはchangedtick変数を変えられない。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

< そのリストが変更されたとき~

こんな感じでどうでしょうか。
「これは、リストが変更されたときだけアクションを実行することに使用できる。getqflist()およびgetloclist()関数は changedtick の現在の値を問い合わせるのに使用できる。changedtick変数を変更することはできない。」

doc/quickfix.jax Outdated
て考えられる。|setqflist()|関数と|setloclist()|関数はそれぞれQuickFixリストと
ロケーションリストをコンテキストと結びつけて考えるために使われる。
|getqflist()|関数と|getloclist()|関数はそれぞれQuickFixリストとロケーションリ
ストのコンテキストを取り出すために使われる。これは複数のQuickFix/ロケーション
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Vimの型はコンテキストのように ~~~ コンテキストを取り出すために使われる。

こんな感じでどうでしょうか。
「任意のVimの型はQuickFixリストまたはロケーションリストとのコンテキストとして関連付けることができる。|setqflist()| と |setloclist()| 関数はコンテキストをQuickFixとロケーションリストにそれぞれ関連付けることに使用できる。|getqflist()| と |getloclist()| 関数はそれぞれQuickFixとロケーションリストのコンテキストの取得に使用できる。」

doc/quickfix.jax Outdated
<
*quickfix-parse*
あなたは|getqflist()|関数を使用してQuickFixリストを作成または変更することなし
'errorformat'を使用しているlinesのリストの値をパースできる。例: >
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

これでどうでしょうか。
「|getqflist()| 関数を使用してQuickFixリストを作成または変更せずに、'errorformat' を使用して行のリストをパースできる。」

doc/quickfix.jax Outdated
*getqflist-examples*
getqflist()関数とgetloclist()関数はそれぞれQuickFixリストとロケーションリスト
のさまざまな属性を取得するために使われる。これらの関数を使用するためのいくつか
の例は以下です:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こんな感じでどうでしょうか。
「getqflist() 関数と getloclist() 関数は、それぞれquickfixとロケーションリストのさまざまな属性を取得するのに使用できる。これらの関数の使用例を以下に示す:」

setqflist()関数とsetloclist()関数はそれぞれQuickFixリストとロケーションリスト
のさまざまな属性を設定するために使われる。これらの関数を使用するためのいくつか
の例は以下です:
>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/使われる/使用できる/
s/これらの関数を使用するためのいくつかの例は以下です:/これらの関数の使用例を以下に示す:/

doc/quickfix.jax Outdated

QuickFixリストのスタックとロケーションリストのスタックの中のリスト番号を取得す
るために、特別な値'$'に設定したリスト番号があればそれぞれ|getqflist()|関数と
|getloclist()|関数を使用できる。例: >
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こんな感じでどうでしょうか。
「QuickFixやロケーションリストのスタック数を取得するには、特別な値 '$' に設定されたリスト番号でそれぞれ、|getqflist()| 関数と |getloclist()| 関数を使用できる。」

doc/quickfix.jax Outdated
|getloclist()|関数を使用できる。例: >
echo getqflist({'nr' : '$'}).nr
echo getloclist(3, {'nr' : '$'}).nr
そのスタックの中の現在のリスト番号を取得するためには: >
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こんな感じでどうでしょうか。
「スタック内の現在のリスト番号を取得するには:」

"%o"はQuickfix項目の中のモジュール名を指定する。もし指定があればそれがファイル
名の代わりにQuickfixエラーウィンドウの中で使われる。モジュール名は結果を表示す
るためだけに使われ、ファイル名はそのファイルにジャンプするときに使われる。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"%o"の後ろに空白をお願いします。

@t-mochizuki
Copy link
Member Author

レビューありがとうございます!
レビュー結果を反映します!

- reflect review comments of "2. The error window"
- reflect review comments of "3. Using more than one list of errors"
- reflect review comments of "4. Using :make"
- reflect review comments of "1. Using QuickFix commands"
@t-mochizuki
Copy link
Member Author

一通りレビュー結果を反映しましたので、お時間があるときにご確認よろしくお願いします:pray:

@h-east h-east requested a review from k-takata August 11, 2018 08:11
doc/quickfix.jax Outdated
|QuickFixCmdPre|に関連付けられた自動コマンドが全て
:mak[e][!] [arguments] 1. |QuickFixCmdPre| に関連付けられた自動コマンドが全て
実行される。
2, オプション 'autowrite' がonならば変更のあるバッファ
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

今回の変更部分ではないですが、
2, ->2.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ありがとうございます!
修正しました:)

@h-east h-east merged commit 1e06a13 into vim-jp:master Aug 11, 2018
@t-mochizuki t-mochizuki deleted the update_quickfix_8.1.0026 branch August 12, 2018 04:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants