- 投稿
お世話になっております。
http://hide.maruo.co.jp/lib/macro/doxylabel.html
のように、関数やクラスなどから自動的に適切な提携コメントを生成するマクロはございますでしょうか。
上記マクロを使ってみたところ非常に有用だったのでEmEditorにもあればうれしいと思いました。
以上よろしくお願いいたします。
hide 様
いつも EmEditor Professional をお使いいただき、誠にありがとうございます。
もしお探しのマクロが無い場合、詳しく仕様を書いていただければ、私の方でできるだけ作成してみます。お力になれば幸いです。
他にも何かご質問などがございましたら、ご遠慮なくお問い合わせください。
よろしくお願い申し上げます。Doxygen仕様に基づいてコメント挿入を行なうマクロのようですね。確かにこれは大変便利だと思います。Doxygenを用いてドキュメントを出力している人達やコメント入力が億劫な人達にとっては良いマクロかも知れません。
Doxygen
http://www.doxygen.jp/Doxygen仕様コメント挿入マクロ
http://yyp.jp/software/hidemacro/DoxyLabel/ファイルコメントと、クラスコメント・関数コメント挿入機能は私も使用してみたいです。私はスニペット文として定型コメント文を追加し使用していましたが、単純に引数等や返値などが整形された状態で入力されるだけでも有り難いと個人的には思います。
お世話になっております。
>もしお探しのマクロが無い場合、詳しく仕様を書いていただければ、
>私の方でできるだけ作成してみます。お力になれば幸いです。どうもありがとうございます。
ただ私はソフトエンジニアではないのできちんとした仕様を書くことはできないと思います。
画像処理のどちらかというとハードウエアよりを生業としていて、シミュレーションソフトを書くときにCやRubyを使うのですが、いつもファイル先頭や関数の前に書くコメントを書くのが面倒で、かつ書いたとしてもその場の雰囲気で書いてしまうためにフォーマットが一定しないところで、コメントを自動生成（しかも生成する場所によって適切な書式で）してくれるマクロがあることを知って、実際に使ってみて感動したという次第で…
こんな私が仕様を書くと、恐らくプロのソフトエンジニアの方から見ると、非常にバランスの悪い仕様になってしまいかねないと思います。Doxygenというのも初耳だったりします。
仕様という意味では
Y_oshidaさんから紹介していただいた
http://yyp.jp/software/hidemacro/DoxyLabel/
のページの下の方に記載されている「対応コメント」というものが一番ふさわしいかと思います。
大変恐縮ですが、これを見ていただいて可能かどうか検討してみていただけないでしょうか。アプローチとしては二つあると思っていまして、
一つはEmEditorの作者の方、またはそれに近しいコミュニティーの方に書いてもらう。もう一つは、上記のページの作者の方がVisual Studio版も検討するというような記述もあるので、dllを作ってもらってEmEditorでそれを呼び出すという案です。
前者はEmEditorコミュニティーでコントローラブルであるし将来的に融通が利く,エディタ本体と親和性が高いというメリットがありますし、後者は秀丸エディタとEmEditorという日本を代表する二大エディタで同じ仕様のものが動くというメリットがあります。後者でしたら作者さんに私が頼んでみます。
いかがなものでしょうか？
（いずれにしろ、他人任せな私で大変恐縮なのですが…）
個人的にはEmEditor本体との一体感があったほうがありがたいなと思います。以上非常に勝手な事ばかり書いてしまいましたがご検討のほどよろしくお願いいたします。
rubyで書くなら、マクロもRubyで書いちゃって、関数コメントはerbやRdocで書いちゃえばいいのでは？
EmEditorのマクロはRubyも使えますよ。
あと、Doxygenを使うのであれば、、外部コマンドとして連携し、ソースコードを直接書き直せば出来るかと思いますが。。。
takuraさん、こんにちは。hdieです。
erbとRdocを少し調べてみました。
恐らくこれらのツールの主目的は、ソースコードをドキュメンテーションするというもののような気がします。
私はどちらかというとソースコードからソースコードに埋め込むコメント行を自動生成して挿入する機能が欲しいなと思っています。（Rdocはソースコードから自動的にドキュメントを作る機能があるので、応用できるのかもしれませんが…）
ちょっとググっただけなので(^^;)見落としていてちゃんと私が欲しい機能があるのかもしれません。erbやRdocに関してもしそのような機能の説明がありましたらそのポインタを教えてください。
以上よろしくお願いいたします。管理人さん：
お世話になっております。
>もしお探しのマクロが無い場合、詳しく仕様を書いていただければ、
>私の方でできるだけ作成してみます。お力になれば幸いです。上記の方で、仕様の書かれているサイトをご紹介させていただいたのですがいかがでしたでしょうか。
http://yyp.jp/software/hidemacro/DoxyLabel/
のページの下の方に記載されている「対応コメント」もし作成が厳しそうであれば、オリジナルの方の作者さんに相談しようかなと思っています。どのような感触かだけ返信いただけるとありがたいです。
お忙しい中恐縮ですがよろしくお願いいたします。hide 様
いつも EmEditor Professional をお使いいただき、ありがとうございます。
お返事が遅くなり、大変申し訳ありませんでした。
申し訳ないのですが、教えていただいたサイトの内容すべてだと、数行のマクロで可能、というわけにはいかないような気がします。まずこれを理解するためにしばらく時間を必要とすると思います。これだと、私の範囲を超えているので、申し訳ありませんが、他の方に書いていただけるのでしたら、そうしていただくほうが早いかと思います。
他にも何かご質問がございましたら、ご遠慮なくご発言ください。
今後もよろしくお願い申し上げます。ちょっとマクロの内容を覗いてみました。
秀丸マクロを触ったことはないですが、どうやらさほど特殊なことはしていないようです。
型をすべて$にしたり、暗黙の値、たとえばtabcountをeditor.activeDocument.config.indentProp.tabColumnsに、yearをJavaScript標準のDateから作るようにしたりすれば、動きそうな感じがします。
（エディタ本体に対する操作は本質的な部分ではないので、追ってませんが）作者さんにEmEditorを強要するわけにも行きませんし（マクロは有償版のみの機能なので）、ここはご自身でJavaScriptを勉強するという選択肢も、あると思いますよ。
- このトピックに返信するにはログインしてください。