• Wisteria >
• 秀丸マクロ >

AltComment

目次 ダウンロード 概要と特長 できないこと セットアップ 使い方 動作 設定 高度な設定例 プリセット一覧 コメントマクロ比較 お約束 バージョン履歴 フィードバック

ダウンロード

• altcom110.lzh　Version 1.10　(2008/10/12)

概要と特長

• 秀丸エディタ用のコメント反転マクロです。コメント化マクロとコメント解除マクロを統合しました。
  • 「地の文だった場所をコメント化したい」
  • 「コメントだった場所を地の文に戻したい」
  というユーザーの意図を汲み、ひとつのマクロで両方の処理ができます。コメントマクロはこれ1本で済むでしょう。
• 秀丸がカラー表示できる言語はほとんど設定済み。面倒な設定をせずに使い始められます。
• 使用するコメント記号はファイルタイプ（拡張子）ごとに定義されます。
  • 「// から改行まで」のような行コメント
  • 「/* から */ まで」のような範囲コメント
  それぞれ何種類でも定義でき、ひとつのファイルタイプに混在も可能。混在してる場合はどれについて反転するのか自動判別します。
• 編集中のあらゆる状態に対応します。
  • 無選択時はカーソル位置を反転。
  • 文字列選択時は選択範囲内を交互に反転。
  • BOX 選択時は行ごとに反転。
  BOX 選択だと使えないとか、行が折り返してると変な結果になるとか、そういう本質的でない制限は一切ありません。
• インデントを意識した処理を行います。
• アンドゥ1回で元に戻ります。

できないこと

• Pascal/Delphi や SQL のようにネスト可能なコメントは対象外です。ネストしてなければ正しく処理できます。
• Fortran77 や COBOL のように桁位置が意味を持つ言語は対象外です。コメント記号の挿入／削除により桁がずれます。
• 飾りコメントの類を扱うようには設計されていません。
• フリーカーソルはサポートされません。起動時に強制的に OFF になり、終了時に元に戻ります。

セットアップ

インストール

1. 秀丸エディタ ver 7.00 以降をお使いですね？
2. マクロフォルダの位置を確認します。（マクロフォルダは秀丸の [その他(O)]-[動作環境(E)...]-[パス]-[環境]-[マクロファイル用のフォルダ(M)] で指定されているフォルダです。無指定なら Hidemaru.exe と同じフォルダです）
3. ダウンロードしたアーカイブをマクロフォルダに解凍します。
4. [マクロ(M)]-[マクロ登録(E)...] で AltComment.mac を適当な番号に登録します。
5. [その他(O)]-[キー割り当て(K)...] で適当なキーに割り当てます。
6. 割り当てたキーを押して実行します。ユーザー設定ファイルが自動的に作られます。

インストール後のファイル構成は次のようになります。

■マクロフォルダ\
│・AltComment.mac              …起動マクロ
│
└─■AltComment\
　　　・AltComment-Main.mac     …本体
　　　・AltComment.ini          …ユーザー設定ファイル
　　　・AltComment-Default.ini  …デフォルト設定ファイル

アップデート

1. 新しいアーカイブをマクロフォルダに上書き解凍します。ユーザー設定ファイルはそのまま引き継がれます。

アンインストール

1. インストール時と同じ方法でキー割り当てを解除します。
2. 同様にマクロ登録も解除します。
3. AltComment.mac および AltComment フォルダ以下の全ファイルを削除します。レジストリは使っていません。

使い方

• 反転したい位置にカーソルを置いてマクロを実行します。
• 反転したい範囲を選択してマクロを実行します。

動作

無選択時

カーソル位置が地の文ならコメントに、コメント内なら地の文にします。設定により行単位で処理することもできます。〈→設定〉

行コメント

範囲コメント

両方あるとき

カーソル位置がコメント内なら上方直近の有効なコメント記号を削除します。地の文なら設定に従って決められたコメント記号を挿入します。

文字列選択時

選択範囲内の地の文をコメントに、コメントを地の文にします。

行コメント

範囲コメント

行選択時は最初と最後のコメント記号が1行を占めるようにします。

両方あるとき

選択範囲の先頭を基準として自動判別します。

BOX 選択時

1行ごとに分割し、文字列選択時の動作を適用します。全角文字やタブ文字をまたいでも大丈夫です。折り返してる2行目以降は無視されます。

