From 8cf3e7964b95b65ef9cca59cda9e0f7430669fc2 Mon Sep 17 00:00:00 2001 From: dkf Date: Fri, 20 Aug 2004 10:56:35 +0000 Subject: Spelling and grammar fixes from Mikhail Kolesnitchenko. [Patch 1012083] --- ChangeLog | 4 ++++ doc/bind.n | 24 ++++++++++++------------ doc/chooseDirectory.n | 4 ++-- doc/event.n | 6 +++--- doc/getOpenFile.n | 8 ++++---- doc/grid.n | 10 +++++----- doc/pack.n | 4 ++-- doc/place.n | 4 ++-- 8 files changed, 34 insertions(+), 30 deletions(-) diff --git a/ChangeLog b/ChangeLog index c75f934..d2893c0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2004-08-20 Donal K. Fellows + * doc/place.n, doc/pack.n, doc/grid.n, doc/getOpenFile.n: + * doc/event.n, doc/chooseDirectory.n, doc/bind.n: + Spelling and grammar fixes from Mikhail Kolesnitchenko. [Patch 1012083] + * tests/canvas.test (canvas-17.1): Report the result of the test so that it can be compared. [Bug 1012331] diff --git a/doc/bind.n b/doc/bind.n index 7fe0004..d89c601 100644 --- a/doc/bind.n +++ b/doc/bind.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: bind.n,v 1.15 2004/07/05 21:21:52 dkf Exp $ +'\" RCS: @(#) $Id: bind.n,v 1.16 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH bind n 8.0 Tk "Tk Built-In Commands" @@ -135,9 +135,9 @@ If no modifiers are specified, then any combination of modifiers may be present in the event. .PP \fBMeta\fR and \fBM\fR refer to whichever of the -\fBM1\fR through \fBM5\fR modifiers is associated with the meta +\fBM1\fR through \fBM5\fR modifiers is associated with the Meta key(s) on the keyboard (keysyms \fBMeta_R\fR and \fBMeta_L\fR). -If there are no meta keys, or if they are not associated with any +If there are no Meta keys, or if they are not associated with any modifiers, then \fBMeta\fR and \fBM\fR will not match any events. Similarly, the \fBAlt\fR modifier refers to whichever modifier is associated with the alt key(s) on the keyboard (keysyms @@ -198,14 +198,14 @@ active. Likewise, the \fBDeactive\fR event is sent when the window's state changes from active to deactive. There are no useful percent substitutions you would make when binding to these events. .IP \fBMouseWheel\fR 5 -Some mice on the Windows platform support a mouse wheel which is used +Many contemporary mice support a mouse wheel, which is used for scrolling documents without using the scrollbars. By rolling the wheel, the system will generate \fBMouseWheel\fR events that the application can use to scroll. Like \fBKey\fR events the event is always routed to the window that currently has focus. When the event is received you can use the \fB%D\fR substitution to get the -\fIdelta\fR field for the event which is a integer value of motion -that the mouse wheel has moved. The smallest value for which the +\fIdelta\fR field for the event, which is a integer value describing how +the mouse wheel has moved. The smallest value for which the system will report is defined by the OS. On Windows 95 & 98 machines this value is at least 120 before it is reported. However, higher resolution devices may be available in the future. The sign of the @@ -327,7 +327,7 @@ They are included for completeness. A \fBCirculate\fP event indicates that the window has moved to the top or to the bottom of the stacking order as -a result of a \fBXCirculateSubwindows\fP protocol request. +a result of an \fBXCirculateSubwindows\fP protocol request. Note that the stacking order may be changed for other reasons which do not generate a \fBCirculate\fP event, and that Tk does not use \fBXCirculateSubwindows()\fP internally. @@ -356,7 +356,7 @@ they include all the alphanumeric ASCII characters (e.g. ``a'' is the keysym for the ASCII character ``a''), plus descriptions for non-alphanumeric characters (``comma'' is the keysym for the comma character), plus descriptions for all the non-ASCII keys on the -keyboard (``Shift_L'' is the keysm for the left shift key, and +keyboard (``Shift_L'' is the keysym for the left shift key, and ``F1'' is the keysym for the F1 function key, if it exists). The complete list of keysyms is not presented here; it is available in other X documentation and may vary from system to @@ -396,7 +396,7 @@ types. The \fIabove\fR field from the event, formatted as a hexadecimal number. Valid only for \fBConfigure\fR events. -Inidicates the sibling window immediately below the receiving window +Indicates the sibling window immediately below the receiving window in the stacking order, or \fB0\fP if the receiving window is at the bottom. .IP \fB%b\fR 5 @@ -438,7 +438,7 @@ window is the focus window or a descendant of the focus window, The \fIheight\fR field from the event. Valid for the \fBConfigure\fR, \fBConfigureRequest\fR, \fBCreate\fR, \fBResizeRequest\fR, and \fBExpose\fR events. -Inidicates the new or requested height of the window. +Indicates the new or requested height of the window. .VE .IP \fB%i\fR 5 The \fIwindow\fR field from the event, represented as a hexadecimal @@ -478,7 +478,7 @@ the last server reset) in milliseconds, when the event occurred. Valid for most events. .IP \fB%w\fR 5 The \fIwidth\fR field from the event. -Inidicates the new or requested width of the window. +Indicates the new or requested width of the window. Valid only for .VS \fBConfigure\fR, \fBConfigureRequest\fR, \fBCreate\fR, @@ -493,7 +493,7 @@ relative to the receiving window. For \fBEnter\fP and \fBLeave\fP events, the position where the mouse pointer crossed the window, relative to the receiving window. For \fBConfigure\fP and \fBCreate\fP requests, the \fIx\fP and \fIy\fP -cooredinates of the window relative to its parent window. +coordinates of the window relative to its parent window. .IP \fB%A\fR 5 Substitutes the UNICODE character corresponding to the event, or the empty string if the event doesn't correspond to a UNICODE character diff --git a/doc/chooseDirectory.n b/doc/chooseDirectory.n index ad9cf75..e0d7882 100644 --- a/doc/chooseDirectory.n +++ b/doc/chooseDirectory.n @@ -2,7 +2,7 @@ '\" Copyright (c) 1998-2000 by Scriptics Corporation. '\" All rights reserved. '\" -'\" RCS: @(#) $Id: chooseDirectory.n,v 1.2 2004/06/21 14:19:38 dkf Exp $ +'\" RCS: @(#) $Id: chooseDirectory.n,v 1.3 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH tk_chooseDirectory n 8.3 Tk "Tk Built-In Commands" @@ -40,7 +40,7 @@ Specifies a string to display as the title of the dialog box. If this option is not specified, then a default title will be displayed. .TP \fB\-mustexist\fR \fIboolean\fR -Specifies whether the user may specify non-existant directories. If +Specifies whether the user may specify non-existent directories. If this parameter is true, then the user may only select directories that already exist. The default value is \fIfalse\fR. .SH EXAMPLE diff --git a/doc/event.n b/doc/event.n index 13f243a..c74b483 100644 --- a/doc/event.n +++ b/doc/event.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: event.n,v 1.8 2004/06/18 21:18:37 dkf Exp $ +'\" RCS: @(#) $Id: event.n,v 1.9 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH event n 8.3 Tk "Tk Built-In Commands" @@ -196,7 +196,7 @@ Valid for \fBKeyPress\fR, \fBKeyRelease\fR, \fBButtonPress\fR, events. Corresponds to the \fB%X\fR substitution for binding scripts. .TP \fB\-rooty\fI coord\fR -\fICoord\fR must be a screen distance; it specifies th \fIy_root\fR +\fICoord\fR must be a screen distance; it specifies the \fIy_root\fR field for the event. Valid for \fBKeyPress\fR, \fBKeyRelease\fR, \fBButtonPress\fR, \fBButtonRelease\fR, \fBEnter\fR, \fBLeave\fR, and \fBMotion\fR @@ -204,7 +204,7 @@ events. Corresponds to the \fB%Y\fR substitution for binding scripts. .TP \fB\-sendevent\fI boolean\fR -\fBBoolean\fR must be a boolean value; it specifies the \fIsend_event\fR +\fIBoolean\fR must be a boolean value; it specifies the \fIsend_event\fR field for the event. Valid for all events. Corresponds to the \fB%E\fR substitution for binding scripts. .TP diff --git a/doc/getOpenFile.n b/doc/getOpenFile.n index 09106a8..a049b0a 100644 --- a/doc/getOpenFile.n +++ b/doc/getOpenFile.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: getOpenFile.n,v 1.11 2004/03/25 12:12:36 vincentdarley Exp $ +'\" RCS: @(#) $Id: getOpenFile.n,v 1.12 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH tk_getOpenFile n 4.2 Tk "Tk Built-In Commands" @@ -24,7 +24,7 @@ The procedures \fBtk_getOpenFile\fR and \fBtk_getSaveFile\fR pop up a dialog box for the user to select a file to open or save. The \fBtk_getOpenFile\fR command is usually associated with the \fBOpen\fR command in the \fBFile\fR menu. Its purpose is for the user to select an -existing file \fIonly\fR. If the user enters an non-existent file, the +existing file \fIonly\fR. If the user enters a non-existent file, the dialog box gives the user an error prompt and requires the user to give an alternative selection. If an application allows the user to create new files, it should do so by providing a separate \fBNew\fR menu command. @@ -39,7 +39,7 @@ arguments to these two commands: .TP \fB\-defaultextension\fR \fIextension\fR Specifies a string that will be appended to the filename if the user -enters a filename without an extension. The defaut value is the empty +enters a filename without an extension. The default value is the empty string, which means no extension will be appended to the filename in any case. This option is ignored on the Macintosh platform, which does not require extensions to filenames, @@ -144,7 +144,7 @@ card characters (* and ?). Due to the different pattern matching rules on the various platforms, to ensure portability, wild card characters are not allowed in the extensions, except as in the special extension *. Extensions -without a full stop character (e.g, ~) are allowed but may not +without a full stop character (e.g. ~) are allowed but may not work on all platforms. .SH EXAMPLE diff --git a/doc/grid.n b/doc/grid.n index fc0d6aa..da9800a 100644 --- a/doc/grid.n +++ b/doc/grid.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: grid.n,v 1.10 2004/06/21 14:41:42 dkf Exp $ +'\" RCS: @(#) $Id: grid.n,v 1.11 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH grid n 8.5 Tk "Tk Built-In Commands" @@ -84,7 +84,7 @@ grid geometry manager requests a size from the containing window. If only an option is specified, with no value, the current value of that option is returned. If only the master window and index is specified, all the current settings -are returned in an list of "-option value" pairs. +are returned in a list of "-option value" pairs. .TP \fBgrid configure \fIslave \fR?\fIslave ...\fR? ?\fIoptions\fR? The arguments consist of the names of one or more slave windows @@ -126,7 +126,7 @@ It defaults to 0. .TP \fB\-ipady \fIamount\fR The \fIamount\fR specifies how much vertical internal padding to -leave on on the top and bottom of the slave(s). +leave on the top and bottom of the slave(s). This space is added inside the slave(s) border. The \fIamount\fR defaults to 0. .TP @@ -244,7 +244,7 @@ grid geometry manager requests a size from the containing window. If only an option is specified, with no value, the current value of that option is returned. If only the master window and index is specified, all the current settings -are returned in an list of "-option value" pairs. +are returned in a list of "-option value" pairs. .TP \fBgrid remove \fIslave \fR?\fIslave ...\fR? Removes each of the \fIslave\fRs from grid for its @@ -349,7 +349,7 @@ For masters whose size is smaller than the requested layout, space is taken away from columns and rows according to their weights. However, once a column or row shrinks to its minsize, its weight is taken to be zero. If more space needs to be removed from a layout than would be permitted, as -when all the rows or columns are at there minimum sizes, the layout is +when all the rows or columns are at their minimum sizes, the layout is placed and clipped according to the \fIanchor\fR value. .VE .SH "GEOMETRY PROPAGATION" diff --git a/doc/pack.n b/doc/pack.n index 0d9956c..e3122ef 100644 --- a/doc/pack.n +++ b/doc/pack.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: pack.n,v 1.5 2004/07/01 08:06:15 dkf Exp $ +'\" RCS: @(#) $Id: pack.n,v 1.6 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH pack n 4.0 Tk "Tk Built-In Commands" @@ -108,7 +108,7 @@ of two values to specify padding for left and right separately. \fB\-pady \fIamount\fR \fIAmount\fR specifies how much vertical external padding to leave on each side of the slave(s). \fIAmount\fR may be a list -of two values to specify padding for top and bottom separtely. +of two values to specify padding for top and bottom separately. \fIAmount\fR defaults to 0. .TP \fB\-side \fIside\fR diff --git a/doc/place.n b/doc/place.n index 3697fab..c2fb9de 100644 --- a/doc/place.n +++ b/doc/place.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: place.n,v 1.6 2004/07/01 08:06:15 dkf Exp $ +'\" RCS: @(#) $Id: place.n,v 1.7 2004/08/20 10:56:36 dkf Exp $ '\" .so man.macros .TH place n "" Tk "Tk Built-In Commands" @@ -96,7 +96,7 @@ If \fIsize\fR is an empty string, or if no \fB\-height\fR or internally by the window will be used. .TP \fB\-in \fImaster\fR -\fIMaster\fR specifes the path name of the window relative +\fIMaster\fR specifies the path name of the window relative to which \fIwindow\fR is to be placed. \fIMaster\fR must either be \fIwindow\fR's parent or a descendant of \fIwindow\fR's parent. -- cgit v0.12