Lots of improvements to look and feel of manual pages

1 files changed, 39 insertions, 16 deletions

diff --git a/doc/font.n b/doc/font.n
index 66c031f..867f11e 100644
--- a/doc/font.n
+++ b/doc/font.n
@@ -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: font.n,v 1.15 2007/10/23 14:07:44 das Exp $
+'\" RCS: @(#) $Id: font.n,v 1.16 2007/10/24 14:32:58 dkf Exp $
 '\" 
 .so man.macros
 .TH font n 8.0 Tk "Tk Built-In Commands"
@@ -84,7 +84,9 @@ Measures the amount of space the string \fItext\fR would use in the given
 see FONT DESCRIPTIONS below.  If the \fIwindow\fR argument is omitted, it
 defaults to the main window.  The return value is the total width in pixels
 of \fItext\fR, not including the extra pixels used by highly exaggerated
-characters such as cursive ``f''.  If the string contains newlines or tabs,
+characters such as cursive
+.QW f .
+If the string contains newlines or tabs,
 those characters are not expanded or treated specially when measuring the
 string.
 .TP
@@ -118,9 +120,10 @@ font will be substituted automatically.
 [2] \fIsystemfont\fR
 .
 The platform-specific name of a font, interpreted by the graphics server.
-This also includes, under X, an XLFD (see [4]) for which a single ``\fB*\fR''
+This also includes, under X, an XLFD (see [4]) for which a single
+.QW \fB*\fR
 character was used to elide more than one field in the middle of the
-name.  See PLATFORM-SPECIFIC issues for a list of the system fonts.
+name.  See \fBPLATFORM-SPECIFIC\fR issues for a list of the system fonts.
 .TP
 [3] \fIfamily \fR?\fIsize\fR? ?\fIstyle\fR? ?\fIstyle ...\fR?
 .
@@ -142,14 +145,22 @@ underline	overstrike\fR
 .
 A Unix-centric font name of the form
 \fI-foundry-family-weight-slant-setwidth-addstyle-pixel-point-resx-resy-spacing-width-charset-encoding\fR.
-The ``\fB*\fR'' character may be used to skip individual fields that the
-user does not care about.  There must be exactly one ``\fB*\fR'' for each
-field skipped, except that a ``\fB*\fR'' at the end of the XLFD skips any
-remaining fields; the shortest valid XLFD is simply ``\fB*\fR'', signifying
+The
+.QW \fB*\fR
+character may be used to skip individual fields that the
+user does not care about.  There must be exactly one
+.QW \fB*\fR
+for each field skipped, except that a
+.QW \fB*\fR
+at the end of the XLFD skips any
+remaining fields; the shortest valid XLFD is simply
+.QW \fB*\fR ,
+signifying
 all fields as defaults.  Any fields that were skipped are given default
 values.  For compatibility, an XLFD always chooses a font of the specified
 pixel size (not point size); although this interpretation is not strictly
-correct, all existing applications using XLFDs assumed that one ``point''
+correct, all existing applications using XLFDs assumed that one
+.QW point
 was in fact one pixel and would display incorrectly (generally larger) if
 the correct size font were actually used.
 .TP
@@ -173,9 +184,13 @@ an error is generated.
 The following options are used by the \fBfont metrics\fR command to query
 font-specific data determined when the font was created.  These properties are
 for the whole font itself and not for individual characters drawn in that
-font.  In the following definitions, the ``baseline'' of a font is the
+font.  In the following definitions, the
+.QW baseline
+of a font is the
 horizontal line where the bottom of most letters line up; certain letters,
-such as lower-case ``g'' stick below the baseline.
+such as lower-case
+.QW g
+stick below the baseline.
 .TP
 \fB\-ascent        \0\fR
 .
@@ -196,9 +211,13 @@ above the baseline line plus the descent below the baseline.
 .TP
 \fB\-fixed          \0\fR
 .
-Returns a boolean flag that is ``\fB1\fR'' if this is a fixed-width font,
+Returns a boolean flag that is
+.QW \fB1\fR
+if this is a fixed-width font,
 where each normal character is the same width as all the other
-characters, or is ``\fB0\fR'' if this is a proportionally-spaced font, where
+characters, or is
+.QW \fB0\fR
+if this is a proportionally-spaced font, where
 individual characters have different widths.  The widths of control
 characters, tab characters, and other non-printing characters are not
 included when calculating this value.
@@ -210,9 +229,13 @@ above:
 \fB\-family \fIname\fR
 .
 The case-insensitive font family name.  Tk guarantees to support the font
-families named \fBCourier\fR (a monospaced ``typewriter'' font), \fBTimes\fR
-(a serifed ``newspaper'' font), and \fBHelvetica\fR (a sans-serif
-``European'' font).  The most closely matching native font family will
+families named \fBCourier\fR (a monospaced
+.QW typewriter
+font), \fBTimes\fR (a serifed
+.QW newspaper
+font), and \fBHelvetica\fR (a sans-serif
+.QW European
+font).  The most closely matching native font family will
 automatically be substituted when one of the above font families is used.
 The \fIname\fR may also be the name of a native, platform-specific font
 family; in that case it will work as desired on one platform but may not