行コメント

範囲コメント

両方あるとき

選択範囲の先頭を基準として自動判別します。

設定

秀丸がカラー表示に対応している言語はほとんどプリセットされてます。〈→プリセット一覧〉　プリセットに満足できないときはユーザー設定ファイル AltComment.ini に記述を加えます。ここではその方法を説明します。

設定は拡張子ごとに行います。また、複数の拡張子をひとつのファイルタイプと見なし、ファイルタイプごとに設定することもできます。詳しくはデフォルト設定ファイル AltComment-Default.ini を参考にするか、 CompleteX のマニュアルを参照してください。〈→CompleteX リファレンス：設定ファイルの書き方〉

設定ファイルの中身はだいたいこんな感じになります。

[.c]
1L=/*
1R=*/
2L=//
with=space,indent
line=yes
change=3
skipcolors=20

設定項目は次のとおりです。「…」以下は説明文なので実際の設定ファイルに書いてはいけません。

定義

1L, 1R, 2L, 2R, ...

コメント記号を定義します。 1L, 2L, ... はコメント開始記号（必須）、 1R, 2R, ... はコメント終了記号（行コメントの場合は省略）です。

例

1L=//    …行コメント開始記号
2L=/*    …範囲コメント開始記号
2R=*/    …範囲コメント終了記号
; 以下同様

数字は優先順位です。1から連番になっていなければなりません。挿入時は原則として 1L, 1R に指定されたコメント記号が使われます。（後述する change= の設定によっては 2L, 2R も使えます）

with

付加文字列を指定します。（デフォルト = なし）

with=space     …挿入時：コメント記号の内側（コメント内容との間）に半角スペースを付加する
               　削除時：コメント記号の内側に半角スペースがあったらそれも削除する
with=indent    …挿入時：地の文に合わせてコメント記号をインデントする
               　削除時：インデントされたコメント記号も削除する
with=space,indent    …両方

インデントは処理位置が行頭の場合のみ有効です。

change

挿入時に使うコメント記号を選択します。（デフォルト = 0）

change=0    …常に 1L, 1R を使う
change=1    …無選択時は 1L, 1R を、文字列選択時は 2L, 2R を使う
change=n    …選択範囲が n 行未満のときは 1L, 1R を、それ以上のときは 2L, 2R を使う

BOX 選択時は見かけの選択行数で判断されます。この設定にかかわらず、処理範囲の先頭がコメント内だった場合はそのコメント記号が使われます。

skipcolors

コメント記号と見なさない色をカラーコードで指定します。（デフォルト = なし）

skipcolors=20,11,5    …文字定数、URL、特に強調1 は除外

カラーコードは秀丸マクロヘルプの [内部的な値を表現するキーワード]-[カーソル関連キーワード] を参照してください。カンマ区切りで複数指定できます。（カンマの前後にスペースなどを入れてはいけません）

1LX, 1RX, 2LX, 2RX, ...

判定用の検索パターンを正規表現で記述します。通常の設定で対応できないときに使います。〈→高度な設定例〉

1SX, 2SX, ...

判定用の検索オプションを指定します。コメント記号がアルファベットのときに使います。〈→高度な設定例〉

処理範囲

line

行単位で処理するかどうか指定します。（デフォルト = no）

line=yes    …行単位で処理
line=no     …文字列単位で処理

行の途中からコメント化することがない場合は line=yes を指定します。すると無選択時は行全体がコメント化され、範囲選択時は選択範囲が行単位に拡大されます。これは後述する forline=2 と selline=1 をともに指定するのと同じです。無選択時のコメント解除動作はこの設定に影響されません。

forline

無選択時のコメント化範囲を指定します。 line= の指定を上書きします。（デフォルト = 0）

forline=0    …カーソル位置
forline=1    …行全体（カーソル位置が行末の場合を除く）
forline=2    …行全体（常に）

コメント解除動作はこの設定に影響されません。

selline

文字列選択時の処理範囲を指定します。 line= の指定を上書きします。（デフォルト = 0）

selline=0    …選択範囲そのまま
selline=1    …選択範囲を行単位に拡大
selline=n    …選択範囲が n 行以上のときは行単位に拡大

その他の動作

autosave

実行後、自動的に上書き保存するかどうか指定します。（デフォルト = no）

