RubyGems - arcadia - Versions diffs - 0.1.1 → 0.1.2 - Mend

arcadia 0.1.1 → 0.1.2

Files changed (167) hide show

data/README +126 -123
data/arcadia.rb +770 -756
data/base/a-contracts.rb +130 -93
data/base/a-ext.rb +280 -280
data/base/a-libs.rb +5 -11
data/base/a-utils.rb +235 -44
data/conf/arcadia.conf +20 -16
data/conf/arcadia.init.rb +0 -0
data/conf/arcadia.res.rb +74 -0
data/ext/ae-complete-code/ae-complete-code.conf +0 -0
data/ext/ae-complete-code/ae-complete-code.rb +80 -79
data/ext/ae-debug/ae-debug.conf +0 -0
data/ext/ae-debug/ae-debug.rb +2 -6
data/ext/ae-debug/debug1.57.rb +0 -0
data/ext/ae-doc-code/ae-doc-code.conf +15 -0
data/ext/ae-doc-code/ae-doc-code.rb +289 -0
data/ext/ae-editor/ae-editor.conf +17 -8
data/ext/ae-editor/ae-editor.rb +738 -396
data/ext/ae-event-log/ae-event-log.conf +0 -0
data/ext/ae-event-log/ae-event-log.rb +0 -0
data/ext/ae-file-history/ae-file-history.conf +2 -2
data/ext/ae-file-history/ae-file-history.rb +286 -290
data/ext/ae-inspector/ae-inspector.conf +0 -0
data/ext/ae-inspector/ae-inspector.rb +0 -0
data/ext/ae-output-event/ae-output-event.conf +2 -2
data/ext/ae-output/ae-output.conf +2 -2
data/ext/ae-output/ae-output.rb +173 -178
data/ext/ae-palette/ae-palette.conf +0 -0
data/ext/ae-palette/ae-palette.rb +0 -0
data/ext/ae-shell/ae-shell.conf +0 -0
data/ext/ae-shell/ae-shell.rb +54 -54
data/lib/tk/al-tk.rb +3076 -3082
data/lib/tk/al-tk.res.rb +0 -0
data/lib/tk/al-tkarcadia.rb +0 -0
data/lib/tk/al-tkcustom.rb +0 -0
data/lib/tkext/al-bwidget.rb +0 -0
data/lib/tkext/al-iwidgets.rb +0 -0
data/lib/tkext/al-tile.rb +0 -0
data/lib/tkext/al-tktable.rb +0 -0
data/tcl/BWidget-1.8.0/BWman/ArrowButton.html +276 -0
data/tcl/BWidget-1.8.0/BWman/BWidget.html +228 -0
data/tcl/BWidget-1.8.0/BWman/Button.html +273 -0
data/tcl/BWidget-1.8.0/BWman/ButtonBox.html +264 -0
data/tcl/BWidget-1.8.0/BWman/ComboBox.html +402 -0
data/tcl/BWidget-1.8.0/BWman/Dialog.html +314 -0
data/tcl/BWidget-1.8.0/BWman/DragSite.html +139 -0
data/tcl/BWidget-1.8.0/BWman/DropSite.html +254 -0
data/tcl/BWidget-1.8.0/BWman/DynamicHelp.html +248 -0
data/tcl/BWidget-1.8.0/BWman/Entry.html +341 -0
data/tcl/BWidget-1.8.0/BWman/Label.html +331 -0
data/tcl/BWidget-1.8.0/BWman/LabelEntry.html +194 -0
data/tcl/BWidget-1.8.0/BWman/LabelFrame.html +144 -0
data/tcl/BWidget-1.8.0/BWman/ListBox.html +678 -0
data/tcl/BWidget-1.8.0/BWman/MainFrame.html +283 -0
data/tcl/BWidget-1.8.0/BWman/MessageDlg.html +218 -0
data/tcl/BWidget-1.8.0/BWman/NoteBook.html +374 -0
data/tcl/BWidget-1.8.0/BWman/PagesManager.html +180 -0
data/tcl/BWidget-1.8.0/BWman/PanedWindow.html +142 -0
data/tcl/BWidget-1.8.0/BWman/PanelFrame.html +153 -0
data/tcl/BWidget-1.8.0/BWman/PasswdDlg.html +214 -0
data/tcl/BWidget-1.8.0/BWman/ProgressBar.html +152 -0
data/tcl/BWidget-1.8.0/BWman/ProgressDlg.html +145 -0
data/tcl/BWidget-1.8.0/BWman/ScrollView.html +130 -0
data/tcl/BWidget-1.8.0/BWman/ScrollableFrame.html +191 -0
data/tcl/BWidget-1.8.0/BWman/ScrolledWindow.html +116 -0
data/tcl/BWidget-1.8.0/BWman/SelectColor.html +164 -0
data/tcl/BWidget-1.8.0/BWman/SelectFont.html +152 -0
data/tcl/BWidget-1.8.0/BWman/Separator.html +77 -0
data/tcl/BWidget-1.8.0/BWman/SpinBox.html +250 -0
data/tcl/BWidget-1.8.0/BWman/StatusBar.html +147 -0
data/tcl/BWidget-1.8.0/BWman/TitleFrame.html +107 -0
data/tcl/BWidget-1.8.0/BWman/Tree.html +947 -0
data/tcl/BWidget-1.8.0/BWman/Widget.html +502 -0
data/tcl/BWidget-1.8.0/BWman/contents.html +84 -0
data/tcl/BWidget-1.8.0/BWman/index.html +7 -0
data/tcl/BWidget-1.8.0/BWman/navtree.html +41 -0
data/tcl/BWidget-1.8.0/BWman/options.htm +458 -0
data/tcl/BWidget-1.8.0/CHANGES.txt +266 -0
data/tcl/BWidget-1.8.0/ChangeLog +1641 -0
data/tcl/BWidget-1.8.0/LICENSE.txt +41 -0
data/tcl/BWidget-1.8.0/README.txt +127 -0
data/tcl/BWidget-1.8.0/arrow.tcl +551 -0
data/tcl/BWidget-1.8.0/bitmap.tcl +94 -0
data/tcl/BWidget-1.8.0/button.tcl +324 -0
data/tcl/BWidget-1.8.0/buttonbox.tcl +403 -0
data/tcl/BWidget-1.8.0/color.tcl +493 -0
data/tcl/BWidget-1.8.0/combobox.tcl +809 -0
data/tcl/BWidget-1.8.0/demo/basic.tcl +199 -0
data/tcl/BWidget-1.8.0/demo/bwidget.xbm +46 -0
data/tcl/BWidget-1.8.0/demo/demo.tcl +212 -0
data/tcl/BWidget-1.8.0/demo/dnd.tcl +42 -0
data/tcl/BWidget-1.8.0/demo/manager.tcl +141 -0
data/tcl/BWidget-1.8.0/demo/select.tcl +59 -0
data/tcl/BWidget-1.8.0/demo/tmpldlg.tcl +214 -0
data/tcl/BWidget-1.8.0/demo/tree.tcl +260 -0
data/tcl/BWidget-1.8.0/demo/x1.xbm +2258 -0
data/tcl/BWidget-1.8.0/dialog.tcl +345 -0
data/tcl/BWidget-1.8.0/dragsite.tcl +197 -0
data/tcl/BWidget-1.8.0/dropsite.tcl +455 -0
data/tcl/BWidget-1.8.0/dynhelp.tcl +625 -0
data/tcl/BWidget-1.8.0/entry.tcl +469 -0
data/tcl/BWidget-1.8.0/font.tcl +566 -0
data/tcl/BWidget-1.8.0/images/bold.gif +0 -0
data/tcl/BWidget-1.8.0/images/copy.gif +0 -0
data/tcl/BWidget-1.8.0/images/cut.gif +0 -0
data/tcl/BWidget-1.8.0/images/dragfile.gif +0 -0
data/tcl/BWidget-1.8.0/images/dragicon.gif +0 -0
data/tcl/BWidget-1.8.0/images/error.gif +0 -0
data/tcl/BWidget-1.8.0/images/file.gif +0 -0
data/tcl/BWidget-1.8.0/images/folder.gif +0 -0
data/tcl/BWidget-1.8.0/images/hourglass.gif +0 -0
data/tcl/BWidget-1.8.0/images/info.gif +0 -0
data/tcl/BWidget-1.8.0/images/italic.gif +0 -0
data/tcl/BWidget-1.8.0/images/minus.xbm +5 -0
data/tcl/BWidget-1.8.0/images/new.gif +0 -0
data/tcl/BWidget-1.8.0/images/opcopy.xbm +5 -0
data/tcl/BWidget-1.8.0/images/open.gif +0 -0
data/tcl/BWidget-1.8.0/images/openfold.gif +0 -0
data/tcl/BWidget-1.8.0/images/oplink.xbm +5 -0
data/tcl/BWidget-1.8.0/images/opmove.xbm +5 -0
data/tcl/BWidget-1.8.0/images/overstrike.gif +0 -0
data/tcl/BWidget-1.8.0/images/palette.gif +0 -0
data/tcl/BWidget-1.8.0/images/passwd.gif +0 -0
data/tcl/BWidget-1.8.0/images/paste.gif +0 -0
data/tcl/BWidget-1.8.0/images/plus.xbm +5 -0
data/tcl/BWidget-1.8.0/images/print.gif +0 -0
data/tcl/BWidget-1.8.0/images/question.gif +0 -0
data/tcl/BWidget-1.8.0/images/redo.gif +0 -0
data/tcl/BWidget-1.8.0/images/save.gif +0 -0
data/tcl/BWidget-1.8.0/images/target.xbm +9 -0
data/tcl/BWidget-1.8.0/images/underline.gif +0 -0
data/tcl/BWidget-1.8.0/images/undo.gif +0 -0
data/tcl/BWidget-1.8.0/images/warning.gif +0 -0
data/tcl/BWidget-1.8.0/init.tcl +40 -0
data/tcl/BWidget-1.8.0/label.tcl +271 -0
data/tcl/BWidget-1.8.0/labelentry.tcl +100 -0
data/tcl/BWidget-1.8.0/labelframe.tcl +160 -0
data/tcl/BWidget-1.8.0/lang/da.rc +52 -0
data/tcl/BWidget-1.8.0/lang/de.rc +52 -0
data/tcl/BWidget-1.8.0/lang/en.rc +52 -0
data/tcl/BWidget-1.8.0/lang/es.rc +53 -0
data/tcl/BWidget-1.8.0/lang/fr.rc +52 -0
data/tcl/BWidget-1.8.0/listbox.tcl +1638 -0
data/tcl/BWidget-1.8.0/mainframe.tcl +711 -0
data/tcl/BWidget-1.8.0/messagedlg.tcl +128 -0
data/tcl/BWidget-1.8.0/notebook.tcl +1164 -0
data/tcl/BWidget-1.8.0/pagesmgr.tcl +294 -0
data/tcl/BWidget-1.8.0/panedw.tcl +381 -0
data/tcl/BWidget-1.8.0/panelframe.tcl +246 -0
data/tcl/BWidget-1.8.0/passwddlg.tcl +178 -0
data/tcl/BWidget-1.8.0/pkgIndex.tcl +47 -0
data/tcl/BWidget-1.8.0/progressbar.tcl +208 -0
data/tcl/BWidget-1.8.0/progressdlg.tcl +87 -0
data/tcl/BWidget-1.8.0/scrollframe.tcl +226 -0
data/tcl/BWidget-1.8.0/scrollview.tcl +254 -0
data/tcl/BWidget-1.8.0/scrollw.tcl +280 -0
data/tcl/BWidget-1.8.0/separator.tcl +75 -0
data/tcl/BWidget-1.8.0/spinbox.tcl +331 -0
data/tcl/BWidget-1.8.0/statusbar.tcl +422 -0
data/tcl/BWidget-1.8.0/tests/entry.test +173 -0
data/tcl/BWidget-1.8.0/titleframe.tcl +170 -0
data/tcl/BWidget-1.8.0/tree.tcl +2228 -0
data/tcl/BWidget-1.8.0/utils.tcl +645 -0
data/tcl/BWidget-1.8.0/widget.tcl +1576 -0
data/tcl/BWidget-1.8.0/wizard.tcl +1028 -0
data/tcl/BWidget-1.8.0/xpm2image.tcl +115 -0
metadata +141 -5

