NAME

ansiexpand, ansiunexpand - ANSI sequences aware tab expand/unexpand command

SYNOPSIS

ansiexpand [ option ] file ...

ansiunexpand [ option ] file ...

-t# --tabstop=#              tab stop width
    --tabhead=char           tab head character
    --tabspace=char          tab space character
    --tabstyle=style         tab style
    --ambiguous=wide|narrow  width of Unicode ambiguous character

VERSION

Version 1.01

DESCRIPTION

ansiexpand is an expand(1) compatible command utilizing Text::ANSI::Tabs module, which enables to handle ANSI terminal sequences and Unicode wide characters.

This is a command line interface for Text::ANSI::Tabs module, which uses Text::ANSI::Fold module as a backend. Consult them for implementation detail.

OPTIONS

• --unexpand, -u

  Behave as unexpand command.

• --tabstop=#, -t#

  Set tab stop width. Unlike expand(1), takes only single value.

• --tabhead=char

• --tabspace=char

  Set tab head and following space character. If longer than single character, it is considered as a Unicode name.

• --tabstyle=style, --ts=style

  Set tab style. Try --tabstyle=shade for example. See Text::ANSI::Fold for detail.

• --ambiguous=wide|narrow

  Set the width of Unicode ambiguous characters. Default is narrow.

INCOMPATIBILITY

There is no -a option for ansiunexpand and it always convert all spaces not only leading ones. Use normal unexpand(1) to convert just leading spaces.

ansiexpand expands all tabs even if it is converted to single space without reducing data length.

FILES

• ~/.ansiexpandrc, ~/.ansiunexpandrc

  Start-up file. See Getopt::EX::Module for format.

INSTALL

CPANMINUS

$ cpanm App::ansiexpand

SEE ALSO

App::ansiexpand, https://github.com/kaz-utashiro/App-ansiexpand

Text::ANSI::Tabs

Text::ANSI::Fold

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright 2021-2022 Kazumasa Utashiro

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.