Lots of improvements to look and feel of manual pages

author: dkf <donal.k.fellows@manchester.ac.uk> 2007-10-24 14:32:55 (GMT)
committer: dkf <donal.k.fellows@manchester.ac.uk> 2007-10-24 14:32:55 (GMT)
commit: a9b41e61dd1f2274961a88385d433a9bac66d44a (patch)
tree: 09cfb7c149cd2c0c95d126aa8764f569b3e42063
parent: 5d96c35c08ea64525de7b4ab99171bfcc0252142 (diff)
download: tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.zip
tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.tar.gz
tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.tar.bz2
0 files changed, 0 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 12e15f0..2bf0afd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-10-24  Donal K. Fellows  <donal.k.fellows@man.ac.uk>
+
+	* doc/*.n, doc/*.3, doc/*.1: Lots of changes to take advantage of the
+	new macros.
+
 2007-10-24  Pat Thoyts  <patthoyts@users.sourceforge.net>
 
 	* win/tkWinDraw.c: Applied patch #1723362 for transparent bitmaps
diff --git a/doc/3DBorder.3 b/doc/3DBorder.3
index 88829f2..aaea6e8 100644
--- a/doc/3DBorder.3
+++ b/doc/3DBorder.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: 3DBorder.3,v 1.7 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: 3DBorder.3,v 1.8 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_Alloc3DBorderFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -238,7 +238,9 @@ Each procedure takes \fIx\fR, \fIy\fR, \fIwidth\fR, and \fIheight\fR
 arguments that describe the rectangular area of the beveled edge
 (e.g., \fIwidth\fR is the border width for \fBTk_3DVerticalBevel\fR).
 The \fIleftBorder\fR and \fItopBorder\fR arguments indicate the
-position of the border relative to the ``inside'' of the object, and
+position of the border relative to the
+.QW inside
+of the object, and
 \fIrelief\fR indicates the relief of the inside of the object relative
 to the outside.
 \fBTk_3DVerticalBevel\fR just draws a rectangular region.
diff --git a/doc/ConfigWidg.3 b/doc/ConfigWidg.3
index 4a1bcda..bb4c6cf 100644
--- a/doc/ConfigWidg.3
+++ b/doc/ConfigWidg.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: ConfigWidg.3,v 1.16 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: ConfigWidg.3,v 1.17 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_ConfigureWidget 3 4.1 Tk "Tk Library Procedures"
@@ -118,7 +118,10 @@ The \fItype\fR field indicates what type of configuration option this is
 (e.g. \fBTK_CONFIG_COLOR\fR for a color value, or \fBTK_CONFIG_INT\fR for
 an integer value).  The \fItype\fR field indicates how to use the
 value of the option (more on this below).
-The \fIargvName\fR field is a string such as ``\-font'' or ``\-bg'',
+The \fIargvName\fR field is a string such as 
+.QW \-font
+or
+.QW \-bg ,
 which is compared with the values in \fIargv\fR (if \fIargvName\fR is
 NULL it means this is a grouped entry;  see GROUPED ENTRIES below).  The
 \fIdbName\fR and \fIdbClass\fR fields are used to look up a value
@@ -162,7 +165,8 @@ of each \fIspecs\fR entry indicates where in \fIwidgRec\fR to store
 the information about this configuration option.  You should use the
 \fBTk_Offset\fR macro to generate \fIoffset\fR values (see below for
 a description of \fBTk_Offset\fR).  The location indicated by
-\fIwidgRec\fR and \fIoffset\fR will be referred to as the ``target''
+\fIwidgRec\fR and \fIoffset\fR will be referred to as the
+.QW target
 in the descriptions below.
 .PP
 The \fItype\fR field of each entry in \fIspecs\fR determines what
@@ -201,10 +205,20 @@ wasn't \fBNone\fR, then it is freed by passing it to \fBTk_FreeBitmap\fR.
 .TP
 \fBTK_CONFIG_BOOLEAN\fR
 The value must be an ASCII string specifying a boolean value.  Any
-of the values ``true'', ``yes'', ``on'', or ``1'',
+of the values
+.QW true ,
+.QW yes ,
+.QW on ,
+or
+.QW 1,
 or an abbreviation of one of these values, means true;
-any of the values ``false'', ``no'', ``off'', or ``0'', or an abbreviation of
-one of these values, means false.
+any of the values
+.QW false ,
+.QW no ,
+.QW off ,
+or
+.QW 0 ,
+or an abbreviation of one of these values, means false.
 The target is expected to be an integer;  for true values it will
 be set to 1 and for false values it will be set to 0.
 .TP
@@ -269,8 +283,11 @@ wasn't NULL, then it is freed by passing it to \fBTk_FreeFont\fR.
 .TP
 \fBTK_CONFIG_INT\fR
 The value must be an ASCII integer string
-in the format accepted by \fBstrtol\fR (e.g. ``0''
-and ``0x'' prefixes may be used to specify octal or hexadecimal
+in the format accepted by \fBstrtol\fR (e.g.
+.QW 0
+and
+.QW 0x
+prefixes may be used to specify octal or hexadecimal
 numbers, respectively).  The string is converted to an integer
 value and the integer is stored in the target.
 .TP
@@ -326,7 +343,10 @@ for another entry whose \fIargvName\fR is the same as the \fIdbName\fR
 field in the \fBTK_CONFIG_SYNONYM\fR entry;  this new entry is used just
 as if its \fIargvName\fR had matched the \fIargv\fR value.  The
 synonym mechanism allows multiple \fIargv\fR values to be used for
-a single configuration option, such as ``\-background'' and ``\-bg''.
+a single configuration option, such as
+.QW \-background
+and
+.QW \-bg .
 .TP
 \fBTK_CONFIG_UID\fR
 The value is translated to a \fBTk_Uid\fR
diff --git a/doc/CrtErrHdlr.3 b/doc/CrtErrHdlr.3
index 3cf7ba1..689bf7c 100644
--- a/doc/CrtErrHdlr.3
+++ b/doc/CrtErrHdlr.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: CrtErrHdlr.3,v 1.3 2004/09/19 16:05:36 dkf Exp $
+'\" RCS: @(#) $Id: CrtErrHdlr.3,v 1.4 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_CreateErrorHandler 3 "" Tk "Tk Library Procedures"
@@ -103,9 +103,8 @@ default error handler, which prints an error message and aborts the
 program.  If you wish to have a default handler that deals with errors
 that no other handler can deal with, then declare it first.
 .PP
-The X documentation states that ``the error handler should not call
-any functions (directly or indirectly) on the display that will
-generate protocol requests or that will look for input events.''
+The X documentation states that
+.QW "the error handler should not call any functions (directly or indirectly) on the display that will generate protocol requests or that will look for input events."
 This restriction applies to handlers declared by \fBTk_CreateErrorHandler\fR;
 disobey it at your own risk.
 .PP
diff --git a/doc/CrtWindow.3 b/doc/CrtWindow.3
index b938c2f..f5f65d6 100644
--- a/doc/CrtWindow.3
+++ b/doc/CrtWindow.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: CrtWindow.3,v 1.8 2007/01/05 00:00:47 nijtmans Exp $
+'\" RCS: @(#) $Id: CrtWindow.3,v 1.9 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_CreateWindow 3 4.2 Tk "Tk Library Procedures"
@@ -43,8 +43,9 @@ the same \fIparent\fR.
 Has same format as \fIscreenName\fR.  If NULL, then new window is
 created as an internal window.  If non-NULL, new window is created as
 a top-level window on screen \fItopLevScreen\fR.  If \fItopLevScreen\fR
-is an empty string (``'') then new
-window is created as top-level window of \fIparent\fR's screen.
+is an empty string
+.PQ ""
+then new window is created as top-level window of \fIparent\fR's screen.
 .AP Tk_Window tkwin in
 Token for window.
 .AP "const char" *pathName in
diff --git a/doc/FontId.3 b/doc/FontId.3
index c121963..bf01912 100644
--- a/doc/FontId.3
+++ b/doc/FontId.3
@@ -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: FontId.3,v 1.6 2005/04/22 21:32:23 georgeps Exp $
+'\" RCS: @(#) $Id: FontId.3,v 1.7 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_FontId 3 8.0 Tk "Tk Library Procedures"
@@ -56,8 +56,10 @@ ascent, descent, and linespace, used in font metrics.
 Postscript font name that should be used when printing.  The return value
 is the size in points of the \fItkfont\fR and the Postscript font name is
 appended to \fIdsPtr\fR.  \fIDsPtr\fR must refer to an initialized
-\fBTcl_DString\fR.  Given a ``reasonable'' Postscript printer, the
-following screen font families should print correctly:
+\fBTcl_DString\fR.  Given a
+.QW reasonable
+Postscript printer, the following screen font families should print
+correctly:
 .IP
 \fBAvant Garde\fR, \fBArial\fR, \fBBookman\fR, \fBCourier\fR, 
 \fBCourier New\fR, \fBGeneva\fR, \fBHelvetica\fR, \fBMonaco\fR,
diff --git a/doc/GetAnchor.3 b/doc/GetAnchor.3
index b52583f..469fc77 100644
--- a/doc/GetAnchor.3
+++ b/doc/GetAnchor.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetAnchor.3,v 1.6 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: GetAnchor.3,v 1.7 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetAnchorFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -74,7 +74,8 @@ return value, so \fBTk_GetAnchor\fR is less efficient than
 Given an anchor position such as \fBTK_ANCHOR_N\fR it returns a
 statically-allocated string corresponding to \fIanchor\fR.
 If \fIanchor\fR isn't a legal anchor value, then
-``unknown anchor position'' is returned.
+.QW "unknown anchor position"
+is returned.
 
 .SH KEYWORDS
 anchor position
diff --git a/doc/GetBitmap.3 b/doc/GetBitmap.3
index 9742785..f7c04b4 100644
--- a/doc/GetBitmap.3
+++ b/doc/GetBitmap.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetBitmap.3,v 1.10 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: GetBitmap.3,v 1.11 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_AllocBitmapFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -113,7 +113,8 @@ every fourth pixel in every other row.
 An hourglass symbol.
 .TP 12
 \fBinfo\fR
-A large letter ``i''.
+A large letter
+.QW i .
 .TP 12
 \fBquesthead\fR
 The silhouette of a human head, with a question mark in it.
diff --git a/doc/GetCapStyl.3 b/doc/GetCapStyl.3
index e0e04a2..83bbeed 100644
--- a/doc/GetCapStyl.3
+++ b/doc/GetCapStyl.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetCapStyl.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: GetCapStyl.3,v 1.5 2007/10/24 14:32:56 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetCapStyle 3 "" Tk "Tk Library Procedures"
@@ -26,8 +26,11 @@ const char *
 .AP Tcl_Interp *interp in
 Interpreter to use for error reporting.
 .AP "const char" *string in
-String containing name of cap style: one of ```butt'', ``projecting'',
-or ``round''.
+String containing name of cap style: one of
+.QW butt ,
+.QW projecting ,
+or
+.QW round .
 .AP int *capPtr out
 Pointer to location in which to store X cap style corresponding to
 \fIstring\fR.
@@ -57,7 +60,8 @@ stored in \fIinterp->result\fR, \fBTCL_ERROR\fR is returned, and
 Given a cap style such as \fBCapButt\fR it returns a
 statically-allocated string corresponding to \fIcap\fR.
 If \fIcap\fR isn't a legal cap style, then
-``unknown cap style'' is returned.
+.QW "unknown cap style"
+is returned.
 
 .SH KEYWORDS
 butt, cap style, projecting, round
diff --git a/doc/GetCursor.3 b/doc/GetCursor.3
index 0b9efb6..1b229cd 100644
--- a/doc/GetCursor.3
+++ b/doc/GetCursor.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetCursor.3,v 1.9 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: GetCursor.3,v 1.10 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_AllocCursorFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -93,7 +93,8 @@ list with one of the following forms:
 \fIName\fR is the name of a cursor in the standard X cursor cursor,
 i.e., any of the names defined in \fBcursorcursor.h\fR, without
 the \fBXC_\fR.  Some example values are \fBX_cursor\fR, \fBhand2\fR,
-or \fBleft_ptr\fR.  Appendix B of ``The X Window System''
+or \fBleft_ptr\fR.  Appendix B of
+.QW "The X Window System"
 by Scheifler & Gettys has illustrations showing what each of these
 cursors looks like.  If \fIfgColor\fR and \fIbgColor\fR are both
 specified, they give the foreground and background colors to use
diff --git a/doc/GetJoinStl.3 b/doc/GetJoinStl.3
index b715424..8fe81ab 100644
--- a/doc/GetJoinStl.3
+++ b/doc/GetJoinStl.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetJoinStl.3,v 1.4 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: GetJoinStl.3,v 1.5 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetJoinStyle 3 "" Tk "Tk Library Procedures"
@@ -26,8 +26,11 @@ const char *
 .AP Tcl_Interp *interp in
 Interpreter to use for error reporting.
 .AP "const char" *string in
-String containing name of join style: one of ``bevel'', ``miter'',
-or ``round''.
+String containing name of join style: one of
+.QW bevel ,
+.QW miter ,
+or
+.QW round .
 .AP int *joinPtr out
 Pointer to location in which to store X join style corresponding to
 \fIstring\fR.
@@ -56,7 +59,8 @@ stored in \fIinterp->result\fR, \fBTCL_ERROR\fR is returned, and
 Given a join style such as \fBJoinBevel\fR it returns a
 statically-allocated string corresponding to \fIjoin\fR.
 If \fIjoin\fR isn't a legal join style, then
-``unknown join style'' is returned.
+.QW "unknown join style"
+is returned.
 
 .SH KEYWORDS
 bevel, join style, miter, round
diff --git a/doc/GetJustify.3 b/doc/GetJustify.3
index 47df31e..402831a 100644
--- a/doc/GetJustify.3
+++ b/doc/GetJustify.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetJustify.3,v 1.6 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: GetJustify.3,v 1.7 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetJustifyFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -29,9 +29,12 @@ const char *
 .AP Tcl_Interp *interp in
 Interpreter to use for error reporting, or NULL.
 .AP Tcl_Obj *objPtr in/out
-String value contains name of justification style (\fBleft\fR, \fBright\fR, or
-\fBcenter\fR).  The
-internal rep will be modified to cache corresponding justify value.
+String value contains name of justification style; one of: 
+.QW \fBleft\fR ,
+.QW \fBright\fR ,
+or
+.QW \fBcenter\fR ).
+The internal rep will be modified to cache corresponding justify value.
 .AP "const char" *string in
 Same as \fIobjPtr\fR except description of justification style is passed as
 a string.
@@ -80,7 +83,8 @@ return value, so \fBTk_GetJustify\fR is less efficient than
 Given a justify value it returns a statically-allocated string
 corresponding to \fIjustify\fR.
 If \fIjustify\fR isn't a legal justify value, then
-``unknown justification style'' is returned.
+.QW "unknown justification style"
+is returned.
 
 .SH KEYWORDS
 center, fill, justification, string
diff --git a/doc/GetRelief.3 b/doc/GetRelief.3
index 3ba3b34..d5243fb 100644
--- a/doc/GetRelief.3
+++ b/doc/GetRelief.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetRelief.3,v 1.7 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: GetRelief.3,v 1.8 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetReliefFromObj 3 8.1 Tk "Tk Library Procedures"
@@ -71,7 +71,8 @@ return value, so \fBTk_GetRelief\fR is less efficient than
 \fBTk_NameOfRelief\fR is the logical inverse of \fBTk_GetRelief\fR.
 Given a relief value it returns the corresponding string (\fBflat\fR,
 \fBraised\fR, \fBsunken\fR, \fBgroove\fR, \fBsolid\fR, or \fBridge\fR).
-If \fIrelief\fR isn't a legal relief value, then ``unknown relief''
+If \fIrelief\fR isn't a legal relief value, then
+.QW "unknown relief"
 is returned.
 
 .SH KEYWORDS
diff --git a/doc/GetUid.3 b/doc/GetUid.3
index 303dc47..61eca55 100644
--- a/doc/GetUid.3
+++ b/doc/GetUid.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetUid.3,v 1.4 2004/02/17 13:47:22 dkf Exp $
+'\" RCS: @(#) $Id: GetUid.3,v 1.5 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetUid 3 "" Tk "Tk Library Procedures"
@@ -31,7 +31,8 @@ to \fIstring\fR.
 Unique identifiers are similar to atoms in Lisp, and are used
 in Tk to speed up comparisons and
 searches.  A unique identifier (type Tk_Uid) is a string pointer
-and may be used anywhere that a variable of type ``char *''
+and may be used anywhere that a variable of type
+.QW "char *"
 could be used.  However, there is guaranteed to be exactly
 one unique identifier for any given string value.  If \fBTk_GetUid\fR
 is called twice, once with string \fIa\fR and once with string
diff --git a/doc/GetVRoot.3 b/doc/GetVRoot.3
index 5f8c97e..d32afff 100644
--- a/doc/GetVRoot.3
+++ b/doc/GetVRoot.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetVRoot.3,v 1.3 2004/08/22 15:43:20 dkf Exp $
+'\" RCS: @(#) $Id: GetVRoot.3,v 1.4 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetVRootGeometry 3 4.0 Tk "Tk Library Procedures"
@@ -34,9 +34,10 @@ Points to word in which to store height of virtual root.
 .SH DESCRIPTION
 .PP
 \fBTk_GetVRootGeometry\fR returns geometry information about the virtual
-root window associated with \fItkwin\fR.  The ``associated'' virtual
-root is the one in which \fItkwin\fR's nearest top-level ancestor (or
-\fItkwin\fR itself if it is a top-level window) has
+root window associated with \fItkwin\fR.  The
+.QW associated
+virtual root is the one in which \fItkwin\fR's nearest top-level ancestor
+(or \fItkwin\fR itself if it is a top-level window) has
 been reparented by the window manager.  This window is identified by
 a \fB__SWM_ROOT\fR or \fB__WM_ROOT\fR property placed on the top-level
 window by the window manager.
diff --git a/doc/GetVisual.3 b/doc/GetVisual.3
index f4f94c6..4cfe4b6 100644
--- a/doc/GetVisual.3
+++ b/doc/GetVisual.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: GetVisual.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: GetVisual.3,v 1.5 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_GetVisual 3 4.0 Tk "Tk Library Procedures"
@@ -76,8 +76,9 @@ as \fItkwin\fR.
 Use the visual whose X identifier is \fInumber\fR.
 .TP 15
 \fBbest\fR ?\fIdepth\fR?
-Choose the ``best possible'' visual, using the following rules, in
-decreasing order of priority:
+Choose the
+.QW "best possible"
+visual, using the following rules, in decreasing order of priority:
 (a) a visual that has exactly the desired depth is best, followed
 by a visual with greater depth than requested (but as little extra
 as possible), followed by a visual with less depth than requested
diff --git a/doc/InternAtom.3 b/doc/InternAtom.3
index fbe62b9..8ee83b5 100644
--- a/doc/InternAtom.3
+++ b/doc/InternAtom.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: InternAtom.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: InternAtom.3,v 1.5 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_InternAtom 3 "" Tk "Tk Library Procedures"
@@ -44,7 +44,8 @@ by \fBTk_GetAtomName\fR is in Tk's storage:  the caller need
 not free this space when finished with the string, and the caller
 should not modify the contents of the returned string.
 If there is no atom \fIatom\fR on \fItkwin\fR's display,
-then \fBTk_GetAtomName\fR returns the string ``?bad atom?''.
+then \fBTk_GetAtomName\fR returns the string
+.QW "?bad atom?" .
 .PP
 Tk caches
 the information returned by \fBTk_InternAtom\fR and \fBTk_GetAtomName\fR
diff --git a/doc/Name.3 b/doc/Name.3
index e6cc727..6d1fdbf 100644
--- a/doc/Name.3
+++ b/doc/Name.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: Name.3,v 1.5 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: Name.3,v 1.6 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_Name 3 "" Tk "Tk Library Procedures"
@@ -55,9 +55,17 @@ The \fBTk_PathName\fR macro returns a
 hierarchical name for \fItkwin\fR.
 Path names have a structure similar to file names in Unix but with
 dots between elements instead of slashes:  the main window for
-an application has the path name ``.'';  its children have names like
-``.a'' and ``.b''; their children have names like ``.a.aa'' and
-``.b.bb''; and so on.  A window is considered to be a child of
+an application has the path name
+.QW . ;
+its children have names like
+.QW .a
+and
+.QW .b ;
+their children have names like
+.QW .a.aa
+and
+.QW .b.bb ;
+and so on.  A window is considered to be a child of
 another window for naming purposes if the second window was named
 as the first window's \fIparent\fR when the first window was created.
 This is not always the same as the X window hierarchy.  For
diff --git a/doc/ParseArgv.3 b/doc/ParseArgv.3
index de4feb7..c31bc1b 100644
--- a/doc/ParseArgv.3
+++ b/doc/ParseArgv.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: ParseArgv.3,v 1.6 2007/01/05 00:00:48 nijtmans Exp $
+'\" RCS: @(#) $Id: ParseArgv.3,v 1.7 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_ParseArgv 3 "" Tk "Tk Library Procedures"
@@ -79,7 +79,10 @@ typedef struct {
     char *\fIhelp\fR;
 } Tk_ArgvInfo;
 .CE
-The \fIkey\fR field is a string such as ``\-display'' or ``\-bg''
+The \fIkey\fR field is a string such as
+.QW \-display
+or
+.QW \-bg
 that is compared with the values in \fIargv\fR.  \fIType\fR
 indicates how to process an argument that matches \fIkey\fR
 (more on this below).  \fISrc\fR and \fIdst\fR are additional
@@ -104,11 +107,13 @@ skipped and returned to the caller.
 .PP
 Once a matching argument specifier is found, \fBTk_ParseArgv\fR
 processes the argument according to the \fItype\fR field of the
-specifier.  The argument that matched \fIkey\fR is called ``the matching
-argument'' in the descriptions below.  As part of the processing,
+specifier.  The argument that matched \fIkey\fR is called
+.QW "the matching argument"
+in the descriptions below.  As part of the processing,
 \fBTk_ParseArgv\fR may also use the next argument in \fIargv\fR
-after the matching argument, which is called ``the following
-argument''.  The legal values for \fItype\fR, and the processing
+after the matching argument, which is called
+.QW "the following argument" .
+The legal values for \fItype\fR, and the processing
 that they cause, are as follows:
 .TP
 \fBTK_ARGV_END\fR
@@ -123,8 +128,11 @@ The matching argument is discarded.
 .TP
 \fBTK_ARGV_INT\fR
 The following argument must contain an
-integer string in the format accepted by \fBstrtol\fR (e.g. ``0''
-and ``0x'' prefixes may be used to specify octal or hexadecimal
+integer string in the format accepted by \fBstrtol\fR (e.g.
+.QW 0
+and
+.QW 0x
+prefixes may be used to specify octal or hexadecimal
 numbers, respectively).  \fIDst\fR is treated as a pointer to an
 integer;  the following argument is converted to an integer value
 and stored at \fI*dst\fR.  \fISrc\fR is ignored.  The matching
@@ -345,7 +353,10 @@ prog -of out200 infile    # sets fileName to reference "out200"
 prog -XN 10 infile        # sets the debug flag, also sets numReps
 .CE
 In all of the above examples, \fIargc\fR will be set by \fBTk_ParseArgv\fR to 2,
-\fIargv\fR[0] will be ``prog'', \fIargv\fR[1] will be ``infile'',
+\fIargv\fR[0] will be
+.QW prog ,
+\fIargv\fR[1] will be
+.QW infile ,
 and \fIargv\fR[2] will be NULL.
 
 .SH KEYWORDS
diff --git a/doc/RestrictEv.3 b/doc/RestrictEv.3
index abf231f..f5e3252 100644
--- a/doc/RestrictEv.3
+++ b/doc/RestrictEv.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: RestrictEv.3,v 1.3 2004/09/19 16:05:36 dkf Exp $
+'\" RCS: @(#) $Id: RestrictEv.3,v 1.4 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_RestrictEvents 3 "" Tk "Tk Library Procedures"
@@ -71,7 +71,8 @@ bindings with the \fBbind\fR Tcl command or by calling
 The main place where \fBTk_RestrictEvents\fR must be used is when
 performing synchronous actions (for example, if you need to wait
 for a particular event to occur on a particular window but you don't
-want to invoke any handlers for any other events).  The ``obvious''
+want to invoke any handlers for any other events).  The
+.QW obvious
 solution in these situations is to call \fBXNextEvent\fR or
 \fBXWindowEvent\fR, but these procedures cannot be used because
 Tk keeps its own event queue that is separate from the X event
diff --git a/doc/SetAppName.3 b/doc/SetAppName.3
index 9a93185..2f0b44c 100644
--- a/doc/SetAppName.3
+++ b/doc/SetAppName.3
@@ -5,13 +5,13 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: SetAppName.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: SetAppName.3,v 1.5 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_SetAppName 3 4.0 Tk "Tk Library Procedures"
 .BS
 .SH NAME
-Tk_SetAppName \- Set the name of an application for ``send'' commands
+Tk_SetAppName \- Set the name of an application for `send' commands
 .SH SYNOPSIS
 .nf
 \fB#include <tk.h>\fR
@@ -37,7 +37,8 @@ display will be able to use the \fBsend\fR command to invoke operations
 in the application.
 If \fIname\fR is already in use by some other application on the
 display, then a new name will be generated by appending
-``\fB #2\fR'' to \fIname\fR;  if this name is also in use,
+.QW "\fB #2\fR"
+to \fIname\fR;  if this name is also in use,
 the number will be incremented until an unused name is found.
 The return value from the procedure is a pointer to the name actually
 used.
diff --git a/doc/SetOptions.3 b/doc/SetOptions.3
index 4e94bfc..6e25930 100644
--- a/doc/SetOptions.3
+++ b/doc/SetOptions.3
@@ -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: SetOptions.3,v 1.13 2007/01/05 00:00:49 nijtmans Exp $
+'\" RCS: @(#) $Id: SetOptions.3,v 1.14 2007/10/24 14:32:57 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_SetOptions 3 8.1 Tk "Tk Library Procedures"
@@ -95,10 +95,12 @@ options are supported, these procedures handle all the details of
 parsing options and storing their values into a C structure associated
 with the widget or object. The procedures were designed primarily for
 widgets in Tk, but they can also be used for other kinds of objects that
-have configuration options.  In the rest of this manual page ``widget'' will
-be used to refer to the object whose options are being managed; in
-practice the object may not actually be a widget.  The term ``widget
-record'' is used to refer to the C-level structure in
+have configuration options.  In the rest of this manual page
+.QW widget
+will be used to refer to the object whose options are being managed; in
+practice the object may not actually be a widget.  The term
+.QW "widget record"
+is used to refer to the C-level structure in
 which information about a particular widget or object is stored.
 .PP
 Note: the easiest way to learn how to use these procedures is to
diff --git a/doc/StrictMotif.3 b/doc/StrictMotif.3
index ab80c33..f7209d3 100644
--- a/doc/StrictMotif.3
+++ b/doc/StrictMotif.3
author	dkf <donal.k.fellows@manchester.ac.uk>	2007-10-24 14:32:55 (GMT)
committer	dkf <donal.k.fellows@manchester.ac.uk>	2007-10-24 14:32:55 (GMT)
commit	a9b41e61dd1f2274961a88385d433a9bac66d44a (patch)
tree	09cfb7c149cd2c0c95d126aa8764f569b3e42063
parent	5d96c35c08ea64525de7b4ab99171bfcc0252142 (diff)
download	tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.zip tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.tar.gz tk-a9b41e61dd1f2274961a88385d433a9bac66d44a.tar.bz2