Lots of improvements to look and feel of manual pages

1 files changed, 37 insertions, 22 deletions

diff --git a/doc/ttk_widget.n b/doc/ttk_widget.n
index 3ba3111..6aa4706 100644
--- a/doc/ttk_widget.n
+++ b/doc/ttk_widget.n
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\"
-'\" RCS: @(#) $Id: ttk_widget.n,v 1.5 2007/10/23 15:44:36 dkf Exp $
+'\" RCS: @(#) $Id: ttk_widget.n,v 1.6 2007/10/24 14:32:59 dkf Exp $
 '\"
 .so man.macros
 .TH ttk_widget n 8.5 Tk "Tk Themed Widget"
@@ -15,7 +15,6 @@ ttk_widget \- Standard options and commands supported by Tk themed widgets
 
 .SH DESCRIPTION
 This manual describes common widget options and commands.
-
 .SH "STANDARD OPTIONS"
 The following options are supported by all Tk themed widgets:
 .OP \-class undefined undefined
@@ -36,7 +35,6 @@ appended, and which should return \fB0\fR or \fB1\fR), or the empty string.
 See \fIoptions(n)\fR in the Tk reference manual for the full description.
 .OP \-style style Style
 May be used to specify a custom widget style.
-
 .SH "SCROLLABLE WIDGET OPTIONS"
 .PP
 The following options are supported by widgets that are controllable by a
@@ -54,8 +52,11 @@ second fraction indicates the information just after the last portion that is
 visible.
 .PP
 Typically the \fBxScrollCommand\fR option consists of the path name of a
-\fBscrollbar\fR widget followed by ``set'', e.g. ``.x.scrollbar set''. This
-will cause the scrollbar to be updated whenever the view in the window
+\fBscrollbar\fR widget followed by
+.QW set ,
+e.g.
+.QW ".x.scrollbar set" .
+This will cause the scrollbar to be updated whenever the view in the window
 changes.
 .PP
 If this option is set to the empty string (the default), then no command is be
@@ -64,7 +65,6 @@ executed.
 .OP \-yscrollcommand yScrollCommand ScrollCommand
 A command prefix, used to communicate with vertical scrollbars. See the
 description of \fB\-xscrollcommand\fR above for details.
-
 .SH "LABEL OPTIONS"
 The following options are supported by labels, buttons, and other button-like
 widgets:
@@ -102,13 +102,13 @@ The default; display the image if present, otherwise the text.
 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.
-
 .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.
-
+state bit. This is a 
+.QW write-only
+option: setting it changes the widget state, but the \fBstate\fR widget
+command does not affect the state option.
 .SH COMMANDS
 .TP
 \fIpathName \fBcget\fR \fIoption\fR
@@ -160,11 +160,18 @@ include:
 \fBactive\fR
 .
 The mouse cursor is over the widget and pressing a mouse button will cause
-some action to occur. (aka "prelight" (Gnome), "hot" (Windows), "hover").
+some action to occur. (aka 
+.QW "prelight"
+(Gnome),
+.QW "hot"
+(Windows),
+.QW "hover" ).
 .TP
 \fBdisabled\fR
 .
-Widget is disabled under program control (aka "unavailable", "inactive")
+Widget is disabled under program control (aka
+.QW "unavailable" ,
+.QW "inactive" )
 .TP
 \fBfocus\fR
 .
@@ -172,18 +179,25 @@ Widget has keyboard focus.
 .TP
 \fBpressed\fR
 .
-Widget is being pressed (aka "armed" in Motif).
+Widget is being pressed (aka
+.QW "armed"
+in Motif).
 .TP
 \fBselected\fR
 .
-The widget is "On", "true", or "current" (for things like checkbuttons and
-radiobuttons).
+The widget is
+.QW "On" ,
+.QW "true" ,
+or
+.QW "current"
+(for things like checkbuttons and radiobuttons).
 .TP
 \fBbackground\fR
 .
-Windows and the Mac have a notion of an "active" or foreground window. The
-\fBbackground\fR state is set for widgets in a background window, and cleared
-for those in the foreground window.
+Windows and the Mac have a notion of an
+.QW "active"
+or foreground window. The \fBbackground\fR state is set for widgets in a
+background window, and cleared for those in the foreground window.
 .TP
 \fBreadonly\fR
 .
@@ -192,8 +206,11 @@ Widget should not allow user modification.
 \fBalternate\fR
 .
 A widget-specific alternate display format. For example, used for checkbuttons
-and radiobuttons in the "tristate" or "mixed" state, and for buttons with
-\fB\-default active\fR.
+and radiobuttons in the
+.QW "tristate"
+or
+.QW "mixed"
+state, and for buttons with \fB\-default active\fR.
 .TP
 \fBinvalid\fR
 .
@@ -203,7 +220,6 @@ bounds, entry widget value failed validation.)
 A \fIstate specification\fR or \fIstateSpec\fR is a list of state names,
 optionally prefixed with an exclamation point (!) indicating that the bit is
 off.
-
 .SH EXAMPLES
 .CS
 set b [ttk::button .b]
@@ -217,7 +233,6 @@ $b instate {pressed !disabled} { .b invoke }
 # Reenable widget:
 $b state !disabled
 .CE
-
 .SH "SEE ALSO"
 ttk_intro(n), style(n)
 .SH KEYWORDS