.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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.  | will give a
.\" real vertical bar.  \*(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-|\(bv\*(Tr
.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" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "804delta 3"
.TH 804delta 3 "2007-02-11" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Tk::804delta \- what is new for perl/Tk 804
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This document describes differences between the Tk800 series and the
Tk804 series.
.SH "Incompatible Changes"
.IX Header "Incompatible Changes"
In Tk804.028, there are some additional incompatible changes:
.PP
Return values of some \fBTk::Wm\fR methods (e.g. \fBaspect\fR, \fBwmGrid\fR,
\&\fBiconposition\fR, \fBresizable\fR ...) were changed from returning tclish
lists (e.g. \*(L"1 2 3 4\*(R") to perlish lists (1,2,3,4).
.PP
\&\fBTk::Wm::wmTracing\fR needs argument for setting on/off, without argument
just return the current value.
.PP
All Tk804 releases have the following incompatible changes:
.PP
Tk804 will only work with perl 5.8.0 and above. For older perl
versions look for Tk800.025.
.PP
\&\fBcurselection\fR of \fBTk::Listbox\fR now returns an array reference in
scalar context. This means you have to write
.PP
.Vb 1
\&        my(@selected) = $listbox->curselection
.Ve
.PP
or
.PP
.Vb 1
\&        my(@selected) = @{ $listbox->curselection }
.Ve
.PP
now.
.PP
The \fBfontActual\fR method now returns the pixel value instead of the
point value for \fB\-size\fR. Pixel values are expressed as negative
numbers.
.PP
Some enhancements from the "dash" patches are lost for now
(i.e. \fB\-tile\fR, \fB\-troughtile\fR ...).
.PP
The \fB\-state\fR option is not available anymore for \fBTk::Text\fR tags.
Use \fB\-elide\fR instead.
.SH "Enhancements"
.IX Header "Enhancements"
Tk804 is Unicode\-aware.
.PP
It is possible to build Tk with Xft support on X11. This is strongly
recommened if you are planning to make use of Unicode rendering
capabilities of Tk. It also gives anti-aliased fonts for regular text
(if you have TrueType or Type1 fonts and they are in your fontconfig
config file).
.PP
The new method \fBchooseDirectory\fR is available as a standard directory
selector.
.PP
\&\fBTk::PNG\fR and \fBTk::JPEG\fR are bundled now with the perl/Tk
distribution, providing support for the image formats \fBpng\fR and
\&\fBjpeg\fR.
.PP
Improvements to \fBTk::Listbox\fR: new option \fB\-activestyle\fR, new
methods \fBitemconfigure\fR and \fBitemcget\fR, new virtual event \fB<<ListboxSelect>>\fR.
.PP
More tests.
.SH "New Widgets"
.IX Header "New Widgets"
.IP "Tk::Labelframe" 4
.IX Item "Tk::Labelframe"
An alternative to \fBTk::LabFrame\fR.
.IP "Tk::Panedwindow" 4
.IX Item "Tk::Panedwindow"
An alternative to \fBTk::Adjuster\fR.
.IP "Tk::Spinbox" 4
.IX Item "Tk::Spinbox"
An alternative to the \s-1CPAN\s0 module \fBTk::NumEntry\fR.
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
.SH "Changed Internals"
.IX Header "Changed Internals"
.SH "Platform Specific Problems"
.IX Header "Platform Specific Problems"
.SH "Future Directions"
.IX Header "Future Directions"
.SH "Reporting Bugs"
.IX Header "Reporting Bugs"
If you find what you think is a bug, you might check the articles
recently posted to the comp.lang.perl.tk newsgroup.
.PP
If you believe you have an unreported bug, please send a mail to <ptk@lists.stanford.edu> and/or <nick@ing\-simmons.net>.  Be sure to trim your bug down
to a tiny but sufficient test case.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Tk, \f(CW\*(C`Changes\*(C'\fR file in the Perl/Tk distribution.