maprangeについて

[dmiyakawa]

http://seuzo.net/entry/2012/03/12/100307

二点ありまして

1. quickstartあたりに公式の説明が欲しいです
2. 先頭が#@だとC++等のファイルを引用する際引用元に問題が発生しないか気になっています。オプションの第三引数等で先頭の文字列を変更するといったことに対応したりはしていないでしょうか。

[kdmsnr]

プリプロセッサはreファイルを書き換えてしまうので、必要であればReVIEWの記法にしたいところですねえ。

[aamine]

去年のissueにコメントするのもあれですが……
まず行頭の件については「#@@range」にすると行中でも対応できるので、コメントなどに埋め込むことができます。

またプリプロセッサが原稿を直接書き換えるのには2つ理由があります。

1. コードの変更は筆者側で行うべき（編集には正誤を判断できないことがあるから）だが、ReVIEW記法にすると編集と責任を共有することになり、責任の所在が不明確になる
2. バージョン管理システムによって差分を見えるようにしたい。埋め込んだコードを更新すると文章の更新も同時に発生することが多いので、コードが変わったことを筆者が認識できるフローにすべきです。

[takahashim]

@aamine #@@rangeは初耳でした…

[takahashim]

#632 の通り、doc/preproc.mdとdoc/preproc.ja.mdに説明を記載しました。ので、こちらは閉じます。