Initial commit of OpenSPARC T2 design and verification files.

[OpenSPARC-T2-DV] / tools / perl-5.8.0 / man / man3 / Tk::Reindex.3

.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\"
.\" 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 "Reindex 3"
.TH Reindex 3 "2000-12-30" "Tk1.1" "perl/Tk Documentation"
.SH "NAME"
Tk::Reindex \- change the base index of Text\-like widgets
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&    use Tk::ReindexedText;
\&    $t1=$w->ReindexedText(-linestart => 2);
.Ve
.PP
.Vb 2
\&    use Tk::ReindexedROText;
\&    $t2=$w->ReindexedROText(-linestart => 0);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Creates a new widget class based on \fBText\fR\-like widgets that can
redefine the line number base (normally \fBText\fR widgets start line
numbers at 1), or possibly other manipulations on indexes.
.SH "STANDARD OPTIONS"
.IX Header "STANDARD OPTIONS"
The newly-defined widget takes all the same options as the base
widget, which defaults to \fBText\fR.
.SH "WIDGET-SPECIFIC OPTIONS"
.IX Header "WIDGET-SPECIFIC OPTIONS"
.RE
.IP "Name:   \fBlineStart\fR"
.IX Item "Name:   lineStart"
.RE
.PD 0
.IP "Class:  \fBLineStart\fR"
.IX Item "Class:  LineStart"
.RE
.IP "Switch: \fB\-linestart\fR"
.IX Item "Switch: -linestart"
.PD
Sets the line number of the first line in the \fBText\fR widget. The
default \fB\-toindexcmd\fR and \fB\-fromindexcmd\fR use this configuration
option.
.PP
\&\-item Name:   \fBtoIndexCmd\fR  \fBfromIndexCmd\fR
.PP
\&\-item Class:  \fBToIndexCmd\fR  \fBFromIndexCmd\fR
.PP
\&\-item Switch: \fB\-toindexcmd\fR \fB\-fromindexcmd\fR
.PP
These two options specify callbacks that are called with a list of
indexes and are responsible for translating them to/from indexes that
the base \fBText\fR widget can understand. The callback is passed the
widget followed by a list of indexes, and should return a list of
translated indexes. \fB\-toindexcmd\fR should translate from 'user'
indexes to 'native' \fBText\fR\-compatible indexes, and \fB\-fromindexcmd\fR
should translate from 'native' indexes to 'user' indexes.
.PP
The default callbacks simply add/subtract the offset given by the
\&\fB\-linestart\fR option for all indexes in 'line.character' format.
.PP
It would probably be prudent to make these functions inverses of each
other.
.SH "CLASS METHODS"
.IX Header "CLASS METHODS"
.RE
.IP "import"
.IX Item "import"
To make new Reindex widgets, this function should be called via \fBuse\fR
with the name of the Text-like base class that you are extending with
\&\*(L"Reindex\*(R" capability.  'use base(Tk::Reindex Tk::nameofbasewidget)'
should also be specified for that widget.
.SH "BUGS"
.IX Header "BUGS"
I've used the word \*(L"indexes\*(R" instead of \*(L"indices\*(R" throughout the
documentation.
.PP
All the built-in perl code for widget bindings & methods will use the
new 'user' indexes.  Which means all this index manipulation might
might break code that is trying to parse/manipulate indexes. Or even
assume that '1.0' is the beginning index.  \fBTk::Text::Contents\fR comes
to mind.
.SH "AUTHOR"
.IX Header "AUTHOR"
Andrew Allen <ada@fc.hp.com>
.PP
This code may be distributed under the same conditions as Perl.