マクロヘルプの記載漏れ - 秀丸エディタβ版 - スレッド03737, 2009/09/09

マクロヘルプの記載漏れ

colder さん　09/09/09 13:35

charsetにUTF-32のときの文字コードがありません。

キーワードにgrep文で使われるオプションoutputsametab、unmatchがありません。

環境:秀丸v8β12

RE:03737 マクロヘルプの記載漏れ

Iranoan さん　09/09/09 14:10

　colder さん今日は、Iranoan です。
> charsetにUTF-32のときの文字コードがありません。
　これは、そもそも追加されていないのか、記載漏れかどうか解りませんが、
> キーワードにgrep文で使われるオプションoutputsametab、unmatchがありません。
については、
> 　outputsametab を指定すると出力先を「タブグループごと」にできます。（V7.0
>0以降）
>
> 　unmatch を指定すると「ヒットしない行」にできます。（V8.00以降）
と一応有ります。outputsingle と共に、
> grep 検索文字列, 検索するファイル, カレントフォルダ [,word]
> [,casesense | nocasesense] [,regular | noregular] [,fuzzy] [,subdir]
> [,icon] [,filelist] [,fullpath] [, hilight | nohilight]
にも追加するべきだとは思いますが。

RE:03743 マクロヘルプの記載漏れ

colder さん　09/09/09 14:39

>> charsetにUTF-32のときの文字コードがありません。
>　これは、そもそも追加されていないのか、記載漏れかどうか解りませんが、
charsetの値を実際に表示させてみた結果、
27 UTF-32
28 UTF-32(ビッグエンディアン)
となっているのを確認しています。

>> キーワードにgrep文で使われるオプションoutputsametab、unmatchがありません。
>については、
>> 　outputsametab を指定すると出力先を「タブグループごと」にできます。（V7.
>00以降）
>>
>> 　unmatch を指定すると「ヒットしない行」にできます。（V8.00以降）
>と一応有ります。outputsingle と共に、
ヘルプの本文の方にはあることは知っていますが、キーワードの方にもあった方がい
いんじゃないでしょうか。

RE:03747 マクロヘルプの記載漏れ

Iranoan さん　09/09/09 14:47

　colder さん今日は、Iranoan です。
> 27 UTF-32
> 28 UTF-32(ビッグエンディアン)
> となっているのを確認しています。
　御指摘有り難うございます。
　##マニュアルに反映しておこう(^^)。

> キーワードの方にもあった方がい
> いんじゃないでしょうか。
「キーワード」にですか、仰るとおりですね。

RE:03749 マクロヘルプの記載漏れ

秀丸担当 さん　09/09/09 14:50

ご指摘ありがとうございます。
charsetに追記しておきます。
outputsametab,unmatchもヘルプのキーワードに入れておきます。

ヘルプの
> grep 検索文字列, 検索するファイル, カレントフォルダ [,word]
のような記述に全部書くと大量になってしまうので、比較的新しく追加されたも
のについては下に説明を書くだけにして、[]表記は書かないようにしてしまって
います。

RE:03751 マクロヘルプの記載漏れ

IKKI さん　09/09/10 02:14

こんにちは。IKKI です。

> ヘルプの
> > grep 検索文字列, 検索するファイル, カレントフォルダ [,word]
> のような記述に全部書くと大量になってしまうので、比較的新しく追加されたも
> のについては下に説明を書くだけにして、[]表記は書かないようにしてしまって
> います。

これは、どんなに煩雑になっても全部書いた方がいいと思います。

ヘルプを読むのは人間とは限りません。
私はいま、ヘルプファイルを機械的に解析して内容を再構成し、別の形で利用する
(例えば、単語補完中にヒントを表示する) ようなものを考えているのですが、
残念ながら現在のヘルプは機械可読であるとは言えません。

記載漏れ防止と機械可読化を両立するために、hidemac.dll のソースにドキュメント
を埋め込んでおき、doxygen などのツールを使って chm ファイルを自動生成する手
があります。
あの量を今から移行するのも大変ですが、一考の価値はあるかと思います。

RE:03771 マクロヘルプの記載漏れ

秀丸担当 さん　09/09/10 10:44

>ヘルプを読むのは人間とは限りません。
>私はいま、ヘルプファイルを機械的に解析して内容を再構成し、別の形で利用する
>(例えば、単語補完中にヒントを表示する) ようなものを考えているのですが、
>残念ながら現在のヘルプは機械可読であるとは言えません。

そういう使い方も考えられましたか。
もしやるとすればこれをずっとサポート・維持しなくてはならないことになると
思うので、やるかどうかはわかりませんが、そういうこともあるということで参
考にさせていただきます。