head	1.7;
access;
symbols
	core-8-5-9:1.6
	core-8-5-8:1.6
	macosx-cocoa-merge:1.7
	macosx-cocoa-premerge:1.7
	macosx-carbon-freeze:1.7
	core-8-5-7:1.6
	core-8-5-6:1.6
	core-8-6-b1:1.7
	core-8-6-a3:1.7
	core-8-5-5:1.6
	core-8-6-a2:1.7
	core-8-5-4:1.6
	core-8-5-3:1.6
	core-8-6-a1:1.6
	core-8-4-19:1.2
	core-8-5-branch:1.6.0.2
	core-8-5-2:1.6
	core-8-4-18:1.2
	core-8-5-1:1.6
	core-8-4-17:1.2
	core-8-5-0:1.6
	core-8-5-b3:1.4
	core-8-5-b2:1.4
	core-8-4-16:1.2
	core-8-5-b1:1.4
	core-stablilizer-merge:1.4
	core-stabilizer-branch:1.4.0.2
	core-stabilizer-merge:1.6
	core-8-4-15:1.2
	core-8-5-a6:1.4
	core-8-5-a5:1.3
	core-8-4-14:1.2
	core-8-5-a4:1.3
	core-8-4-13:1.2
	core-8-4-12:1.2
	core-8-4-11:1.2
	core-8-5-a3:1.3
	core-8-4-10:1.2
	core-8-4-9-branch:1.2.0.6
	core-8-5-a2:1.3
	core-8-4-9:1.2
	core-8-4-8:1.2
	core-8-4-7:1.2
	core-8-5-a1:1.2
	core-8-4-6:1.2
	core-8-4-5:1.2
	mistachkin-dev-branch:1.2.0.4
	core-8-4-4:1.2
	core-8-4-3:1.2
	core-8-4-branch:1.2.0.2
	core-8-4-2:1.2
	core-8-4-1:1.2
	core-8-3-5:1.1
	core-8-4-0:1.2
	macosx-8-4-merge-2002-08-31-trunk:1.2
	macosx-8-4-premerge-2002-08-31-branch:1.1.8.1
	macosx-8-4-premerge-2002-08-31-trunk:1.2
	macosx-8-4-merge-2002-08-30-branch:1.1.8.1
	macosx-8-4-merge-2002-08-30-trunk:1.2
	macosx-8-4-merge-2002-08-20-branch:1.1.8.1
	macosx-8-4-merge-2002-08-20-trunk:1.2
	core-8-4-b2:1.2
	core-8-4-b1:1.2
	macosx-premerge-6-9-02:1.1.8.1
	core-8-4-a4:1.2
	core-8-3-4:1.1
	macosx-8-4-branch:1.1.0.8
	macosx-8-4-branchpoint:1.1
	core-8-4-a3:1.1
	core-8-3-3:1.1
	dgp-privates-into-namespace:1.1.0.6
	tclpro-1-5-0:1.1
	core-8-4-win-speedup:1.1.0.4
	core-8-4-a2:1.1
	tclpro-1-4-1:1.1
	tclpro-1-4-0:1.1
	core-8-3-2:1.1
	ajuba-ajuba2-2-1-base:1.1
	ajuba-ajuba2-2-0:1.1
	core-8-4-a1:1.1
	core-8-3-1-branch:1.1.0.2
	core-8-3-1:1.1;
locks; strict;
comment	@.\" @;


1.7
date	2008.06.30.22.57.00;	author dkf;	state Exp;
branches;
next	1.6;

1.6
date	2007.12.13.15.23.42;	author dgp;	state Exp;
branches;
next	1.5;

1.5
date	2007.12.10.16.21.48;	author jenglish;	state Exp;
branches;
next	1.4;

1.4
date	2007.01.05.00.00.49;	author nijtmans;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2004.09.19.16.05.36;	author dkf;	state Exp;
branches;
next	1.2;

1.2
date	2002.01.25.21.09.36;	author dgp;	state Exp;
branches;
next	1.1;

1.1
date	2000.04.24.19.00.14;	author ericm;	state Exp;
branches
	1.1.4.1
	1.1.8.1;
next	;

1.1.4.1
date	2002.04.02.20.57.52;	author hobbs;	state Exp;
branches;
next	;

1.1.8.1
date	2002.02.05.02.25.13;	author wolfsuit;	state Exp;
branches;
next	;