autosave=yes    …保存する
autosave=no     …保存しない

参照記法

@

デフォルト値として他のセクションを参照します。他のセクションの設定をオーバーライドし、差分だけを書くことができます。

例

[HTML/XML]
1L=<!--
1R=-->
with=space

[.rhtml]
@=HTML/XML
with=indent

この例だと拡張子 rhtml に対し　1L=<!--　1R=-->　with=indent　が設定されます。参照できるのは同じ設定ファイル内にあるセクションだけです。設定を誤ると無限ループします。

ユーザー設定とデフォルト設定

AltComment の設定はユーザー設定ファイル AltComment.ini とデフォルト設定ファイル AltComment-Default.ini の2段構えになっています。ユーザーごとの設定はユーザー設定ファイルに書きます。デフォルト設定ファイルはバージョンアップのたびに上書きされるので、いじらない方がいいです。

コメント記号の定義（1L=, 1R=, 1LX=, 1RX=, 1SX=, ...）は一括して、ユーザー設定ファイルに 1L= が定義されていればユーザー設定が、そうでなければデフォルト設定が採用されます。ふたつの設定ファイルの定義が混ざることはありません。

その他の設定（with=, line=, change=, ...）は項目ごとに、ユーザー設定ファイルに値が書かれてればそれが、書かれてなければデフォルト設定が採用されます。デフォルト設定ファイルに書かれた値を打ち消したいときはユーザー設定ファイルにデフォルト値（selline=0 など）または解釈不能な値（with=none など）を書いてください。

高度な設定例

判定用の検索パターンや検索オプションを別途指定しなければならない例を挙げます。これらの設定はマクロ内部のアルゴリズムを理解していないと難しいので、なるべくプリセットに含めておきたいと思います。通常の設定で対応できない例があったら作者に教えてください。〈→談話室〉

1LX=, 1RX=, 1SX=, 2LX=, 2RX=, 2SX=, ... を用いるには、対応するコメント記号 1L=, 1R=, 2L=, 2R=, ... が同じ設定ファイルに定義されていなければなりません。

例1： TeX

TeX はコメント記号をエスケープできます。エスケープされた「\%」はコメント記号ではないので無視しなければなりません。このような場合は検索パターンを正規表現で記述します。

[.tex]
1L=%
1LX=(?<!\\)%[ \t]*

この設定はプリセットに含まれています。

例2： C++

C++ で「//*」という文字列がある場合、これは行コメントですが、範囲コメントの開始と勘違いすることがあります。勘違いを防ぐには次のように指定します。

[C/Java]
1L=//
2L=/*
2R=*/
2LX=(?<!/)/\*[ \t]*
2RX=[ \t]*\*/
[.c]
@=C/Java
[.h]
@=C/Java
[.cpp]
@=C/Java

この設定はプリセットに含まれています。

例3： Fortran77

Fortran77 のコメント記号は行頭にある「C」または「*」です。行頭以外の「C」や「*」は無視しなければなりません。文は行単位なので line=yes も指定しておきましょう。

[.f77]
1L=C
1LX=^C
2L=*
2LX=^\*
line=yes

この設定はプリセットに含まれています。なお、実際に Fortran77 でこのマクロを使う際は桁ずれにご注意ください。

例4： Windows コマンドスクリプト

コマンドスクリプト（バッチファイル）は REM 命令がコメント開始記号になります。もし「REMOVE」なんてコマンドがあってもヒットしないよう、検索オプションとして word を指定します。コマンドは行単位なので line=yes も指定しておきましょう。

[.cmd]
1L=REM
with=space    …スペース付加
1LX=^REM      …検索パターン（単語の検索を行うため「^REM[ \t]*」とはしない）
1SX=word      …単語の検索
line=yes

この設定はプリセットに含まれています。なお、大文字小文字を区別するときは casesense を指定します。

1SX=casesense         …大文字小文字を区別する
1SX=word,casesense    …単語の検索、大文字小文字を区別する

プリセット一覧

プリセット（配布時の設定）はデフォルト設定ファイル AltComment-Default.ini に記述されています。内容は次のとおりです。

コメントマクロ比較

コメントを扱う秀丸マクロはたくさんあります。わかる範囲でピックアップしてみました。　（2005/03/13 現在）

この比較表に間違いがあったら教えてください。〈→談話室〉

