Pratt 1.5.6

data/pkgs/tile-0.8.2/doc/Makefile

@@ -0,0 +1,36 @@
+#
+# tile/doc/Makefile --
+#
+# Generate TMML from nroff source
+# Generate HTML from TMML
+# 
+
+TMML_DIR	?= /usr/local/lib/tmml
+MAN2TMML	= tclsh $(TMML_DIR)/man2tmml/man2tmml.tcl
+TMML		= tclsh $(TMML_DIR)/tools/tmml.tcl
+
+HTML_DIR	= html
+
+.SUFFIXES: .3 .n .tmml .html
+
+TMML_OPTIONS = --masterDocument=TILE.XML --htmlDirectory=$(HTML_DIR) --quiet=1
+
+TXTFILES	= converting.txt
+
+default : tmml html
+
+tmml ::
+	-mkdir -p xml 
+	$(MAN2TMML) -rebuild -directory xml -extension .tmml
+
+html ::
+	-mkdir -p $(HTML_DIR)
+	$(TMML) makemap $(TMML_OPTIONS) ; mv INDEX.MAP xml
+	$(TMML) tohtml xml/*.tmml $(TMML_OPTIONS)
+	$(TMML) navpages $(TMML_OPTIONS)
+	for file in $(TXTFILES) ; do cp $$file $(HTML_DIR) ; done
+
+
+clean ::
+	-rm $(HTML_DIR)/*.*
+	-rm xml/*.*

data/pkgs/tile-0.8.2/doc/TILE.XML

@@ -0,0 +1,45 @@
+<manual package="tile" version="0.7">
+<title>Tile package reference</title>
+
+<division>
+<title>Tcl commands</title>
+<subdoc href="xml/tile-intro.tmml" />
+<subdoc href="xml/widget.tmml"/>
+<subdoc href="xml/style.tmml" />
+<subdoc href="xml/image.tmml"/>
+</division>
+
+<division>
+<title>Widgets</title>
+<subdoc href="xml/button.tmml"/>
+<subdoc href="xml/checkbutton.tmml"/>
+<subdoc href="xml/combobox.tmml"/>
+<subdoc href="xml/dialog.tmml"/>
+<subdoc href="xml/entry.tmml"/>
+<subdoc href="xml/frame.tmml"/>
+<subdoc href="xml/label.tmml"/>
+<subdoc href="xml/labelframe.tmml"/>
+<subdoc href="xml/menubutton.tmml"/>
+<subdoc href="xml/notebook.tmml"/>
+<subdoc href="xml/paned.tmml"/>
+<subdoc href="xml/progressbar.tmml"/>
+<subdoc href="xml/radiobutton.tmml"/>
+<subdoc href="xml/scrollbar.tmml"/>
+<subdoc href="xml/separator.tmml"/>
+<subdoc href="xml/sizegrip.tmml"/>
+<subdoc href="xml/treeview.tmml"/>
+</division>
+
+<division>
+<title>C API</title>
+<subdoc href="xml/Geometry.tmml"/>
+<subdoc href="xml/Theme.tmml"/>
+</division>
+
+<division>
+<title>Miscellaneous</title>
+<extref href="converting.txt" type="text/plain"
+    title = "Converting existing applications to use the Tile widgets" />
+</division>
+
+</manual>

data/pkgs/tile-0.8.2/doc/Theme.3

@@ -0,0 +1,34 @@
+'\"
+'\" Copyright (c) 2003 Joe English
+'\"
+'\" See the file "license.terms" for information on usage and redistribution
+'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
+'\" 
+'\" RCS: @(#) Theme.3,v 1.4 2004/12/11 00:36:36 jenglish Exp
+'\" 
+.so man.macros
+.TH Ttk_CreateTheme 3 0.2 tile "Tile Widget Set"
+.BS
+.SH NAME
+Ttk_CreateTheme, Ttk_GetTheme, Ttk_GetDefaultTheme, Ttk_GetCurrentTheme \- create and use Themes.
+.SH SYNOPSIS
+.nf
+Ttk_Theme Ttk_CreateTheme(\fIinterp\fR, \fIname\fR, \fIparentTheme\fR);
+Ttk_Theme Ttk_GetTheme(\fIinterp\fR, \fIname\fR);
+Ttk_Theme Ttk_GetDefaultTheme(\fIinterp\fR);
+Ttk_Theme Ttk_GetCurrentTheme(\fIinterp\fR);
+.fi
+.SH ARGUMENTS
+.AP "Tcl_Interp *" interp in
+The Tcl interpreter in which to register/query available themes.
+.AP "Ttk_Theme" parentTheme in
+Fallback or parent theme from which the new theme will
+inherit elements and layouts.
+.AP "const char *" name in
+The name of the theme.
+.BE
+.SH DESCRIPTION
+
+.SH "SEE ALSO"
+Ttk_RegisterLayout, Ttk_BuildLayout
+.\" .SH KEYWORDS

data/pkgs/tile-0.8.2/doc/button.n

@@ -0,0 +1,75 @@
+'\"
+'\" Copyright (c) 2004 Joe English
+'\"
+.so man.macros
+.TH button n 0.2 tile "Tile Widget Set"
+.BS
+.SH NAME
+ttk::button \- Widget that issues a command when pressed
+.SH SYNOPSIS
+\fBttk::button\fR \fIpathName \fR?\fIoptions\fR?
+.BE
+.SH DESCRIPTION
+A \fBbutton\fR widget displays a textual label and/or image,
+and evaluates a command when pressed.
+.SO
+\-class	\-compound	\-cursor	\-image
+\-state	\-style	\-takefocus	\-text	
+\-textvariable	\-underline	\-width
+.SE
+.SH "OPTIONS"
+.OP \-command command Command
+A script to evaluate when the widget is invoked.
+.OP \-default default Default
+May be set to one of  \fBnormal\fR, \fBactive\fR, or \fBdisabled\fR.
+In a dialog box, one button may be designated the "default" button
+(meaning, roughly, "the one that gets invoked when the user presses <Enter>").
+\fBactive\fR indicates that this is currently the default button;
+\fBnormal\fR means that it may become the default button, and
+\fBdisabled\fR means that it is not defaultable.
+The default is \fBnormal\fR.
+.br
+Depending on the theme, the default button may be displayed 
+with an extra highlight ring, or with a different border color.
+See also: \fIkeynav(n)\fR.
+.OP \-width width Width
+If greater than zero, specifies how much space, in character widths, 
+to allocate for the text label.  
+If less than zero, specifies a minimum width.
+If zero or unspecified, the natural width of the text label is used.
+Note that some themes may specify a non-zero \fB-width\fR
+in the style.
+'\" Not documented -- may go away
+'\" .OP \-padding padding Padding
+'\" .OP \-foreground foreground Foreground
+'\" .OP \-font font Font
+'\" .OP \-anchor anchor Anchor
+'\" .OP \-padding padding Padding
+'\" .OP \-relief relief Relief
+
+.SH "WIDGET COMMAND"
+.TP
+\fIpathName \fBinvoke\fR
+Invokes the command associated with the button.
+.TP
+\fIpathName \fBcget\fR \fIoption\fR
+.TP
+\fIpathName \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
+.TP
+\fIpathName \fBinstate \fIstatespec\fR ?\fIscript\fR?
+.TP
+\fIpathName \fBstate\fR ?\fIstateSpec\fR?
+See \fIwidget(n)\fR
+
+.SH "COMPATIBILITY OPTIONS"
+.OP \-state state State
+May be set to \fBnormal\fR or \fBdisabled\fR
+to control the \fBdisabled\fR state bit.
+This is a ``write-only'' option: setting it changes the
+widget state, but the \fBstate\fR widget command does
+not affect the state option.
+
+.SH "SEE ALSO"
+widget(n), keynav(n)
+.SH "KEYWORDS"
+widget, button, default, command

data/pkgs/tile-0.8.2/doc/checkbutton.n

@@ -0,0 +1,61 @@
+'\"
+'\" Copyright (c) 2004 Joe English
+'\"
+.so man.macros
+.TH checkbutton n 0.2 tile "Tile Widget Set"
+.BS
+.SH NAME
+ttk::checkbutton \- On/off widget
+.SH SYNOPSIS
+\fBttk::checkbutton\fR \fIpathName \fR?\fIoptions\fR?
+.BE
+.SH DESCRIPTION
+A \fBcheckbutton\fR widget is used to show or change a setting.
+It has two states, selected and deselected.  
+The state of the checkbutton may be linked to a Tcl variable.
+.SO
+\-class	\-compound	\-cursor	\-image
+\-state	\-style	\-takefocus	\-text
+\-textvariable	\-underline	\-width
+.SE
+.SH "OPTIONS"
+.OP \-command command Command
+A Tcl script to execute whenever the widget is invoked.
+.OP \-offvalue offValue OffValue
+The value to store in the associated \fI-variable\fR 
+when the widget is deselected.  Defaults to \fB0\fR.
+.OP \-onvalue onValue OnValue
+The value to store in the associated \fI-variable\fR 
+when the widget is selected.  Defaults to \fB1\fR.
+.OP \-variable variable Variable
+The name of a global variable whose value is linked to the widget.
+Defaults to the widget pathname if not specified.
+.SH "WIDGET COMMAND"
+In addition to the standard 
+\fBcget\fR, \fBconfigure\fR, \fBinstate\fR, and \fBstate\fR 
+commands, checkbuttons support the following additional
+widget commands:
+.TP
+\fIpathname\fR invoke
+Toggles between the selected and deselected states
+and evaluates the associated \fI-command\fR.
+If the widget is currently selected, sets the \fI-variable\fR
+to the \fI-offvalue\fR and deselects the widget;
+otherwise, sets the \fI-variable\fR to the \fI-onvalue\fR
+Returns the result of the \fI-command\fR.
+.\" Missing: select, deselect, toggle 
+.\" Are these useful?  They don't invoke the -command
+.\" Missing: flash.  This is definitely not useful.
+.SH "WIDGET STATES"
+The widget does not respond to user input if the \fBdisabled\fR state is set.
+The widget sets the \fBselected\fR state whenever 
+the linked \fB-variable\fR is set to the widget's \fB-onvalue\fR,
+and clears it otherwise.
+The widget sets the \fBalternate\fR state whenever the 
+linked \fB-variable\fR is unset.  
+(The \fBalternate\fR state may be used to indicate a ``tri-state'' 
+or ``indeterminate'' selection.)
+.SH "SEE ALSO"
+widget(n), keynav(n), radiobutton(n)
+.SH "KEYWORDS"
+widget, button, toggle, check, option

data/pkgs/tile-0.8.2/doc/combobox.n

@@ -0,0 +1,98 @@
+'\"
+'\" Copyright (c) 2004 Joe English
+'\"
+.so man.macros
+.TH combobox n 0.4 tile "Tile Widget Set"
+.BS
+.SH NAME
+ttk::combobox \- text field with popdown selection list
+.SH SYNOPSIS
+\fBttk::combobox\fR \fIpathName \fR?\fIoptions\fR?
+.SO
+\-class	\-cursor	\-takefocus	\-style
+.SE
+.\" ALSO: Other entry widget options
+.SH "OPTIONS"
+.OP \-exportselection exportSelection ExportSelection
+Boolean value.
+If set, the widget selection is linked to the X selection.
+.OP \-justify justify Justify
+Specifies how the text is aligned within the widget.
+One of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
+.OP \-height height Height
+Specifies the height of the pop-down listbox, in rows.
+.OP \-postcommand postCommand PostCommand
+A Tcl script to evaluate immediately before displaying the listbox.
+The \fB-postcommand\fR script may specify the \fB-values\fR to display.
+.OP \-state state State
+One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR.
+In the \fBreadonly\fR state,
+the value may not be edited directly, and 
+the user can only select one of the \fB-values\fR from the
+dropdown list.
+In the \fBnormal\fR state, 
+the text field is directly editable.
+In the \fBdisabled\fR state, no interaction is possible.
+.OP \-textvariable textVariable TextVariable
+Specifies the name of a variable whose value is linked 
+to the widget value.
+Whenever the variable changes value the widget value is updated,
+and vice versa.
+.OP \-values values Values
+Specifies the list of values to display in the drop-down listbox.
+.OP \-width width Width
+Specifies an integer value indicating the desired width of the entry window,
+in average-size characters of the widget's font.
+.BE
+.SH DESCRIPTION
+A combobox combines a text field with a pop-down list of values;
+the user may select the value of the text field from among the 
+values in the list.
+.SH "WIDGET COMMAND"
+.TP
+\fIpathName \fBcget\fR \fIoption\fR
+Returns the current value of the specified \fIoption\fR.
+See \fIwidget(n)\fR.
+.TP
+\fIpathName \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
+Modify or query widget options.
+See \fIwidget(n)\fR.
+.TP
+\fIpathName \fBcurrent\fR ?\fInewIndex\fR?
+If \fInewIndex\fR is supplied, sets the combobox value 
+to the element at position \fInewIndex\fR in the list of \fB-values\fR.
+Otherwise, returns the index of the current value in the list of \fB-values\fR
+or \fB-1\fR if the current value does not appear in the list.
+.TP
+\fIpathName \fBget\fR
+Returns the current value of the combobox.
+.TP
+\fIpathName \fBidentify \fIx y\fR
+Returns the name of the element at position \fIx\fR, \fIy\fR,
+or the empty string if the coordinates are outside the window.
+.TP
+\fIpathName \fBinstate \fIstatespec\fR ?\fIscript\fR?
+Test the widget state.
+See \fIwidget(n)\fR.
+.TP
+\fIpathName \fBset\fR \fIvalue\fR
+Sets the value of the combobox to \fIvalue\fR.
+.TP
+\fIpathName \fBstate\fR ?\fIstateSpec\fR?
+Modify or query the widget state.
+See \fIwidget(n)\fR.
+.PP
+The combobox widget also supports the following \fIentry\fR
+widget commands (see \fIentry(n)\fR for details):
+.DS
+.ta 5.5c 11c
+bbox	delete	icursor
+index	insert	selection
+xview
+.DE
+.SH "VIRTUAL EVENTS"
+The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event
+when the user selects an element from the list of values.
+This event is generated after the listbox is unposted.
+.SH "SEE ALSO"
+widget(n), entry(n)

data/pkgs/tile-0.8.2/doc/converting.txt

@@ -0,0 +1,97 @@
+
+converting.txt,v 1.5 2004/12/28 21:00:35 jenglish Exp
+
+[14 Feb 2004]
+
+~ Converting existing applications to use the Tile widgets
+
+Note that the Tile widget set is not a 100%-compatible drop-in
+replacement for the standard Tk widgets.  The main difference
+is that all the state-dependent options like -activebackground,
+-disabledforeground, and -overrelief are not present, replaced by the
+general-purpose style mechanism.  Many appearance-related options
+like -borderwidth and -background are also missing.
+
+Applications that rely on the option database for customization
+will be easier to adapt than those that set resources on
+widgets directly.  In the 0.3 release all options supported
+in Tk 8.4 are present, so they can be set and queried without
+raising an error, but their values will be ignored.
+
+If you're feeling adventurous, you can try:
+
+    namespace import ttk::*
+
+in your application's namespace(s) to locally override all
+the widget construction commands (button, scrollbar, etc).
+Or, you can switch on a widget-by-widget basis by using
+"ttk::button" for "button", "ttk::scrollbar" for "scrollbar", and
+so forth.
+
+IMPORTANT NOTE: Previous versions of this document suggested
+using 'namespace import -force ttk::*' at global scope, for the
+really adventurous.  This is now considered a Really Bad Idea:
+it will cause many things to break, and will cause more things
+to break in the future.  So don't do that anymore.
+
+
+Other differences: 
+
+The -state option has also been replaced by "state"
+and "instate" widget commands (see widget.n).  Some
+widgets do have a "-state" option for compatibility
+purposes, although only "-state normal" and "-state disabled"
+are supported, and it's a "write-only" option -- if
+you disable a widget with [$w state disabled], that
+won't be reflected by [$w cget -state].
+
+The -padx and -pady options have been merged into a 
+single "-padding" option, which may be a list of
+up to four values specifying padding on the left, top,
+right, and bottom.
+
+Some widget subcommands are not implemented yet,
+and others (like [scrollbar identify]) work differently.
+
+The -indicatoron option for checkbuttons and radiobuttons
+is no longer supported.  For toolbar-style buttons, 
+use "-style Toolbar" instead.  (See demos/toolbutton.tcl
+for an explanation.)
+
+The tile [menubutton] widget is *not* designed to be used
+inside a menubar by default, only as a standalone widget.  
+If you're still using menubuttons in a frame to build menubars, 
+switch to Tk [menu]s, or use a custom style.
+
+The -container option for frames is gone.  This will eventually
+be replaced with a special-purpose container widget,
+which uses the XEmbed protocol.  Similarly, the -in option 
+on toplevels will be replaced with a special-purpose "embeddable" 
+widget.
+
+The -colormap and -visual frame options are gone.  (If anyone
+really needs these, please let me know.  It will make *everything*
+a lot simpler if these can be eliminated altogether.)
+
+The -anchor option for checkbuttons, radiobuttons, and buttons
+is ignored.  Again, if anyone has a use for anything other than 
+"-anchor w" for checkbuttons or "-anchor center" for buttons, 
+please let me know.
+
+There are probably some important widget options and commands
+still unimplemented.  (Known cases: select, deselect, and toggle 
+for checkbuttons, a few others).
+
+For buttons, labels, etc., the '-width' option always specifies
+the width in characters to allocate for the text string.
+(In Tk, it's either a width in characters, or in screen units,
+depending on the value of '-compound', for the entire button.)
+Additionally: negative widths specify a minimum size on all
+platforms, not just Windows.
+
+Two new values for the "-compound" option are available:
+"text" (display text only) and "image" (display image only).
+This is useful for configuring toolbars.
+
+The -bitmap option is not supported.  Use -image instead.
+