1.4.2.1
date	2007.12.10.18.39.27;	author dgp;	state Exp;
branches;
next	;


desc
@@


1.7
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\" 
'\" RCS: @@(#) $Id: AddOption.3,v 1.6 2007/12/13 15:23:42 dgp Exp $
'\" 
'\"
.so man.macros
.TH Tk_AddOption 3 "" Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_AddOption \- Add an option to the option database
.SH SYNOPSIS
.nf
\fB#include <tk.h>\fR
.sp
void
\fBTk_AddOption\fR(\fItkwin, name, value, priority\fR)
.SH ARGUMENTS
.AP Tk_Window tkwin in
Token for window.
.AP "const char" *name in
Multi-element name of option.
.AP "const char" *value in
Value of option.
.AP int priority in
Overall priority level to use for option.
.BE
.SH DESCRIPTION
.PP
This procedure is invoked to add an option to the database
associated with \fItkwin\fR's main window.  \fIName\fR
contains the option being specified and consists of names and/or
classes separated by asterisks or dots, in the usual X format.
\fIValue\fR contains the text string to associate with \fIname\fR;
this value will be returned in calls to \fBTk_GetOption\fR.
\fIPriority\fR specifies the priority of the value; when options are
queried using \fBTk_GetOption\fR, the value with the highest priority
is returned.  \fIPriority\fR must be between 0 and \fBTK_MAX_PRIO\fR.  Some
common priority values are:
.IP 20
Used for default values hard-coded into widgets.
.IP 40
Used for options specified in application-specific startup files.
.IP 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.
.IP 80
Used for options specified interactively after the application starts
running.
.SH KEYWORDS
class, name, option, add
@


1.6
log
@merge stable branch onto HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.4.2.1 2007/12/10 18:39:27 dgp Exp $
a28 1

a51 1

@


1.5
log
@Various markup fixes
(mostly: missing quotes on .SH arguments, extraneous .PPs)
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
@


1.4
log
@various "const" additions, in line with TIP #27
fix bug #1627732
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.3 2004/09/19 16:05:36 dkf Exp $
d42 1
a42 2
.TP
20
d44 1
a44 2
.TP
40
d46 1
a46 2
.TP
60
d50 1
a50 2
.TP
80
a52 1
.PP
@


1.4.2.1
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.4 2007/01/05 00:00:49 nijtmans Exp $
d42 2
a43 1
.IP 20
d45 2
a46 1
.IP 40
d48 2
a49 1
.IP 60
d53 2
a54 1
.IP 80
d57 1
@


1.3
log
@Standardize style of section refs & public symbols. Remove displayed tabs
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.2 2002/01/25 21:09:36 dgp Exp $
d22 1
a22 1
.AP "CONST char" *name in
d24 1
a24 1
.AP "CONST char" *value in
@


1.2
log
@	* Updated callers of Tcl_SplitList and Tcl_Merge.
	* Updated callers of Tcl_GetStringResult.
	  Rewrote PrintScrollFractions to ScrollFractions to stop scribbling
	  directly on interp->result.
	* Updated callers of Tcl_GetVar, Tcl_GetVar2
	* Updated callers of Tcl_SplitPath, Tcl_JoinPath, and
	  Tcl_TranslateFileName.
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.1 2000/04/24 19:00:14 ericm Exp $
d40 1
a40 1
is returned.  \fIPriority\fR must be between 0 and TK_MAX_PRIO.  Some
@


1.1
log
@* unix/mkLinks:
* doc/AddOption.3: Man page for Tk_AddOption [Bug: 1854]
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id$
d22 1
a22 1
.AP char *name in
d24 1
a24 1
.AP char *value in
@


1.1.4.1
log
@sync with head
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.2 2002/01/25 21:09:36 dgp Exp $
d22 1
a22 1
.AP "CONST char" *name in
d24 1
a24 1
.AP "CONST char" *value in
@


1.1.8.1
log
@Merge with current TOT
Added support for the wm stackorder command
Fixed crash when selecting Menu items in the Application menu that we didn't
put there.
Added first bits of the use of CG for low-level drawing.  The line-drawing works,
the rest doesn't yet.  You have to set the file static useCGDrawing to 1 and
rebuild to activate this code.
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: AddOption.3,v 1.1 2000/04/24 19:00:14 ericm Exp $
d22 1
a22 1
.AP "CONST char" *name in
d24 1
a24 1
.AP "CONST char" *value in
@


