Documentation improvements, all minor.

1 files changed, 232 insertions, 229 deletions

diff --git a/doc/ttk_treeview.n b/doc/ttk_treeview.n
index f80b458..f724fe7 100644
--- a/doc/ttk_treeview.n
+++ b/doc/ttk_treeview.n
@@ -3,9 +3,9 @@
 '\"
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\" 
-'\" RCS: @(#) $Id: ttk_treeview.n,v 1.5 2007/05/03 23:55:30 dkf Exp $
-'\" 
+'\"
+'\" RCS: @(#) $Id: ttk_treeview.n,v 1.6 2007/10/22 14:33:13 dkf Exp $
+'\"
 .so man.macros
 .TH ttk_treeview n 8.5 Tk "Tk Themed Widget"
 .\" Use _ instead of :: as the name becomes a filename on install
@@ -17,33 +17,28 @@ ttk_treeview \- hierarchical multicolumn data display widget
 
 .SH DESCRIPTION
 The \fBttk::treeview\fR widget displays a hierarchical collection of items.
-Each item has a textual label, an optional image, 
-and an optional list of data values.
-The data values are displayed in successive columns after
-the tree label.
+Each item has a textual label, an optional image, and an optional list of data
+values. The data values are displayed in successive columns after the tree
+label.
 .PP
-The order in which data values are displayed may be controlled
-by setting the \fB-displaycolumns\fR widget option.  
-The tree widget can also display column headings.
-Columns may be accessed by number or by symbolic names 
-listed in the \fB-columns\fR widget option;
-see \fBCOLUMN IDENTIFIERS\fR.
+The order in which data values are displayed may be controlled by setting the
+\fB\-displaycolumns\fR widget option. The tree widget can also display column
+headings. Columns may be accessed by number or by symbolic names listed in the
+\fB\-columns\fR widget option; see \fBCOLUMN IDENTIFIERS\fR.
 .PP
-Each item is identified by a unique name.
-The widget will generate item IDs if they are not supplied by the caller.
-There is a distinguished root item, named \fB{}\fR.
-The root item itself is not displayed;
-its children appear at the top level of the hierarchy.
+Each item is identified by a unique name. The widget will generate item IDs if
+they are not supplied by the caller. There is a distinguished root item, named
+\fB{}\fR. The root item itself is not displayed; its children appear at the
+top level of the hierarchy.
 .PP
-Each item also has a list of \fItags\fR,
-which can be used to associate event bindings with individual items
-and control the appearance of the item.
+Each item also has a list of \fItags\fR, which can be used to associate event
+bindings with individual items and control the appearance of the item.
 .\" .PP
 .\" @@@HERE: describe selection, focus item
 .PP
