.\" 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::EndPunc 3"
.TH Locale::Maketext::Utils::Phrase::Norm::EndPunc 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"
We want to make sure phrases end correctly and consistently.
.SS "Rationale"
.IX Subsection "Rationale"
Correct punctuation makes the meaning clearer to end users.
.PP
Clearer meaning makes it easier to make a good translation.
.PP
Consistent punctuation makes it easier for developers to work with.
.PP
Consistent punctuation is a sign of higher quality product.
.PP
Missing punctuation is a sign that partial phrases are in use or an error has been made.
.SH "IF YOU USE THIS FILTER ALSO USE …"
.IX Header "IF YOU USE THIS FILTER ALSO USE …"
… \s-1THIS FILTER \s0Locale::Maketext::Utils::Phrase::Norm::Whitespace.
.PP
This is not enforced anywhere since we want to assume the coder knows what they are doing.
.SH "possible violations"
.IX Header "possible violations"
None
.SH "possible warnings"
.IX Header "possible warnings"
.IP "Non title/label does not end with some sort of punctuation or bracket notation." 4
.IX Item "Non title/label does not end with some sort of punctuation or bracket notation."
Problem should be self explanatory. Ending punctuation is not !, ?, ., :, bracket notation, or an ellipsis character.
.Sp
If it is legit you could address this by adding a [comment] to the end for clarity and to make it harder to use as a partial phrase.
.Sp
.Vb 1
\&   For some reason I must not end well[comment,no puncuation because …]
.Ve
.Sp
If it is titlecase and it has word longer than 2 characters that must start with a lower case letter you have 2 options:
.RS 4
.IP "1 use \fIasis()\fR" 4
.IX Item "1 use asis()"
.Vb 1
\&    Buy [asis,aCme™] Products
.Ve
.IP "2 use \fIcomment()\fR with a comment that does not have a space or a non-break space:" 4
.IX Item "2 use comment() with a comment that does not have a space or a non-break space:"
.Vb 1
\&    People [comment,this\-has\-to\-start\-with\-lowercase\-because\-…]for Love
.Ve
.RE
.RS 4
.RE
.SH "Entire filter only runs under extra filter mode."
.IX Header "Entire filter only runs under extra filter mode."
See \*(L"extra filters\*(R" in Locale::Maketext::Utils::Phrase::Norm for more details.