.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 >0, 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 "WrapI18N 3"
.TH WrapI18N 3 2024-07-13 "perl v5.38.2" "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 NAME
Text::WrapI18N \- Line wrapping module with support for multibyte, fullwidth,
and combining characters and languages without whitespaces between words
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\&  use Text::WrapI18N qw(wrap $columns);
\&  wrap(firstheader, nextheader, texts);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module intends to be a better Text::Wrap module.  
This module is needed to support multibyte character encodings such
as UTF\-8, EUC-JP, EUC-KR, GB2312, and Big5.  This module also supports
characters with irregular widths, such as combining characters (which
occupy zero columns on terminal, like diacritical marks in UTF\-8) and
fullwidth characters (which occupy two columns on terminal, like most
of east Asian characters).  Also, minimal handling of languages which
doesn't use whitespaces between words (like Chinese and Japanese) is
supported.
.PP
Like Text::Wrap, hyphenation and "kinsoku" processing are not supported,
to keep simplicity.
.PP
\&\fIwrap(firstheader, nextheader, texts)\fR is the main subroutine of
Text::WrapI18N module to execute the line wrapping.  Input parameters
and output data emulate Text::Wrap.  The texts have to be written in
locale encoding.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBlocale\fR\|(5), \fButf\-8\fR\|(7), \fBcharsets\fR\|(7)
.SH AUTHOR
.IX Header "AUTHOR"
Tomohiro KUBOTA, <kubota@debian.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright 2003 by Tomohiro KUBOTA
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.