data/tcl/BWidget-1.8.0/BWman/contents.html ADDED

@@ -0,0 +1,84 @@
+<HTML><BODY BGCOLOR=white target=Manual>
+<BR><BR><DT><B>Simple Widgets</B>
+<DD><TABLE BORDER=0 CELLSPACING=0>
+<TR><TD><A HREF="Label.html">Label</A></TD>
+<TD>Label widget with <B>state</B> option, dynamic help and drag and drop facilities</TD></TR>
+<TR><TD><A HREF="Entry.html">Entry</A></TD>
+<TD>Entry widget with <B>state</B> option, dynamic help and drag and drop facilities</TD></TR>
+<TR><TD><A HREF="Button.html">Button</A></TD>
+<TD>Button widget with enhanced options</TD></TR>
+<TR><TD><A HREF="ArrowButton.html">ArrowButton</A></TD>
+<TD>Button widget with an arrow shape.</TD></TR>
+<TR><TD><A HREF="ProgressBar.html">ProgressBar</A></TD>
+<TD>Progress indicator widget</TD></TR>
+<TR><TD><A HREF="ScrollView.html">ScrollView</A></TD>
+<TD>Display the visible area of a scrolled window</TD></TR>
+<TR><TD><A HREF="Separator.html">Separator</A></TD>
+<TD>3D separator widget</TD></TR>
+</TABLE>
+<BR><BR><DT><B>Manager Widgets</B>
+<DD><TABLE BORDER=0 CELLSPACING=0>
+<TR><TD><A HREF="MainFrame.html">MainFrame</A></TD>
+<TD>Manage toplevel with menu, toolbar and statusbar </TD></TR>
+<TR><TD><A HREF="LabelFrame.html">LabelFrame</A></TD>
+<TD>Frame with a Label</TD></TR>
+<TR><TD><A HREF="TitleFrame.html">TitleFrame</A></TD>
+<TD>Frame with a title (consider Tk 8.4+ labelframe instead)</TD></TR>
+<TR><TD><A HREF="PanelFrame.html">PanelFrame</A></TD>
+<TD>Frame with a boxed title area</TD></TR>
+<TR><TD><A HREF="ScrolledWindow.html">ScrolledWindow</A></TD>
+<TD>Generic scrolled widget</TD></TR>
+<TR><TD><A HREF="ScrollableFrame.html">ScrollableFrame</A></TD>
+<TD>Scrollable frame containing widget</TD></TR>
+<TR><TD><A HREF="PanedWindow.html">PanedWindow</A></TD>
+<TD>Tiled layout manager widget (consider Tk 8.4+ panedwindow instead)</TD></TR>
+<TR><TD><A HREF="ButtonBox.html">ButtonBox</A></TD>
+<TD>Set of buttons with horizontal or vertical layout</TD></TR>
+<TR><TD><A HREF="PagesManager.html">PagesManager</A></TD>
+<TD>Pages manager widget</TD></TR>
+<TR><TD><A HREF="NoteBook.html">NoteBook</A></TD>
+<TD>Notebook manager widget</TD></TR>
+<TR><TD><A HREF="Dialog.html">Dialog</A></TD>
+<TD>Dialog abstraction with custom buttons</TD></TR>
+<TR><TD><A HREF="StatusBar.html">StatusBar</A></TD>
+<TD>Status bar widget with resize control</TD></TR>
+</TABLE>
+<BR><BR><DT><B>Composite Widgets</B>
+<DD><TABLE BORDER=0 CELLSPACING=0>
+<TR><TD><A HREF="LabelEntry.html">LabelEntry</A></TD>
+<TD>
+LabelFrame containing an Entry widget.
+</TD></TR>
+<TR><TD><A HREF="ComboBox.html">ComboBox</A></TD>
+<TD>ComboBox widget</TD></TR>
+<TR><TD><A HREF="SpinBox.html">SpinBox</A></TD>
+<TD>SpinBox widget (consider Tk 8.4+ spinbox instead)</TD></TR>
+<TR><TD><A HREF="Tree.html">Tree</A></TD>
+<TD>Tree widget</TD></TR>
+<TR><TD><A HREF="ListBox.html">ListBox</A></TD>
+<TD>ListBox widget</TD></TR>
+<TR><TD><A HREF="MessageDlg.html">MessageDlg</A></TD>
+<TD>Message dialog box</TD></TR>
+<TR><TD><A HREF="ProgressDlg.html">ProgressDlg</A></TD>
+<TD>Progress indicator dialog box</TD></TR>
+<TR><TD><A HREF="PasswdDlg.html">PasswdDlg</A></TD>
+<TD>Login/Password dialog box</TD></TR>
+<TR><TD><A HREF="SelectFont.html">SelectFont</A></TD>
+<TD>Font selection widget</TD></TR>
+<TR><TD><A HREF="SelectColor.html">SelectColor</A></TD>
+<TD>Color selection widget</TD></TR>
+</TABLE>
+<BR><BR><DT><B>Commands Classes</B>
+<DD><TABLE BORDER=0 CELLSPACING=0>
+<TR><TD><A HREF="Widget.html">Widget</A></TD>
+<TD>The Widget base class</TD></TR>
+<TR><TD><A HREF="DynamicHelp.html">DynamicHelp</A></TD>
+<TD>Provide help to Tk widget or BWidget</TD></TR>
+<TR><TD><A HREF="DragSite.html">DragSite</A></TD>
+<TD>Commands set for Drag facilities</TD></TR>
+<TR><TD><A HREF="DropSite.html">DropSite</A></TD>
+<TD>Commands set for Drop facilities</TD></TR>
+<TR><TD><A HREF="BWidget.html">BWidget</A></TD>
+<TD>Description text</TD></TR>
+</TABLE>
+</DD></BODY></HTML>

