From 0ee05109607d9b4366039240f05a7d1d096f5d58 Mon Sep 17 00:00:00 2001 From: ericm Date: Mon, 24 Apr 2000 19:00:13 +0000 Subject: * unix/mkLinks: * doc/AddOption.3: Man page for Tk_AddOption [Bug: 1854] --- ChangeLog | 42 ++++++++++++++++++++++++++++------------ doc/AddOption.3 | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ unix/mkLinks | 4 ++++ 3 files changed, 94 insertions(+), 12 deletions(-) create mode 100644 doc/AddOption.3 diff --git a/ChangeLog b/ChangeLog index b575980..08c871c 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,19 +1,37 @@ +2000-04-24 Eric Melski + + * unix/mkLinks: + * doc/AddOption.3: Man page for Tk_AddOption [Bug: 1854] + +2000-04-19 Eric Melski + + * doc/WinViewable.3: + * unix/mkLinks: Removed docs for Tk_IsViewable. + + * win/tkWinDialog.c: Removed calls to Tk_IsViewable. + + * generic/tkUtil.c: + * generic/tkStubInit.c: + * generic/tkDecls.h: + * generic/tkCmds.c: + * generic/tk.decls: Removed Tk_IsViewable function (it was not + actually needed). + 2000-04-22 Jim Ingham - * mac/tkMacDialog.c (Tk_MacGetOpenFile): Add empty bodies for the - "-initialfile" and "-defaultextension" options. - - * mac/tkMacDialog.c (NavServicesGetFile): Only cons the result up into - a list if multiple is true. - - * mac/tkMacMenus.c (SourceDialog): Use the "tk_getOpenFile" instead of hand-coding - the dialog with StandardGetFile. This way we get the Navigation dialogs for - free. + * mac/tkMacDialog.c (Tk_MacGetOpenFile): Add empty bodies for the + "-initialfile" and "-defaultextension" options. - * doc/getOpenFile.n: Document the -multiple and -message flags which are only - implemented on the Mac. Also note that the -title works on the Mac with - Nav Services installed. + * mac/tkMacDialog.c (NavServicesGetFile): Only cons the result up into + a list if multiple is true. + * mac/tkMacMenus.c (SourceDialog): Use the "tk_getOpenFile" + instead of hand-coding the dialog with StandardGetFile. This way + we get the Navigation dialogs for free. + + * doc/getOpenFile.n: Document the -multiple and -message flags + which are only implemented on the Mac. Also note that the -title + works on the Mac wit Nav Services installed. 2000-04-19 Jeff Hobbs diff --git a/doc/AddOption.3 b/doc/AddOption.3 new file mode 100644 index 0000000..d6c7ca5 --- /dev/null +++ b/doc/AddOption.3 @@ -0,0 +1,60 @@ +'\" +'\" Copyright (c) 1998-2000 by Scriptics Corporation. +'\" All rights reserved. +'\" +'\" RCS: @(#) $Id: AddOption.3,v 1.1 2000/04/24 19:00:14 ericm 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 \fR +.sp +void +\fBTk_AddOption\fR(\fItkwin, name, value, priority\fR) +.SH ARGUMENTS +.AP Tk_Window tkwin in +Token for window. +.AP char *name in +Multi-element name of option. +.AP 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 TK_MAX_PRIO. Some +common priority values are: +.TP +20 +Used for default values hard-coded into widgets. +.TP +40 +Used for options specified in application-specific startup files. +.TP +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 +80 +Used for options specified interactively after the application starts +running. +.PP + +.SH KEYWORDS +class, name, option, add diff --git a/unix/mkLinks b/unix/mkLinks index 975b639..8c4df6f 100644 --- a/unix/mkLinks +++ b/unix/mkLinks @@ -535,6 +535,10 @@ if test -r GetOption.3; then rm -f Tk_GetOption.3 ln GetOption.3 Tk_GetOption.3 fi +if test -r AddOption.3; then + rm -f Tk_AddOption.3 + ln AddOption.3 Tk_AddOption.3 +fi if test -r SetOptions.3; then rm -f Tk_GetOptionInfo.3 ln SetOptions.3 Tk_GetOptionInfo.3 -- cgit v0.12