view release on metacpan or  search on metacpan

lib/App/Greple/charcode.pm  view on Meta::CPAN

package App::Greple::charcode;

use 5.024;
use warnings;
use utf8;

our $VERSION = "0.9909";

=encoding utf-8

=head1 NAME

App::Greple::charcode - greple module to annotate unicode character data

=for html <p>
<img width="566" src="https://raw.githubusercontent.com/kaz-utashiro/greple-charcode/refs/heads/main/images/homoglyph.png">
</p>

=head1 SYNOPSIS

  greple -Mcharcode [ module option -- ] [ command option ] ...

    COMMAND OPTION
      --no-annotate  do not print annotation
      --[no-]align   align annotations
      --align-all    align to the same column for all lines
      --align-side   align to the longest line

      PATTERNS
      --composite    find composite character (combining character sequence)
      --precomposed  find precomposed character
      --combined     find both composite and precomposed characters
      --outstand     find --combined and non-ASCII characters
      --dt=type      specify decomposition type
      --surrogate    find character in UTF-16 surrogate pair range
      --outstand     find non-ASCII combining characters
      -p/-P prop     find \p{prop} or \P{prop} characters
      --ansicode     find ANSI terminal control sequences

    MODULE OPTION
       --column[=#]  display column number
      --visible[=#]  display character name
         --char[=#]  display character itself
        --width[=#]  display width
         --utf8[=#]  display UTF-8 encoding
        --utf16[=#]  display UTF-16 encoding
         --code[=#]  display Unicode code point
         --name[=#]  display character name
          --nfd[=#]  display Unicode Normalization Form D
          --nfc[=#]  display Unicode Normalization Form C
         --nfkd[=#]  display Unicode Normalization Form KD
         --nfkc[=#]  display Unicode Normalization Form KC
        --split[=#]  put annotattion for each character
      --alignto[=#]  align annotation to #


      --config KEY[=VALUE],...

  greple -Mcc [ module option -- ] [ command option ] ...

      -Mcc  alias module for -Mcharcode

=head1 VERSION

Version 0.9909

=head1 DESCRIPTION

Greple module C<-Mcharcode> (or C<-Mcc> for short) displays
information about the matched characters.  It can visualize Unicode
zero-width combining or hidden characters, which can be useful for
examining text containing visually indistinguishable or imperceptible
elements.