view release on metacpan or  search on metacpan

docs/cat-v.deepl-JA.pod  view on Meta::CPAN

アルファベットや数字以外の文字が指定された場合は、その文字に置き換えられます。

    cat-v --nl='$'

2文字以上の文字列が指定された場合、Unicode文字名として解釈されます。

    cat-v --nl='RETURN SYMBOL' --sp='MIDDLE DOT'

フラグがC<+>で始まる場合、その文字はリピートリストに追加されます。

    cat-v --esc=+s

つまり、上記のコマンドは、次のように書いたのと同じ意味になります。

    cat-v --esc=s --repeat +esc

=item B<--repeat>=I<name>[,I<name>...]

変換後の文字と同時に元の文字を出力する文字種を指定します。デフォルトはC<nl,np>です。以下のようにすると、エスケープ文字が可視化された元のANSIシーケンスが正しく出力されますã...

    cat-v -c esc --repeat esc,nl

I<name> が C<+> で始まる場合は、既存の設定に加えてその文字を追加します。

    cat-v -c esc --repeat +esc

=item B<-o>, B<-oo>, B<--original>

変換後の文字列が元の文字列と異なる場合、変換後の文字列が出力される前に元の文字列が出力されます。2回指定すると、常に元の文字列が出力されます。

この出力は、L<App::cdif>のC<--line-by-line> (C<--lxl>)オプションで使うことができます。

=item B<-t>[I<n>], B<--expand>[=I<n>]

=item B<-T>, B<--no-expand>

タブ文字はデフォルトで展開されます。明示的に無効にするには、B<-T>またはB<--no-expand>オプションを使用します。

B<-t>オプションに任意の数字が与えられた場合、それはタブ幅として扱われます。次の2つのコマンドは等価である：

    cat-v -t4
    cat-v -t --tabstop=4

デフォルトではC<needle>スタイルが適用され、C<--tabstyle>で変更できます。C<--tabstyle> オプションが引数なしで指定された場合、利用可能なスタイルのリストが表示されます。

C<~/.cat-vrc>ファイルに以下の設定を記述することで、デフォルトでタブ展開を無効にすることができます。

    option default --no-expand

その場合、C<-t>オプションで一時的にタブ展開を有効にすることができます。

=item B<--tabstop>=# (DEFAULT: 8)

タブ幅を設定します。

=item B<--tabhead>=#

=item B<--tabspace>=#

タブヘッドとそれに続くスペース文字を設定します。オプ シ ョ ン値が 1 文字 よ り 長い場合は、 unicode 名 と し て評価 さ れます。

=item B<--tabstyle>, B<--ts>

=item B<--tabstyle>=I<style>, B<--ts>=...

=item B<--tabstyle>=I<head-style>,I<space-style> B<--ts>=...

タブの展開方法を設定します。例えば、C<記号>またはC<影>を選択します。C<squat-arrow,middle-dot>のように2つのスタイル名を組み合わせた場合、タブヘッドにはC<squat-arrow>を、タブスペースに...

パラメータなしで呼ばれた場合、利用可能なスタイルリストを表示します。スタイルは L<Text::ANSI::Fold> ライブラリで定義されています。

=item B<-C>=I<color>, B<--color>=I<color>

置き換えられた文字は I<color> で指定された色で表示されます。このオプションは、ANSIカラーシーケンスを含む出力には適さないです。

=item B<-E>, B<--escape-backslash>

バックスラッシュ文字をエスケープされた形式C<all>に変換します。

バックスラッシュは制御文字ではませんが、このように他の制御文字をエスケープ表現に変換した結果は、様々なプログラミング言語の文字列リテラルとして完全に解釈することができã...

次のコマンドは、元のファイルの内容を完全に再現します。

    echo -ne "$(cat-v -Ence FILE)"

=back

=head1 INSTALL

=head2 CPANMINUS

CPANアーカイブから：

    cpanm App::cat::v

GITリポジトリから

    cpanm https://github.com/tecolicom/App-cat-v.git

=head1 SEE ALSO

=over 4

=item L<https://github.com/tecolicom/App-cat-v.git>

Gitリポジトリ。

=item L<App::optex::util::filter>

C<cat-v>コマンドの前身は、もともとL<App::optex>コマンドのフィルタモジュールとして作られたものです。

=item L<https://harmful.cat-v.org/cat-v/>

UNIXスタイル、または有害と考えられるcat -v

=item L<https://harmful.cat-v.org/cat-v/unix_prog_design.pdf>

UNIX環境でのプログラム設計

=back