diff options
Diffstat (limited to 'doc/option.n')
-rw-r--r-- | doc/option.n | 18 |
1 files changed, 11 insertions, 7 deletions
diff --git a/doc/option.n b/doc/option.n index dd1a644..2763d64 100644 --- a/doc/option.n +++ b/doc/option.n @@ -26,8 +26,8 @@ database or to retrieve options from the database. The \fBadd\fR form of the command adds a new option to the database. \fIPattern\fR contains the option being specified, and consists of names and/or classes -separated by asterisks or dots, in the usual X format (see \fBPATTERN -FORMAT\fR). \fIValue\fR +separated by asterisks or dots, in the usual X format (see +\fBPATTERN FORMAT\fR). \fIValue\fR contains a text string to associate with \fIpattern\fR; this is the value that will be returned in calls to \fBTk_GetOption\fR or by invocations of the \fBoption get\fR command. If \fIpriority\fR @@ -59,26 +59,28 @@ options specified in that file to the option database. If \fIpriority\fR is specified, it indicates the priority level at which to enter the options; \fIpriority\fR defaults to \fBinteractive\fR. .PP +The file is read through a channel which is in "utf-8" encoding, +invalid byte sequences are automatically converted to valid ones. +This means that encodings like ISO 8859-1 or cp1252 with high +probability will work as well, but this cannot be guaranteed. +This cannot be changed, setting the [encoding system] has no effect. +.PP The \fIpriority\fR arguments to the \fBoption\fR command are normally specified symbolically using one of the following values: .TP \fBwidgetDefault\fR -. Level 20. Used for default values hard-coded into widgets. .TP \fBstartupFile\fR -. Level 40. Used for options specified in application-specific startup files. .TP \fBuserDefault\fR -. Level 60. Used for options specified in user-specific defaults files, such as \fB.Xdefaults\fR, resource databases loaded into the X server, or user-specific startup files. .TP \fBinteractive\fR -. Level 80. Used for options specified interactively after the application starts running. If \fIpriority\fR is not specified, it defaults to this level. @@ -113,8 +115,10 @@ first word of the pattern is matched against the name and class of the .QW \fB.\fR \fBtoplevel\fR, which are usually set by options to \fBwish\fR. .SH EXAMPLES +.PP Instruct every button in the application to have red text on it unless -explicitly overridden (note that on some platforms the option is ignored): +explicitly overridden, by setting the \fBforeground\fR for the \fBButton\fR +class (note that on some platforms the option is ignored): .CS \fBoption add\fR *Button.foreground red startupFile .CE |