data/tcl/BWidget-1.8.0/BWman/index.html ADDED

@@ -0,0 +1,7 @@
+<HTML>
+<HEAD><TITLE>BWidget Manual Pages</TITLE></HEAD>
+  <FRAMESET COLS="180,*" BORDER=0>
+    <FRAME SRC=navtree.html NAME="Menu" SCROLLING=AUTO>
+      <FRAME SRC=contents.html NAME="Manual" SCROLLING=AUTO>
+  </FRAMESET>
+</HTML>

data/tcl/BWidget-1.8.0/BWman/navtree.html ADDED

@@ -0,0 +1,41 @@
+<HTML><BODY BGCOLOR=white>
+<FONT SIZE=1><STRONG><A HREF="contents.html" TARGET=Manual>Brief description</A></STRONG></FONT><BR>
+<FONT SIZE=1><STRONG>Simple Widgets</STRONG></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Label.html" TARGET=Manual>Label</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Entry.html" TARGET=Manual>Entry</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Button.html" TARGET=Manual>Button</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ArrowButton.html" TARGET=Manual>ArrowButton</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ProgressBar.html" TARGET=Manual>ProgressBar</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ScrollView.html" TARGET=Manual>ScrollView</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Separator.html" TARGET=Manual>Separator</A></FONT><BR>
+<FONT SIZE=1><STRONG>Manager Widgets</STRONG></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="MainFrame.html" TARGET=Manual>MainFrame</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="LabelFrame.html" TARGET=Manual>LabelFrame</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="TitleFrame.html" TARGET=Manual>TitleFrame</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="PanelFrame.html" TARGET=Manual>PanelFrame</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ScrolledWindow.html" TARGET=Manual>ScrolledWindow</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ScrollableFrame.html" TARGET=Manual>ScrollableFrame</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="PanedWindow.html" TARGET=Manual>PanedWindow</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ButtonBox.html" TARGET=Manual>ButtonBox</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="PagesManager.html" TARGET=Manual>PagesManager</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="NoteBook.html" TARGET=Manual>NoteBook</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Dialog.html" TARGET=Manual>Dialog</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="StatusBar.html" TARGET=Manual>StatusBar</A></FONT><BR>
+<FONT SIZE=1><STRONG>Composite Widgets</STRONG></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="LabelEntry.html" TARGET=Manual>LabelEntry</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ComboBox.html" TARGET=Manual>ComboBox</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="SpinBox.html" TARGET=Manual>SpinBox</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Tree.html" TARGET=Manual>Tree</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ListBox.html" TARGET=Manual>ListBox</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="MessageDlg.html" TARGET=Manual>MessageDlg</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="ProgressDlg.html" TARGET=Manual>ProgressDlg</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="PasswdDlg.html" TARGET=Manual>PasswdDlg</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="SelectFont.html" TARGET=Manual>SelectFont</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="SelectColor.html" TARGET=Manual>SelectColor</A></FONT><BR>
+<FONT SIZE=1><STRONG>Commands Classes</STRONG></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="Widget.html" TARGET=Manual>Widget</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="DynamicHelp.html" TARGET=Manual>DynamicHelp</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="DragSite.html" TARGET=Manual>DragSite</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="DropSite.html" TARGET=Manual>DropSite</A></FONT><BR>
+&nbsp;&nbsp;<FONT SIZE=1><A HREF="BWidget.html" TARGET=Manual>BWidget</A></FONT><BR>
+</BODY></HTML>

