.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Locale::Maketext::Utils::Phrase::Norm::Grapheme 3"
.TH Locale::Maketext::Utils::Phrase::Norm::Grapheme 3 "2014-11-18" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "Normalization"
.IX Header "Normalization"
Graphemes are not very human readable and require interpolation, we can avoid both issues by not using them!
.SS "Rationale"
.IX Subsection "Rationale"
This helps give consistency, clarity, and simplicity.
.PP
If we parse a string and find 'Commencing compilation \exe2\ex80\exa6' then we have to interpolate that string into 'Commencing compilation …' before we can look it up to see if it exists in a hash.
.PP
Graphemes also add a layer of complexity that hinders translators and thus makes room for lower quality translations.
.PP
Developers have it slightly better in that they’ll recognize it but it still requires effort to figure out what it is exactly and to determine what sequence they need for a given character.
.PP
You can simply use the character itself or a bracket notation method for the handful of markup related or visually special characters
.SH "possible violations"
.IX Header "possible violations"
If you get false positives then that only goes to help highlight how ambiguity adds to the reason to avoid non-bytes strings!
.IP "Contains grapheme notation" 4
.IX Item "Contains grapheme notation"
A sequence of \exe2\ex98\exba\exe2\ex80\exa6 will be replaced w/ [comment,grapheme “\exe2\ex98\exba\exe2\ex80\exa6”]
.SH "possible warnings"
.IX Header "possible warnings"
None
.SH "Entire filter only runs under extra filter"
.IX Header "Entire filter only runs under extra filter"
See \*(L"extra filters\*(R" in Locale::Maketext::Utils::Phrase::Norm for more details.