お約束

動作環境

• 秀丸エディタ v7.10β9 + HMJRE.DLL v1.92 で動作確認しました。
• JRE32.DLL では使えません。
• BRegIf.dll + {BREGEXP.DLL, bregonig.dll} はサポート外です。

ライセンス

• このマクロはフリーウェアです。自由に利用、改変、再配布することができます。
• 改変したものを公に再配布するときは次のことを明記してください。
  • 改変したものである旨（できれば改変内容も）
  • 改変元の名称、バージョン、一次配布場所

配布場所

一次配布場所は Wisteria - 秀丸マクロ - AltComment です。二次配布は次のところで行われています。

• 秀丸エディタのマクロライブラリ
• Vector - Windows95/98/Me > 文書作成 > テキストエディタ > 秀丸エディタ

謝辞

• プリセット内容は Peggy の対応言語詳細 (langlist.pdf) を参考にさせていただきました。

バージョン履歴

Version 1.10 (2008/10/12)

• 秀丸エディタ v7.10 対応
  • アンドゥ1回で元に戻る
  • 折りたたみ／部分編集をなるべく維持
  • JRE32.DLL サポート廃止

Version 1.06 (2006/03/05)

• デフォルト設定ファイルの見直し
  • 秀丸エディタ v6.00β に合わせて定義を追加（LISP に ;| 〜 |; 、 Pascal に //）
  • HmJre.dll 用と JRE32.DLL 用に分ける（自動選択）
  • HmJre.dll 用には前方不一致を使った高度な設定をプリセット

Version 1.05 (2005/08/09)

• ドキュメントの「鶴亀メール」を「秀丸メール」に修正（アーカイブは次のバージョンまで更新されません）

Version 1.05 (2005/03/04)

• 「/*」が「/\*」になるなど、正規表現のメタキャラクタがらみのバグ修正（v1.04 でエンバグした）

Version 1.04 (2005/02/27)

• line=yes が適用されてなかったバグ修正
• JRE32.DLL で2バイト文字の前にコメント記号が挿入されない事象（JRE32.DLL のバグ）に対処
• ↑の副作用として、コメント記号挿入処理を高速化（数百か所あると体感できるかも程度）

Version 1.03 (2005/02/20)

• 正式版（今までβを外すタイミングを逸してた。 beta 9 が v1.00 相当ということ）
• 「行末<->次の行の行頭」の設定が元に戻らないバグ修正
• 行単位処理の簡略指定 line=yes を追加
• ドキュメント見直し

Version 1.0 beta 11 (2004/10/11)

• コメント記号に関してはユーザー設定ファイルとデフォルト設定ファイルの定義を混ぜない
• ドキュメントのバグ修正（「高度な設定例」に書いてある通り設定すると期待した動作にならなかった）
• ドキュメント追記（設定ファイルの仕様について）

Version 1.0 beta 10 (2004/10/04)

• 範囲コメントが閉じてないと変な結果になるバグ修正

Version 1.0 beta 9 (2004/06/22)

• selline=n で選択範囲が1行ずつ増えるバグ修正

Version 1.0 beta 8 (2004/05/04)

• 範囲コメントで無選択でカーソルが行頭で SmartUndo が有効だと処理範囲が上の行とつながって変な結果になるバグ修正
• ↑にともなう仕様変更：　最終行末が EOF の場合はアンドゥ4回で元に戻る
• 範囲コメントで行選択で with=space,indent だとインデントされた終了記号が削除されず変な結果になるバグ修正（上方向最長一致検索の実装が中途半端だった）
• 無選択でカーソルが行頭以外のとき change=1 により文字列選択時の設定が適用されてしまうバグ修正
• BOX 選択時も change=n による切り替えを有効にする（見かけの行数で判断）

Version 1.0 beta 5 (2004/03/07)

• 設定ファイル書式変更：　1L, 1R, 2L, 2R, ... は正規表現のメタキャラクタをエスケープしない
• 最終行末が EOF の場合のバグ修正

Version 1.0 beta 4 (2004/03/03)

• 自動保存機能
• いくつかバグ修正
• ドキュメント加筆

Version 1.0 beta 1 (2004/02/28)

• ドキュメントを書いて公開

フィードバック

設定例の提供、バグ報告、ツッコミなどは 談話室 へどうぞ。