data/tcl/BWidget-1.8.0/BWman/options.htm ADDED

@@ -0,0 +1,458 @@
+<HTML><HEAD><TITLE>Tk Built-In Commands - options manual page</TITLE></HEAD>
+<BODY BGCOLOR=white>
+<DL>
+<DD><A HREF="options.htm#M2" NAME="L2">NAME</A>
+<DL><DD>options - Standard options supported by widgets</DL>
+<DD><A HREF="options.htm#M3" NAME="L3">DESCRIPTION</A>
+<DL>
+<DD><A HREF="options.htm#M-activebackground" NAME="L4">-activebackground, activeBackground, Foreground</A>
+<DD><A HREF="options.htm#M-activeborderwidth" NAME="L5">-activeborderwidth, activeBorderWidth, BorderWidth</A>
+<DD><A HREF="options.htm#M-activeforeground" NAME="L6">-activeforeground, activeForeground, Background</A>
+<DD><A HREF="options.htm#M-anchor" NAME="L7">-anchor, anchor, Anchor</A>
+<DD><A HREF="options.htm#M-background" NAME="L8">-background or -bg, background, Background</A>
+<DD><A HREF="options.htm#M-bitmap" NAME="L9">-bitmap, bitmap, Bitmap</A>
+<DD><A HREF="options.htm#M-borderwidth" NAME="L10">-borderwidth or -bd, borderWidth, BorderWidth</A>
+<DD><A HREF="options.htm#M-cursor" NAME="L11">-cursor, cursor, Cursor</A>
+<DD><A HREF="options.htm#M-disabledbackground" NAME="L12">-disabledbackground, disabledBackground, DisabledBackground</A>
+<DD><A HREF="options.htm#M-disabledforeground" NAME="L12">-disabledforeground, disabledForeground, DisabledForeground</A>
+<DD><A HREF="options.htm#M-exportselection" NAME="L13">-exportselection, exportSelection, ExportSelection</A>
+<DD><A HREF="options.htm#M-font" NAME="L14">-font, font, Font</A>
+<DD><A HREF="options.htm#M-foreground" NAME="L15">-foreground or -fg, foreground, Foreground</A>
+<DD><A HREF="options.htm#M-highlightbackground" NAME="L16">-highlightbackground, highlightBackground, HighlightBackground</A>
+<DD><A HREF="options.htm#M-highlightcolor" NAME="L17">-highlightcolor, highlightColor, HighlightColor</A>
+<DD><A HREF="options.htm#M-highlightthickness" NAME="L18">-highlightthickness, highlightThickness, HighlightThickness</A>
+<DD><A HREF="options.htm#M-image" NAME="L19">-image, image, Image</A>
+<DD><A HREF="options.htm#M-insertbackground" NAME="L20">-insertbackground, insertBackground, Foreground</A>
+<DD><A HREF="options.htm#M-insertborderwidth" NAME="L21">-insertborderwidth, insertBorderWidth, BorderWidth</A>
+<DD><A HREF="options.htm#M-insertofftime" NAME="L22">-insertofftime, insertOffTime, OffTime</A>
+<DD><A HREF="options.htm#M-insertontime" NAME="L23">-insertontime, insertOnTime, OnTime</A>
+<DD><A HREF="options.htm#M-insertwidth" NAME="L24">-insertwidth, insertWidth, InsertWidth</A>
+<DD><A HREF="options.htm#M-jump" NAME="L25">-jump, jump, Jump</A>
+<DD><A HREF="options.htm#M-justify" NAME="L26">-justify, justify, Justify</A>
+<DD><A HREF="options.htm#M-orient" NAME="L27">-orient, orient, Orient</A>
+<DD><A HREF="options.htm#M-padx" NAME="L28">-padx, padX, Pad</A>
+<DD><A HREF="options.htm#M-pady" NAME="L29">-pady, padY, Pad</A>
+<DD><A HREF="options.htm#M-relief" NAME="L30">-relief, relief, Relief</A>
+<DD><A HREF="options.htm#M-repeatdelay" NAME="L31">-repeatdelay, repeatDelay, RepeatDelay</A>
+<DD><A HREF="options.htm#M-repeatinterval" NAME="L32">-repeatinterval, repeatInterval, RepeatInterval</A>
+<DD><A HREF="options.htm#M-selectbackground" NAME="L33">-selectbackground, selectBackground, Foreground</A>
+<DD><A HREF="options.htm#M-selectborderwidth" NAME="L34">-selectborderwidth, selectBorderWidth, BorderWidth</A>
+<DD><A HREF="options.htm#M-selectforeground" NAME="L35">-selectforeground, selectForeground, Background</A>
+<DD><A HREF="options.htm#M-setgrid" NAME="L36">-setgrid, setGrid, SetGrid</A>
+<DD><A HREF="options.htm#M-takefocus" NAME="L37">-takefocus, takeFocus, TakeFocus</A>
+<DD><A HREF="options.htm#M-text" NAME="L38">-text, text, Text</A>
+<DD><A HREF="options.htm#M-textvariable" NAME="L39">-textvariable, textVariable, Variable</A>
+<DD><A HREF="options.htm#M-troughcolor" NAME="L40">-troughcolor, troughColor, Background</A>
+<DD><A HREF="options.htm#M-underline" NAME="L41">-underline, underline, Underline</A>
+<DD><A HREF="options.htm#M-wraplength" NAME="L42">-wraplength, wrapLength, WrapLength</A>
+<DD><A HREF="options.htm#M-xscrollcommand" NAME="L43">-xscrollcommand, xScrollCommand, ScrollCommand</A>
+<DD><A HREF="options.htm#M-yscrollcommand" NAME="L44">-yscrollcommand, yScrollCommand, ScrollCommand</A>
+</DL>
+<DD><A HREF="options.htm#M4" NAME="L45">KEYWORDS</A>
+</DL><HR>
+<H3><A NAME="M2">NAME</A></H3>
+options - Standard options supported by widgets
+<H3><A NAME="M3">DESCRIPTION</A></H3>
+This manual entry describes the common configuration options supported
+by widgets in the Tk toolkit.  Every widget does not necessarily support
+every option (see the manual entries for individual widgets for a list
+of the standard options supported by that widget), but if a widget does
+support an option with one of the names listed below, then the option
+has exactly the effect described below.
+<P>
+In the descriptions below, ``Command-Line Name'' refers to the
+switch used in class commands and <B>configure</B> widget commands to
+set this value.  For example, if an option's command-line switch is
+<B>-foreground</B> and there exists a widget <B>.a.b.c</B>, then the
+command
+<PRE><B>.a.b.c  configure  -foreground black</B></PRE>
+may be used to specify the value <B>black</B> for the option in the
+the widget <B>.a.b.c</B>.  Command-line switches may be abbreviated,
+as long as the abbreviation is unambiguous.
+``Database Name'' refers to the option's name in the option database (e.g.
+in .Xdefaults files).  ``Database Class'' refers to the option's class value
+in the option database.
+<DL>
+<DT>Command-Line Name: <B><A NAME="M-activebackground">-activebackground</A></B>
+<DT>Database Name: <B>activeBackground</B>
+<DT>Database Class: <B>Foreground</B>
+<DD>Specifies background color to use when drawing active elements.
+An element (a widget or portion of a widget) is active if the
+mouse cursor is positioned over the element and pressing a mouse button
+will cause some action to occur.
+If strict Motif compliance has been requested by setting the
+<B>tk_strictMotif</B> variable, this option will normally be
+ignored;  the normal background color will be used instead.
+For some elements on Windows and Macintosh systems, the active color
+will only be used while mouse button 1 is pressed over the element.
+<P><DT>Command-Line Name: <B><A NAME="M-activeborderwidth">-activeborderwidth</A></B>
+<DT>Database Name: <B>activeBorderWidth</B>
+<DT>Database Class: <B>BorderWidth</B>
+<DD>Specifies a non-negative value indicating
+the width of the 3-D border drawn around active elements.  See above for
+definition of active elements.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+This option is typically only available in widgets displaying more
+than one element at a time (e.g. menus but not buttons).
+<P><DT>Command-Line Name: <B><A NAME="M-activeforeground">-activeforeground</A></B>
+<DT>Database Name: <B>activeForeground</B>
+<DT>Database Class: <B>Background</B>
+<DD>Specifies foreground color to use when drawing active elements.
+See above for definition of active elements.
+<P><DT>Command-Line Name: <B><A NAME="M-anchor">-anchor</A></B>
+<DT>Database Name: <B>anchor</B>
+<DT>Database Class: <B>Anchor</B>
+<DD>Specifies how the information in a widget (e.g. text or a bitmap)
+is to be displayed in the widget.
+Must be one of the values <B>n</B>, <B>ne</B>, <B>e</B>, <B>se</B>,
+<B>s</B>, <B>sw</B>, <B>w</B>, <B>nw</B>, or <B>center</B>.
+For example, <B>nw</B> means display the information such that its
+top-left corner is at the top-left corner of the widget.
+<P><DT>Command-Line Name: <B><A NAME="M-background">-background or -bg</A></B>
+<DT>Database Name: <B>background</B>
+<DT>Database Class: <B>Background</B>
+<DD>Specifies the normal background color to use when displaying the
+widget.
+<P><DT>Command-Line Name: <B><A NAME="M-bitmap">-bitmap</A></B>
+<DT>Database Name: <B>bitmap</B>
+<DT>Database Class: <B>Bitmap</B>
+<DD>Specifies a bitmap to display in the widget, in any of the forms
+acceptable to <B><A HREF="../TkLib/GetBitmap.htm">Tk_GetBitmap</A></B>.
+The exact way in which the bitmap is displayed may be affected by
+other options such as <B>anchor</B> or <B>justify</B>.
+Typically, if this option is specified then it overrides other
+options that specify a textual value to display in the widget;
+the <B>bitmap</B> option may be reset to an empty string to re-enable
+a text display.
+In widgets that support both <B>bitmap</B> and <B>image</B> options,
+<B>image</B> will usually override <B>bitmap</B>.
+<P><DT>Command-Line Name: <B><A NAME="M-borderwidth">-borderwidth or -bd</A></B>
+<DT>Database Name: <B>borderWidth</B>
+<DT>Database Class: <B>BorderWidth</B>
+<DD>Specifies a non-negative value indicating the width
+of the 3-D border to draw around the outside of the widget (if such a
+border is being drawn;  the <B>relief</B> option typically determines
+this).  The value may also be used when drawing 3-D effects in the
+interior of the widget.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+<P><DT>Command-Line Name: <B><A NAME="M-cursor">-cursor</A></B>
+<DT>Database Name: <B>cursor</B>
+<DT>Database Class: <B>Cursor</B>
+<DD>Specifies the mouse cursor to be used for the widget.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetCursor.htm">Tk_GetCursor</A></B>.
+<P><DT>Command-Line Name: <B><A NAME="M-disabledforeground">-disabledforeground</A></B>
+<P><DT>Command-Line Name: <B><A NAME="M-disabledbackground">-disabledbackground</A></B>
+<DT>Database Name: <B>disabledBackground</B>
+<DT>Database Class: <B>DisabledBackground</B>
+<DD>Specifies background color to use when drawing a disabled element.
+If the option is specified as an empty string (which is typically the
+case on monochrome displays), disabled elements are drawn with the
+normal background color but they are dimmed by drawing them
+with a stippled fill pattern.
+<DT>Database Name: <B>disabledForeground</B>
+<DT>Database Class: <B>DisabledForeground</B>
+<DD>Specifies foreground color to use when drawing a disabled element.
+If the option is specified as an empty string (which is typically the
+case on monochrome displays), disabled elements are drawn with the
+normal foreground color but they are dimmed by drawing them
+with a stippled fill pattern.
+<P><DT>Command-Line Name: <B><A NAME="M-exportselection">-exportselection</A></B>
+<DT>Database Name: <B>exportSelection</B>
+<DT>Database Class: <B>ExportSelection</B>
+<DD>Specifies whether or not a selection in the widget should also be
+the X selection.
+The value may have any of the forms accepted by <B><A HREF="../TclLib/GetInt.htm">Tcl_GetBoolean</A></B>,
+such as <B>true</B>, <B>false</B>, <B>0</B>, <B>1</B>, <B>yes</B>, or <B>no</B>.
+If the selection is exported, then selecting in the widget deselects
+the current X selection, selecting outside the widget deselects any
+widget selection, and the widget will respond to selection retrieval
+requests when it has a selection.  The default is usually for widgets
+to export selections.
+<P><DT>Command-Line Name: <B><A NAME="M-font">-font</A></B>
+<DT>Database Name: <B><A HREF="../TkCmd/font.htm">font</A></B>
+<DT>Database Class: <B><A HREF="../TkCmd/font.htm">Font</A></B>
+<DD>Specifies the font to use when drawing text inside the widget.
+<P><DT>Command-Line Name: <B><A NAME="M-foreground">-foreground or -fg</A></B>
+<DT>Database Name: <B>foreground</B>
+<DT>Database Class: <B>Foreground</B>
+<DD>Specifies the normal foreground color to use when displaying the widget.
+<P><DT>Command-Line Name: <B><A NAME="M-highlightbackground">-highlightbackground</A></B>
+<DT>Database Name: <B>highlightBackground</B>
+<DT>Database Class: <B>HighlightBackground</B>
+<DD>Specifies the color to display in the traversal highlight region when
+the widget does not have the input focus.
+<P><DT>Command-Line Name: <B><A NAME="M-highlightcolor">-highlightcolor</A></B>
+<DT>Database Name: <B>highlightColor</B>
+<DT>Database Class: <B>HighlightColor</B>
+<DD>Specifies the color to use for the traversal highlight rectangle that is
+drawn around the widget when it has the input focus.
+<P><DT>Command-Line Name: <B><A NAME="M-highlightthickness">-highlightthickness</A></B>
+<DT>Database Name: <B>highlightThickness</B>
+<DT>Database Class: <B>HighlightThickness</B>
+<DD>Specifies a non-negative value indicating the width of the highlight
+rectangle to draw around the outside of the widget when it has the
+input focus.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+If the value is zero, no focus highlight is drawn around the widget.
+<P><DT>Command-Line Name: <B><A NAME="M-image">-image</A></B>
+<DT>Database Name: <B>image</B>
+<DT>Database Class: <B>Image</B>
+<DD>Specifies an image to display in the widget, which must have been
+created with the <B><A HREF="../TkCmd/image.htm">image create</A></B> command.
+Typically, if the <B>image</B> option is specified then it overrides other
+options that specify a bitmap or textual value to display in the widget;
+the <B>image</B> option may be reset to an empty string to re-enable
+a bitmap or text display.
+<P><DT>Command-Line Name: <B><A NAME="M-insertbackground">-insertbackground</A></B>
+<DT>Database Name: <B>insertBackground</B>
+<DT>Database Class: <B>Foreground</B>
+<DD>Specifies the color to use as background in the area covered by the
+insertion cursor.  This color will normally override either the normal
+background for the widget (or the selection background if the insertion
+cursor happens to fall in the selection).
+<P><DT>Command-Line Name: <B><A NAME="M-insertborderwidth">-insertborderwidth</A></B>
+<DT>Database Name: <B>insertBorderWidth</B>
+<DT>Database Class: <B>BorderWidth</B>
+<DD>Specifies a non-negative value indicating the width
+of the 3-D border to draw around the insertion cursor.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+<P><DT>Command-Line Name: <B><A NAME="M-insertofftime">-insertofftime</A></B>
+<DT>Database Name: <B>insertOffTime</B>
+<DT>Database Class: <B>OffTime</B>
+<DD>Specifies a non-negative integer value indicating the number of
+milliseconds the insertion cursor should remain ``off'' in each blink cycle.
+If this option is zero then the cursor doesn't blink:  it is on
+all the time.
+<P><DT>Command-Line Name: <B><A NAME="M-insertontime">-insertontime</A></B>
+<DT>Database Name: <B>insertOnTime</B>
+<DT>Database Class: <B>OnTime</B>
+<DD>Specifies a non-negative integer value indicating the number of
+milliseconds the insertion cursor should remain ``on'' in each blink cycle.
+<P><DT>Command-Line Name: <B><A NAME="M-insertwidth">-insertwidth</A></B>
+<DT>Database Name: <B>insertWidth</B>
+<DT>Database Class: <B>InsertWidth</B>
+<DD>Specifies a  value indicating the total width of the insertion cursor.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+If a border has been specified for the insertion
+cursor (using the <B>insertBorderWidth</B> option), the border
+will be drawn inside the width specified by the <B>insertWidth</B>
+option.
+<P><DT>Command-Line Name: <B><A NAME="M-jump">-jump</A></B>
+<DT>Database Name: <B>jump</B>
+<DT>Database Class: <B>Jump</B>
+<DD>For widgets with a slider that can be dragged to adjust a value,
+such as scrollbars, this option determines when
+notifications are made about changes in the value.
+The option's value must be a boolean of the form accepted by
+<B><A HREF="../TclLib/GetInt.htm">Tcl_GetBoolean</A></B>.
+If the value is false, updates are made continuously as the
+slider is dragged.
+If the value is true, updates are delayed until the mouse button
+is released to end the drag;  at that point a single notification
+is made (the value ``jumps'' rather than changing smoothly).
+<P><DT>Command-Line Name: <B><A NAME="M-justify">-justify</A></B>
+<DT>Database Name: <B>justify</B>
+<DT>Database Class: <B>Justify</B>
+<DD>When there are multiple lines of text displayed in a widget, this
+option determines how the lines line up with each other.
+Must be one of <B>left</B>, <B>center</B>, or <B>right</B>.
+<B>Left</B> means that the lines' left edges all line up, <B>center</B>
+means that the lines' centers are aligned, and <B>right</B> means
+that the lines' right edges line up.
+<P><DT>Command-Line Name: <B><A NAME="M-orient">-orient</A></B>
+<DT>Database Name: <B>orient</B>
+<DT>Database Class: <B>Orient</B>
+<DD>For widgets that can lay themselves out with either a horizontal
+or vertical orientation, such as scrollbars, this option specifies
+which orientation should be used.  Must be either <B>horizontal</B>
+or <B>vertical</B> or an abbreviation of one of these.
+<P><DT>Command-Line Name: <B><A NAME="M-padx">-padx</A></B>
+<DT>Database Name: <B>padX</B>
+<DT>Database Class: <B>Pad</B>
+<DD>Specifies a non-negative value indicating how much extra space
+to request for the widget in the X-direction.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+When computing how large a window it needs, the widget will
+add this amount to the width it would normally need (as determined
+by the width of the things displayed in the widget);  if the geometry
+manager can satisfy this request, the widget will end up with extra
+internal space to the left and/or right of what it displays inside.
+Most widgets only use this option for padding text:  if they are
+displaying a bitmap or image, then they usually ignore padding
+options.
+<P><DT>Command-Line Name: <B><A NAME="M-pady">-pady</A></B>
+<DT>Database Name: <B>padY</B>
+<DT>Database Class: <B>Pad</B>
+<DD>Specifies a non-negative value indicating how much extra space
+to request for the widget in the Y-direction.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+When computing how large a window it needs, the widget will add
+this amount to the height it would normally need (as determined by
+the height of the things displayed in the widget);  if the geometry
+manager can satisfy this request, the widget will end up with extra
+internal space above and/or below what it displays inside.
+Most widgets only use this option for padding text:  if they are
+displaying a bitmap or image, then they usually ignore padding
+options.
+<P><DT>Command-Line Name: <B><A NAME="M-relief">-relief</A></B>
+<DT>Database Name: <B>relief</B>
+<DT>Database Class: <B>Relief</B>
+<DD>Specifies the 3-D effect desired for the widget.  Acceptable
+values are <B>raised</B>, <B>sunken</B>, <B>flat</B>, <B>ridge</B>,
+<B>solid</B>, and <B>groove</B>.
+The value
+indicates how the interior of the widget should appear relative
+to its exterior;  for example, <B>raised</B> means the interior of
+the widget should appear to protrude from the screen, relative to
+the exterior of the widget.
+<P><DT>Command-Line Name: <B><A NAME="M-repeatdelay">-repeatdelay</A></B>
+<DT>Database Name: <B>repeatDelay</B>
+<DT>Database Class: <B>RepeatDelay</B>
+<DD>Specifies the number of milliseconds a button or key must be held
+down before it begins to auto-repeat.  Used, for example, on the
+up- and down-arrows in scrollbars.
+<P><DT>Command-Line Name: <B><A NAME="M-repeatinterval">-repeatinterval</A></B>
+<DT>Database Name: <B>repeatInterval</B>
+<DT>Database Class: <B>RepeatInterval</B>
+<DD>Used in conjunction with <B>repeatDelay</B>:  once auto-repeat
+begins, this option determines the number of milliseconds between
+auto-repeats.
+<P><DT>Command-Line Name: <B><A NAME="M-selectbackground">-selectbackground</A></B>
+<DT>Database Name: <B>selectBackground</B>
+<DT>Database Class: <B>Foreground</B>
+<DD>Specifies the background color to use when displaying selected
+items.
+<P><DT>Command-Line Name: <B><A NAME="M-selectborderwidth">-selectborderwidth</A></B>
+<DT>Database Name: <B>selectBorderWidth</B>
+<DT>Database Class: <B>BorderWidth</B>
+<DD>Specifies a non-negative value indicating the width
+of the 3-D border to draw around selected items.
+The value may have any of the forms acceptable to <B><A HREF="../TkLib/GetPixels.htm">Tk_GetPixels</A></B>.
+<P><DT>Command-Line Name: <B><A NAME="M-selectforeground">-selectforeground</A></B>
+<DT>Database Name: <B>selectForeground</B>
+<DT>Database Class: <B>Background</B>
+<DD>Specifies the foreground color to use when displaying selected
+items.
+<P><DT>Command-Line Name: <B><A NAME="M-setgrid">-setgrid</A></B>
+<DT>Database Name: <B>setGrid</B>
+<DT>Database Class: <B>SetGrid</B>
+<DD>Specifies a boolean value that determines whether this widget controls the
+resizing grid for its top-level window.
+This option is typically used in text widgets, where the information
+in the widget has a natural size (the size of a character) and it makes
+sense for the window's dimensions to be integral numbers of these units.
+These natural window sizes form a grid.
+If the <B>setGrid</B> option is set to true then the widget will
+communicate with the window manager so that when the user interactively
+resizes the top-level window that contains the widget, the dimensions of
+the window will be displayed to the user in grid units and the window
+size will be constrained to integral numbers of grid units.
+See the section GRIDDED GEOMETRY MANAGEMENT in the <B><A HREF="../TkCmd/wm.htm">wm</A></B> manual
+entry for more details.
+<P><DT>Command-Line Name: <B><A NAME="M-takefocus">-takefocus</A></B>
+<DT>Database Name: <B>takeFocus</B>
+<DT>Database Class: <B>TakeFocus</B>
+<DD>Determines whether the window accepts the focus during keyboard
+traversal (e.g., Tab and Shift-Tab).
+Before setting the focus to a window, the traversal scripts
+consult the value of the <B>takeFocus</B> option.
+A value of <B>0</B> means that the window should be skipped entirely
+during keyboard traversal.
+<B>1</B> means that the window should receive the input
+focus as long as it is viewable (it and all of its ancestors are mapped).
+An empty value for the option means that the traversal scripts make
+the decision about whether or not to focus on the window:  the current
+algorithm is to skip the window if it is
+disabled, if it has no key bindings, or if it is not viewable.
+If the value has any other form, then the traversal scripts take
+the value, append the name of the window to it (with a separator space),
+and evaluate the resulting string as a Tcl script.
+The script must return <B>0</B>, <B>1</B>, or an empty string:  a
+<B>0</B> or <B>1</B> value specifies whether the window will receive
+the input focus, and an empty string results in the default decision
+described above.
+Note: this interpretation of the option is defined entirely by
+the Tcl scripts that implement traversal:  the widget implementations
+ignore the option entirely, so you can change its meaning if you
+redefine the keyboard traversal scripts.
+<P><DT>Command-Line Name: <B><A NAME="M-text">-text</A></B>
+<DT>Database Name: <B><A HREF="../TkCmd/text.htm">text</A></B>
+<DT>Database Class: <B><A HREF="../TkCmd/text.htm">Text</A></B>
+<DD>Specifies a string to be displayed inside the widget.  The way in which
+the string is displayed depends on the particular widget and may be
+determined by other options, such as <B>anchor</B> or <B>justify</B>.
+<P><DT>Command-Line Name: <B><A NAME="M-textvariable">-textvariable</A></B>
+<DT>Database Name: <B>textVariable</B>
+<DT>Database Class: <B><A HREF="../TclCmd/variable.htm">Variable</A></B>
+<DD>Specifies the name of a variable.  The value of the variable is a text
+string to be displayed inside the widget;  if the variable value changes
+then the widget will automatically update itself to reflect the new value.
+The way in which the string is displayed in the widget depends on the
+particular widget and may be determined by other options, such as
+<B>anchor</B> or <B>justify</B>.
+<P><DT>Command-Line Name: <B><A NAME="M-troughcolor">-troughcolor</A></B>
+<DT>Database Name: <B>troughColor</B>
+<DT>Database Class: <B>Background</B>
+<DD>Specifies the color to use for the rectangular trough areas
+in widgets such as scrollbars and scales.
+<P><DT>Command-Line Name: <B><A NAME="M-underline">-underline</A></B>
+<DT>Database Name: <B>underline</B>
+<DT>Database Class: <B>Underline</B>
+<DD>Specifies the integer index of a character to underline in the widget.
+This option is used by the default bindings to implement keyboard
+traversal for menu buttons and menu entries.
+0 corresponds to the first character of the text displayed in the
+widget, 1 to the next character, and so on.
+<P><DT>Command-Line Name: <B><A NAME="M-wraplength">-wraplength</A></B>
+<DT>Database Name: <B>wrapLength</B>
+<DT>Database Class: <B>WrapLength</B>
+<DD>For widgets that can perform word-wrapping, this option specifies
+the maximum line length.
+Lines that would exceed this length are wrapped onto the next line,
+so that no line is longer than the specified length.
+The value may be specified in any of the standard forms for
+screen distances.
+If this value is less than or equal to 0 then no wrapping is done:  lines
+will break only at newline characters in the text.
+<P><DT>Command-Line Name: <B><A NAME="M-xscrollcommand">-xscrollcommand</A></B>
+<DT>Database Name: <B>xScrollCommand</B>
+<DT>Database Class: <B>ScrollCommand</B>
+<DD>Specifies the prefix for a command used to communicate with horizontal
+scrollbars.
+When the view in the widget's window changes (or
+whenever anything else occurs that could change the display in a
+scrollbar, such as a change in the total size of the widget's
+contents), the widget will
+generate a Tcl command by concatenating the scroll command and
+two numbers.
+Each of the numbers is a fraction between 0 and 1, which indicates
+a position in the document.  0 indicates the beginning of the document,
+1 indicates the end, .333 indicates a position one third the way through
+the document, and so on.
+The first fraction indicates the first information in the document
+that is visible in the window, and the second fraction indicates
+the information just after the last portion that is visible.
+The command is
+then passed to the Tcl interpreter for execution.  Typically the
+<B>xScrollCommand</B> option consists of the path name of a scrollbar
+widget followed by ``set'', e.g. ``.x.scrollbar set'':  this will cause
+the scrollbar to be updated whenever the view in the window changes.
+If this option is not specified, then no command will be executed.
+<P><DT>Command-Line Name: <B><A NAME="M-yscrollcommand">-yscrollcommand</A></B>
+<DT>Database Name: <B>yScrollCommand</B>
+<DT>Database Class: <B>ScrollCommand</B>
+<DD>Specifies the prefix for a command used to communicate with vertical
+scrollbars.  This option is treated in the same way as the
+<B>xScrollCommand</B> option, except that it is used for vertical
+scrollbars and is provided by widgets that support vertical scrolling.
+See the description of <B>xScrollCommand</B> for details
+on how this option is used.
+</DL>
+<H3><A NAME="M4">KEYWORDS</A></H3>
+<A href="../Keywords/C.htm#class">class</A>, <A href="../Keywords/N.htm#name">name</A>, <A href="../Keywords/S.htm#standard option">standard option</A>, <A href="../Keywords/S.htm#switch">switch</A>
+<HR><PRE>
+<A HREF="../copyright.htm">Copyright</A> &#169; 1990-1994 The Regents of the University of California.
+<A HREF="../copyright.htm">Copyright</A> &#169; 1994-1996 Sun Microsystems, Inc.
+<A HREF="../copyright.htm">Copyright</A> &#169; 1995-1997 Roger E. Critchlow Jr.</PRE>
+</BODY></HTML>