-Treeview widgets support horizontal and vertical scrolling with the
-standard \fB-[xy]scrollcommand\fR options 
-and \fB[xyview\fR widget commands.
+Treeview widgets support horizontal and vertical scrolling with the standard
+\fB\-\fR[\fBxy\fR]\fBscrollcommand\fR options and \fB[xyview\fR widget
+commands.
 .SO
 \-class	\-cursor	\-takefocus	\-style
 \-xscrollcommand	\-yscrollcommand
@@ -51,306 +46,320 @@ and \fB[xyview\fR widget commands.
 
 .SH "WIDGET-SPECIFIC OPTIONS"
 .OP \-columns columns Columns
-A list of column identifiers, 
-specifying the number of columns and their names.
+A list of column identifiers, specifying the number of columns and their
+names.
 .\"X: This is a read-only option; it may only be set when the widget is created.
 .OP \-displaycolumns displayColumns DisplayColumns
-A list of column identifiers 
-(either symbolic names or integer indices)
-specifying which data columns are displayed 
-and the order in which they appear, 
-or the string \fB#all\fP.
+A list of column identifiers (either symbolic names or integer indices)
+specifying which data columns are displayed and the order in which they
+appear, or the string \fB#all\fP.
 .br
 If set to \fB#all\fP (the default), all columns are shown in the order given.
 .OP \-height height Height
-Specifies the number of rows which should be visible.
-Note:
-the requested width is determined from the sum of the column widths.
+Specifies the number of rows which should be visible. Note: the requested
+width is determined from the sum of the column widths.
 .OP \-padding padding Padding
-Specifies the internal padding for the widget.
-The padding is a list of up to four length specifications;
-see \fBTtk_GetPaddingFromObj()\fR for details.
+Specifies the internal padding for the widget. The padding is a list of up to
+four length specifications; see \fBTtk_GetPaddingFromObj()\fR for details.
 .OP \-selectmode selectMode SelectMode
-Controls how the built-in class bindings manage the selection.
-One of \fBextended\fR, \fBbrowse\fR, or \fBnone\fR.
+Controls how the built-in class bindings manage the selection. One of
+\fBextended\fR, \fBbrowse\fR, or \fBnone\fR.
 .br
-If set to \fBextended\fR (the default), multiple items may be selected.
-If \fBbrowse\fR, only a single item will be selected at a time.
-If \fBnone\fR, the selection will not be changed.
+If set to \fBextended\fR (the default), multiple items may be selected. If
+\fBbrowse\fR, only a single item will be selected at a time. If \fBnone\fR,
+the selection will not be changed.
 .br
-Note that application code and tag bindings can set the selection 
-however they wish, regardless of the value of \fB-selectmode\fR.
+Note that application code and tag bindings can set the selection however they
+wish, regardless of the value of \fB\-selectmode\fR.
 .OP \-show show Show
-A list containing zero or more of the following values, specifying
-which elements of the tree to display.
+A list containing zero or more of the following values, specifying which
+elements of the tree to display.
 .RS
 .IP \fBtree\fR
-Display tree labels in column #0.  
+Display tree labels in column #0.
 .IP \fBheadings\fR
 Display the heading row.
 .PP
 The default is \fBtree headings\fR, i.e., show all elements.
 .PP
-\fBNOTE:\fR Column #0 always refers to the tree column,
-even if \fB-show tree\fR is not specified.
+\fBNOTE:\fR Column #0 always refers to the tree column, even if \fB\-show
+tree\fR is not specified.
 .RE
 
 .SH "WIDGET COMMAND"
 .TP
 \fIpathname \fBbbox\fR \fIitem\fR ?\fIcolumn\fR?
-Returns the bounding box (relative to the treeview widget's window)
-of the specified \fIitem\fR
-in the form \fIx y width height\fR.
-If \fIcolumn\fR is specified, returns the bounding box of that cell.
-If the \fIitem\fR is not visible 
-(i.e., if it is a descendant of a closed item or is scrolled offscreen),
-returns the empty list.
+.
+Returns the bounding box (relative to the treeview widget's window) of the
+specified \fIitem\fR in the form \fIx y width height\fR. If \fIcolumn\fR is
+specified, returns the bounding box of that cell. If the \fIitem\fR is not
+visible (i.e., if it is a descendant of a closed item or is scrolled
+offscreen), returns the empty list.
 .TP
 \fIpathname \fBcget\fR \fIoption\fR
-Returns the current value of the specified \fIoption\fR; see \fIttk_widget(n)\fR.
+.
+Returns the current value of the specified \fIoption\fR; see
+\fIttk_widget(n)\fR.
 .TP
 \fIpathname \fBchildren\fR \fIitem\fR ?\fInewchildren\fR?
-If \fInewchildren\fR is not specified,
-returns the list of children belonging to \fIitem\fR.
+.
+If \fInewchildren\fR is not specified, returns the list of children belonging
+to \fIitem\fR.
 .br
-If \fInewchildren\fR is specified, replaces \fIitem\fR's child list
-with \fInewchildren\fR.  
-Items in the old child list not present in the new child list
-are detached from the tree.
-None of the items in \fInewchildren\fR may be an ancestor
-of \fIitem\fR.
-.TP
-\fIpathname \fBcolumn\fR \fIcolumn\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the options for the specified \fIcolumn\fR.
-If no \fI-option\fR is specified,
-returns a dictionary of option/value pairs.
-If a single \fI-option\fR is specified, 
-returns the value of that option.
-Otherwise, the options are updated with the specified values.
-The following options may be set on each column:
+If \fInewchildren\fR is specified, replaces \fIitem\fR's child list with
+\fInewchildren\fR. Items in the old child list not present in the new child
+list are detached from the tree. None of the items in \fInewchildren\fR may be
+an ancestor of \fIitem\fR.
+.TP
+\fIpathname \fBcolumn\fR \fIcolumn\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the options for the specified \fIcolumn\fR. If no
+\fI\-option\fR is specified, returns a dictionary of option/value pairs. If a
+single \fI\-option\fR is specified, returns the value of that option.
+Otherwise, the options are updated with the specified values. The following
+options may be set on each column:
 .RS
 .TP
-\fB-id \fIname\fR
-The column name.  This is a read-only option.
-For example, [\fI$pathname \fBcolumn #\fIn \fB-id\fR] 
-returns the data column associated with data column #\fIn\fR. 
-.TP
-\fB-anchor\fR
-Specifies how the text in this column should be aligned
-with respect to the cell. One of
-\fBn\fR, \fBne\fR, \fBe\fR, \fBse\fR,
-\fBs\fR, \fBsw\fR, \fBw\fR, \fBnw\fR, or \fBcenter\fR.
-.TP
-\fB-minwidth\fR
-The minimum width of the column in pixels.
-The treeview widget will not make the column any smaller than
-\fB-minwidth\fR when the widget is resized or the user drags a 
-column separator.
-.TP
-\fB-stretch\fR
-Specifies whether or not the column's width should be adjusted
-when the widget is resized.
-.TP
-\fB-width \fIw\fR
-The width of the column in pixels.  Default is something reasonable,
-probably 200 or so.
+\fB\-id \fIname\fR
+.
+The column name. This is a read-only option. For example, [\fI$pathname
+\fBcolumn #\fIn \fB\-id\fR] returns the data column associated with data
+column #\fIn\fR.
+.TP
+\fB\-anchor\fR
+.
+Specifies how the text in this column should be aligned with respect to the
+cell. One of \fBn\fR, \fBne\fR, \fBe\fR, \fBse\fR, \fBs\fR, \fBsw\fR, \fBw\fR,
+\fBnw\fR, or \fBcenter\fR.
+.TP
+\fB\-minwidth\fR
+.
+The minimum width of the column in pixels. The treeview widget will not make
+the column any smaller than \fB\-minwidth\fR when the widget is resized or the
+user drags a column separator.
+.TP
+\fB\-stretch\fR
+.
+Specifies whether or not the column's width should be adjusted when the widget
+is resized.
+.TP
+\fB\-width \fIw\fR
+.
+The width of the column in pixels. Default is something reasonable, probably
+200 or so.
 .PP
 Use \fIpathname column #0\fR to configure the tree column.
 .RE
 .TP
 \fIpathname \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
+.
 Modify or query widget options; see \fIttk_widget(n)\fR.
 .TP
 \fIpathname \fBdelete\fR \fIitemList\fR
-Deletes each of the items in \fIitemList\fR and all of their descendants.
-The root item may not be deleted.
-See also: \fBdetach\fR.
+.
+Deletes each of the items in \fIitemList\fR and all of their descendants. The
+root item may not be deleted. See also: \fBdetach\fR.
 .TP
 \fIpathname \fBdetach\fR \fIitemList\fR
-Unlinks all of the specified items in \fIitemList\fR from the tree.
-The items and all of their descendants are still present
-and may be reinserted at another point in the tree
-but will not be displayed.
-The root item may not be detached.
-See also: \fBdelete\fR.
+.
+Unlinks all of the specified items in \fIitemList\fR from the tree. The items
+and all of their descendants are still present and may be reinserted at
+another point in the tree but will not be displayed. The root item may not be
+detached. See also: \fBdelete\fR.
 .TP
 \fIpathname \fBexists \fIitem\fR
-Returns 1 if the specified \fIitem\fR is present in the tree,
-0 otherwise.
+.
+Returns 1 if the specified \fIitem\fR is present in the tree, 0 otherwise.
 .TP
 \fIpathname \fBfocus \fR?\fIitem\fR?
-If \fIitem\fR is specified, sets the focus item to \fIitem\fR.
-Otherwise, returns the current focus item, or \fB{}\fR if there is none.
+.
+If \fIitem\fR is specified, sets the focus item to \fIitem\fR. Otherwise,
+returns the current focus item, or \fB{}\fR if there is none.
 .\" Need: way to clear the focus item.  {} works for this...
-.TP 
-\fIpathname \fBheading\fR \fIcolumn\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the heading options for the specified \fIcolumn\fR.
-Valid options are:
+.TP
+\fIpathname \fBheading\fR \fIcolumn\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the heading options for the specified \fIcolumn\fR. Valid
+options are:
 .RS
 .TP
-\fB-text \fItext\fR
+\fB\-text \fItext\fR
+.
 The text to display in the column heading.
 .TP
-\fB-image \fIimageName\fR
+\fB\-image \fIimageName\fR
+.
 Specifies an image to display to the right of the column heading.
 .TP
-\fB-anchor \fIanchor\fR
-Specifies how the heading text should be aligned.
-One of the standard Tk anchor values.
+\fB\-anchor \fIanchor\fR
+.
+Specifies how the heading text should be aligned. One of the standard Tk
+anchor values.
 .TP
-\fB-command \fIscript\fR
+\fB\-command \fIscript\fR
+.
 A script to evaluate when the heading label is pressed.
 .PP
 Use \fIpathname heading #0\fR to configure the tree column heading.
 .RE
 .TP
 \fIpathname \fBidentify \fIcomponent x y\fR
-Returns a description of the specified \fIcomponent\fR
-under the point given by \fIx\fR and \fIy\fR,
-or the empty string if no such \fIcomponent\fR is present at that position.
-The following subcommands are supported:
+.
+Returns a description of the specified \fIcomponent\fR under the point given
+by \fIx\fR and \fIy\fR, or the empty string if no such \fIcomponent\fR is
+present at that position. The following subcommands are supported:
 .RS
 .TP
 \fIpathname \fBidentify row\fR \fIx y\fR
+.
 Returns the item ID of the item at position \fIy\fR.
 .TP
 \fIpathname \fBidentify column\fR \fIx y\fR
-Returns the data column identifier of the cell at position \fIx\fR.
-The tree column has ID \fB#0\fR.
+.
+Returns the data column identifier of the cell at position \fIx\fR. The tree
+column has ID \fB#0\fR.
 .PP
-See \fBCOLUMN IDENTIFIERS\fR for a discussion of display columns
-and data columns.
+See \fBCOLUMN IDENTIFIERS\fR for a discussion of display columns and data
+columns.
 .RE
 .TP
 \fIpathname \fBindex \fIitem\fR
+.
 Returns the integer index of \fIitem\fR within its parent's list of children.
 .TP
-\fIpathname \fBinsert\fR \fIparent\fR \fIindex\fR ?\fB-id \fIid\fR? \fIoptions...\fR
-Creates a new item.  
-\fIparent\fR is the item ID of the parent item,
-or the empty string \fB{}\fR
-to create a new top-level item.
-\fIindex\fR is an integer, or the value \fBend\fR, specifying where in the
-list of \fIparent\fR's children to insert the new item.
-If \fIindex\fR is less than or equal to zero, 
-the new node is inserted at the beginning;
-if \fIindex\fR is greater than or equal to the current number of children,
-it is inserted at the end.
-If \fB-id\fR is specified, it is used as the item identifier;
-\fIid\fR must not already exist in the tree.
-Otherwise, a new unique identifier is generated.
+\fIpathname \fBinsert\fR \fIparent\fR \fIindex\fR ?\fB\-id \fIid\fR? \fIoptions...\fR
+.
+Creates a new item. \fIparent\fR is the item ID of the parent item, or the
+empty string \fB{}\fR to create a new top-level item. \fIindex\fR is an
+integer, or the value \fBend\fR, specifying where in the list of
+\fIparent\fR's children to insert the new item. If \fIindex\fR is less than or
+equal to zero, the new node is inserted at the beginning; if \fIindex\fR is
+greater than or equal to the current number of children, it is inserted at the
+end. If \fB\-id\fR is specified, it is used as the item identifier; \fIid\fR
+must not already exist in the tree. Otherwise, a new unique identifier is
+generated.
 .br
-\fIpathname \fBinsert\fR returns the item identifier of the
-newly created item.
-See \fBITEM OPTIONS\fR for the list of available options.
+\fIpathname \fBinsert\fR returns the item identifier of the newly created
+item. See \fBITEM OPTIONS\fR for the list of available options.
 .TP
 \fIpathname \fBinstate \fIstatespec\fR ?\fIscript\fR?
+.
 Test the widget state; see \fIttk_widget(n)\fR.
 .TP
-\fIpathname \fBitem\fR \fIitem\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the options for the specified \fIitem\fR.
-If no \fI-option\fR is specified, 
-returns a dictionary of option/value pairs.
-If a single \fI-option\fR is specified, 
-returns the value of that option.
-Otherwise, the item's options are updated with the specified values.
-See \fBITEM OPTIONS\fR for the list of available options.
+\fIpathname \fBitem\fR \fIitem\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the options for the specified \fIitem\fR. If no \fI\-option\fR
+is specified, returns a dictionary of option/value pairs. If a single
+\fI\-option\fR is specified, returns the value of that option. Otherwise, the
+item's options are updated with the specified values. See \fBITEM OPTIONS\fR
+for the list of available options.
 .TP
 \fIpathname \fBmove \fIitem parent index\fR
+.
 Moves \fIitem\fR to position \fIindex\fR in \fIparent\fR's list of children.
 It is illegal to move an item under one of its descendants.
 .br
-If \fIindex\fR is less than or equal to zero, \fIitem\fR is moved
-to the beginning; if greater than or equal to the number of children,
-it's moved to the end.
-.TP 
+If \fIindex\fR is less than or equal to zero, \fIitem\fR is moved to the
+beginning; if greater than or equal to the number of children, it's moved to
+the end.
+.TP
 \fIpathname \fBnext \fIitem\fR
-Returns the identifier of \fIitem\fR's next sibling,
-or \fB{}\fR if \fIitem\fR is the last child of its parent.
+.
+Returns the identifier of \fIitem\fR's next sibling, or \fB{}\fR if \fIitem\fR
+is the last child of its parent.
 .TP
 \fIpathname \fBparent \fIitem\fR
-Returns the ID of the parent of \fIitem\fR,
-or \fB{}\fR if \fIitem\fR is at the top level of the hierarchy.
-.TP 
+.
+Returns the ID of the parent of \fIitem\fR, or \fB{}\fR if \fIitem\fR is at
+the top level of the hierarchy.
+.TP
 \fIpathname \fBprev \fIitem\fR
-Returns the identifier of \fIitem\fR's previous sibling,
-or \fB{}\fR if \fIitem\fR is the first child of its parent.
+.
+Returns the identifier of \fIitem\fR's previous sibling, or \fB{}\fR if
+\fIitem\fR is the first child of its parent.
 .TP
 \fIpathname \fBsee\fR \fIitem\fR
-Ensure that \fIitem\fR is visible:
-sets all of \fIitem\fR's ancestors to \fB-open true\fR,
-and scrolls the widget if necessary so that \fIitem\fR is 
+.
+Ensure that \fIitem\fR is visible: sets all of \fIitem\fR's ancestors to
+\fB\-open true\fR, and scrolls the widget if necessary so that \fIitem\fR is
 within the visible portion of the tree.
 .TP
 \fIpathname \fBselection\fR ?\fIselop\fR \fIitemList\fR?
+.
 If \fIselop\fR is not specified, returns the list of selected items.
 Otherwise, \fIselop\fR is one of the following:
 .RS
 .TP
 \fIpathname \fBselection set \fIitemList\fR
+.
 \fIitemList\fR becomes the new selection.
 .TP
 \fIpathname \fBselection add \fIitemList\fR
+.
 Add \fIitemList\fR to the selection
 .TP
 \fIpathname \fBselection remove \fIitemList\fR
+.
 Remove \fIitemList\fR from the selection
 .TP
 \fIpathname \fBselection toggle \fIitemList\fR
+.
 Toggle the selection state of each item in \fIitemList\fR.
 .RE
 .TP
 \fIpathname \fBset\fR \fIitem\fR ?\fIcolumn\fR ?\fIvalue\fR??
-With one argument, returns a dictionary of column/value pairs
-for the specified \fIitem\fR.  
-With two arguments, returns the current value of the specified \fIcolumn\fR.
-With three arguments, sets the value of column \fIcolumn\fR
-in item \fIitem\fR to the specified \fIvalue\fR.
-See also \fBCOLUMN IDENTIFIERS\fR.
+.
+With one argument, returns a dictionary of column/value pairs for the
+specified \fIitem\fR. With two arguments, returns the current value of the
+specified \fIcolumn\fR. With three arguments, sets the value of column
+\fIcolumn\fR in item \fIitem\fR to the specified \fIvalue\fR. See also
+\fBCOLUMN IDENTIFIERS\fR.
 .TP
 \fIpathname \fBstate\fR ?\fIstateSpec\fR?
+.
 Modify or query the widget state; see \fIttk_widget(n)\fR.
 .TP
 \fIpathName \fBtag \fIargs...\fR
+.
 .RS
 .TP
 \fIpathName \fBtag bind \fItagName \fR?\fIsequence \fR?\fIscript\fR??
-Add a Tk binding script for the event sequence \fIsequence\fR 
-to the tag \fItagName\fR.  When an X event is delivered to an item,
-binding scripts for each of the item's \fB-tags\fR are evaluated
-in order as per \fIbindtags(n)\fR.
+.
+Add a Tk binding script for the event sequence \fIsequence\fR to the tag
+\fItagName\fR. When an X event is delivered to an item, binding scripts for
+each of the item's \fB\-tags\fR are evaluated in order as per
+\fIbindtags(n)\fR.
 .br
-\fB<KeyPress>\fR, \fB<KeyRelease>\fR, and virtual events
-are sent to the focus item.
-\fB<ButtonPress>\fR, \fB<ButtonRelease>\fR, and \fB<Motion>\fR events
-are sent to the item under the mouse pointer.  
-No other event types are supported.
+\fB<KeyPress>\fR, \fB<KeyRelease>\fR, and virtual events are sent to the focus
+item. \fB<ButtonPress>\fR, \fB<ButtonRelease>\fR, and \fB<Motion>\fR events
+are sent to the item under the mouse pointer. No other event types are
+supported.
 .br
-The binding \fIscript\fR undergoes \fB%\fR-substitutions before 
-evaluation; see \fBbind(n)\fR for details.
+The binding \fIscript\fR undergoes \fB%\fR-substitutions before evaluation;
+see \fBbind(n)\fR for details.
 .TP
 \fIpathName \fBtag configure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
-Query or modify the options for the specified \fItagName\fR.
-If one or more \fIoption/value\fR pairs are specified,
-sets the value of those options for the specified tag.
-If a single \fIoption\fR is specified, 
-returns the value of that option 
-(or the empty string if the option has not been specified for \fItagName\fR).
-With no additional arguments, 
-returns a dictionary of the option settings for \fItagName\fR.
-See \fBTAG OPTIONS\fR for the list of available options.
+.
+Query or modify the options for the specified \fItagName\fR. If one or more
+\fIoption/value\fR pairs are specified, sets the value of those options for
+the specified tag. If a single \fIoption\fR is specified, returns the value of
+that option (or the empty string if the option has not been specified for
+\fItagName\fR). With no additional arguments, returns a dictionary of the
+option settings for \fItagName\fR. See \fBTAG OPTIONS\fR for the list of
+available options.
 .RE
 .TP
 \fIpathName \fBxview \fIargs\fR
+.
 Standard command for horizontal scrolling; see \fIwidget(n)\fR.
 .TP
 \fIpathName \fByview \fIargs\fR
+.
 Standard command for vertical scrolling; see \fIttk_widget(n)\fR.
-
 .PP
 .SH "ITEM OPTIONS"
-The following item options may be specified for items
-in the \fBinsert\fR and \fBitem\fR widget commands.
+The following item options may be specified for items in the \fBinsert\fR and
+\fBitem\fR widget commands.
 .OP \-text text Text
 The textual label to display for the item.
 .OP \-image image Image
@@ -358,17 +367,15 @@ A Tk image, displayed to the left of the label.
 .OP \-values values Values
 The list of values associated with the item.
 .br
-Each item should have the same number of values as
-the \fB-columns\fR widget option.
-If there are fewer values than columns,
-the remaining values are assumed empty.
-If there are more values than columns,
-the extra values are ignored.
+Each item should have the same number of values as the \fB\-columns\fR widget
+option. If there are fewer values than columns, the remaining values are
+assumed empty. If there are more values than columns, the extra values are
+ignored.
 .OP \-open open Open
-A boolean value indicating whether the item's children
-should be displayed (\fB-open true\fR) or hidden (\fB-open false\fR).
+A boolean value indicating whether the item's children should be displayed
+(\fB\-open true\fR) or hidden (\fB\-open false\fR).
 .OP \-tags tags Tags
-A list of tags associated with this item.  
+A list of tags associated with this item.
 .SH "TAG OPTIONS"
 The following options may be specified on tags:
 .IP \-foreground
@@ -381,47 +388,43 @@ Specifies the font to use when drawing text.
 .\" ??? Maybe: .IP \-padding
 .\" ??? Maybe: .IP \-text
 .IP \-image
-Specifies the item image, in case the item's \fB-image\fR option is empty.
+Specifies the item image, in case the item's \fB\-image\fR option is empty.
 .PP
 \fI(@@@ TODO: sort out order of precedence for options)\fR
-
 .SH "COLUMN IDENTIFIERS"
 Column identifiers take any of the following forms:
 .IP \(bu
-A symbolic name from the list of \fB-columns\fR.
+A symbolic name from the list of \fB\-columns\fR.
 .IP \(bu
 An integer \fIn\fR, specifying the \fIn\fRth data column.
 .IP \(bu
-A string of the form \fB#\fIn\fR, where \fIn\fR is an integer,
-specifying the \fIn\fRth display column.
+A string of the form \fB#\fIn\fR, where \fIn\fR is an integer, specifying the
+\fIn\fRth display column.
 .PP
-\fBNOTE:\fR 
-Item \fB-values\fR may be displayed in a different order than 
-the order in which they are stored.
+\fBNOTE:\fR Item \fB\-values\fR may be displayed in a different order than the
+order in which they are stored.
 .PP
-\fBNOTE:\fR Column #0 always refers to the tree column,
-even if \fB-show tree\fR is not specified.
+\fBNOTE:\fR Column #0 always refers to the tree column, even if \fB\-show
+tree\fR is not specified.
 .PP
-A \fIdata column number\fR is an index into an item's \fB-values\fR list;
-a \fIdisplay column number\fR is the column number in the tree
-where the values are displayed.  
-Tree labels are displayed in column #0.
-If \fB-displaycolumns\fR is not set,
-then data column \fIn\fR is displayed in display column \fB#\fIn+1\fR.
-Again, \fBcolumn #0 always refers to the tree column\fR.
+A \fIdata column number\fR is an index into an item's \fB\-values\fR list; a
+\fIdisplay column number\fR is the column number in the tree where the values
+are displayed. Tree labels are displayed in column #0. If
+\fB\-displaycolumns\fR is not set, then data column \fIn\fR is displayed in
+display column \fB#\fIn+1\fR. Again, \fBcolumn #0 always refers to the tree
+column\fR.
 .SH "VIRTUAL EVENTS"
 The treeview widget generates the following virtual events.
 .IP <<TreeviewSelect>>
 Generated whenever the selection changes.
 .IP <<TreeviewOpen>>
-Generated just before setting the focus item to \fB-open true\fR.
+Generated just before setting the focus item to \fB\-open true\fR.
 .IP <<TreeviewClose>>
-Generated just after setting the focus item to \fB-open false\fR.
+Generated just after setting the focus item to \fB\-open false\fR.
 .PP
-The \fBfocus\fR and \fBselection\fR widget commands can be used
-to determine the affected item or items.
-In Tk 8.5, the affected item is also passed as the \fB-detail\fR field
-of the virtual event.
+The \fBfocus\fR and \fBselection\fR widget commands can be used to determine
+the affected item or items. In Tk 8.5, the affected item is also passed as the
+\fB\-detail\fR field of the virtual event.
 
 .SH "SEE ALSO"
 ttk_widget(n), listbox(n), image(n), bind(n)