マクロヘルプの更新は？ - 秀丸エディタ関連ソフト会議室 - スレッド15622, 2003/11/01

マクロヘルプの更新は？

IKKI さん　03/11/01 03:03

IKKI です。正式版完成おめでとうございます。

hidesoft.4:03935 に関連して…
正規表現で大文字小文字を区別しない／単語の検索ができるようになったのにともな
い、マクロヘルプの記述と実際の動作に齟齬が生じています。『regularまたはfuzzy
を指定するとword，casesenseは無視されます。』という記述は嘘になりましたし、
キーワード nocasesense が追加されたことも書かれていません。

今回マクロの仕様変更は少なかったとはいえ、他にもいくつか更新すべき個所がある
かと思います。
現在マクロヘルプの改訂に取り組んでいらっしゃることと拝察いたしますが、完成ま
での間とりあえず、ヘルプが未更新である旨ホームページに注記するなどされてはい
かがでしょうか。

# 決して更新を急かしているわけではなく、この機会にマクロヘルプを全面的・体系
的に再整備していただきたいと思っています。
　やはりキーワードの一覧表は欲しいですし、シングルクォート内のエスケープ（'\
'' や '\r' など）について言及がないのもどうかと…。

RE:15622 マクロヘルプの更新は?

Iranoan さん　03/11/01 17:17

　IKKI さん今日は、Iranoan です。
> 正規表現で大文字小文字を区別しない/単語の検索ができるようになったのにともな
> い、マクロヘルプの記述と実際の動作に齟齬が生じています。
　以前
> まだ仕様変更が起き
> る可能性が高いので、しばらくヘルプは書かない方がいいと思います。
→http://www.maruo.co.jp/turukame/3/x01461_.html#1606
という話がありましたので、何かお考えがあるかもしれません。

> 　やはりキーワードの一覧表は欲しいです
　一覧表があったとして、何に使うのでしょう? ヘルプの「キーワード」に登
録されていれば、必要無い気がします。
　印刷に使ったり、一旦テキストにして検索するのかなあ～。

> シングルクォート内のエスケープ('\
> '' や '\r' など)について言及
　こちらは、「マクロ言語 (入門用) ヘルプ」に合った方がふさわしいかと。

RE:15627 マクロヘルプの更新は?

秀丸担当 さん　03/11/04 16:29

とりあえず、nocasesenseとnoregularを追記したヘルプに修正しようと思います。
仕様的にも保留だったのが確定となりました。
全面的なヘルプの整備また検討します。

RE:15652 マクロヘルプの更新は?

IKKI さん　03/11/06 10:49

IKKI です。コメントありがとうございます。

▼ Iranoan さん

> > 　やはりキーワードの一覧表は欲しいです
> 　一覧表があったとして、何に使うのでしょう? ヘルプの「キーワード」に登
> 録されていれば、必要無い気がします。
> 　印刷に使ったり、一旦テキストにして検索するのかなあ～。
>
> > シングルクォート内のエスケープ('\'' や '\r' など)について言及
> 　こちらは、「マクロ言語 (入門用) ヘルプ」に合った方がふさわしいかと。

使う／使わないの議論以前に、プログラミング言語のリファレンスとして必ず備える
べき内容ではないでしょうか。

例として思いついたのはたまたまこの2点でしたが、他にも秀丸マクロのヘルプはリ
ファレンスとして欠けている部分が多いように感じられます。
細かい動作を知るために自分で実験しなければならないことは日常茶飯ですし、特に
縁石ギリギリを走ろうとするとき（秀丸マクロは遅いのでしばしばその必要に迫られ
ます）、どこまでが「仕様」でどこからが「たまたまそうなっているだけ」なのかを
ユーザーが実験結果から判断するのは至難です。
実行エンジンがオープンソースならそれを読めば済む話ですが、そうでなければせめ
て厳密なリファレンスを用意してほしい、と思う次第です。

▼ 秀丸担当さん

> とりあえず、nocasesenseとnoregularを追記したヘルプに修正しようと思います。
> 仕様的にも保留だったのが確定となりました。

わかりました。よろしくお願いします。

> 全面的なヘルプの整備また検討します。

こちらも期待しています。ぜひ腰を据えて取り組んでください。

RE:15665 マクロヘルプの更新は?

Iranoan さん　03/11/06 17:53

　IKKI さん今日は、Iranoan です。
> 使う／使わないの議論以前に、プログラミング言語のリファレンスとして必ず備える
> べき内容ではないでしょうか。
　リファレンスで使うなら、尚更ヘルプの現在のキーワードへの登録と系統別
で記載で、不足ないのでは? ということです。つまり、オンライン・ヘルプが
書籍の形態を踏襲する必要はない、という考えです。もちろんこれは使い方に
よっては変わってくるので、
> 　一覧表があったとして、何に使うのでしょう?
という疑問を呈したのです。

> 細かい動作を知るために自分で実験しなければならないことは日常茶飯ですし、特に
> 縁石ギリギリを走ろうとするとき
　確かにその通りですが、
> （秀丸マクロは遅いのでしばしばその必要に迫られ
> ます）
エディタのマクロって、こんなものではないでしょうか?
　##他のエディタのマクロって、もっと速いのかなあ～。

> どこまでが「仕様」でどこからが「たまたまそうなっているだけ」なのかを
> ユーザーが実験結果から判断するのは至難です。
　私はその時は聞くことにしています。そして回答を手元で纏めておくことに
しています。
　##関数その他の仕様がはっきり書いていないのは、秀丸に限ったことではな
いし(^^;。

　もちろん IKKI さんの仰るように、本体であれマクロであれヘルプが充実す
ることは大賛成です。ただ個人的には、仕様に関してはお聞きしたときに回答
が得られれば十分で、それよりは開発に時間を割いていただき、多機能/高速
化をして頂いた方が嬉しい、というだけです。

RE:15677 マクロヘルプの更新は?

IKKI さん　03/11/07 03:15

IKKI です。以下は雑談になります。

> 　リファレンスで使うなら、尚更ヘルプの現在のキーワードへの登録と系統別
> で記載で、不足ないのでは? ということです。つまり、オンライン・ヘルプが
> 書籍の形態を踏襲する必要はない、という考えです。もちろんこれは使い方に
> よっては変わってくるので、
> > 　一覧表があったとして、何に使うのでしょう?
> という疑問を呈したのです。

直接のきっかけは補完マクロ用の辞書（キーワード一覧）を作ろうとしたことでした。
もっとも、これは Iranoan さんとませまさんが公開されている強調表示定義ファイ
ルを転用させてもらうことで解決してしまいました。
# Iranoan さんはあの定義ファイルをどのようにして作られたのでしょう？

> > どこまでが「仕様」でどこからが「たまたまそうなっているだけ」なのかを
> > ユーザーが実験結果から判断するのは至難です。
> 　私はその時は聞くことにしています。そして回答を手元で纏めておくことに
> しています。

なるほど。そうして得られた情報がフォーラムの過去ログや Iranoan さんのサイト
に蓄積されているわけで、それらを活用するのもユーザーのスキルということになり
ますね。

RE:15685 マクロヘルプの更新は?

Iranoan さん　03/11/07 18:46

　IKKI さん今日は、Iranoan です。
> # Iranoan さんはあの定義ファイルをどのようにして作られたのでしょう？
　hidemac.dll をエディタで開いて編集するという無謀な方法を使っています(^^;。