summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorericm <ericm>2000-01-27 00:23:10 (GMT)
committerericm <ericm>2000-01-27 00:23:10 (GMT)
commit40b335d9b0c6ca46aa6f5bba4f95528fea233129 (patch)
treee9779997eb2be15e478fc405ca04237abcb9a671 /doc
parent7e47234206a345a0b8dcbe7bd066ed360e4a9942 (diff)
downloadtk-40b335d9b0c6ca46aa6f5bba4f95528fea233129.zip
tk-40b335d9b0c6ca46aa6f5bba4f95528fea233129.tar.gz
tk-40b335d9b0c6ca46aa6f5bba4f95528fea233129.tar.bz2
* doc/getOpenFile.n:
* doc/chooseDirectory.n: Man page/cross links for tk_chooseDirectory (bug #1786). * library/tk.tcl: * library/tclIndex: Added hooks for tk_chooseDirectory. (bug #1786) * library/choosedir.tcl: tk_chooseDirectory implementation for Unix/Mac (bug #1786).
Diffstat (limited to 'doc')
-rw-r--r--doc/chooseDirectory.n52
-rw-r--r--doc/getOpenFile.n5
2 files changed, 56 insertions, 1 deletions
diff --git a/doc/chooseDirectory.n b/doc/chooseDirectory.n
new file mode 100644
index 0000000..42bf636
--- /dev/null
+++ b/doc/chooseDirectory.n
@@ -0,0 +1,52 @@
+'\"
+'\" Copyright (c) 1998-2000 by Scriptics Corporation.
+'\" All rights reserved.
+'\"
+'\" RCS: @(#) $Id: chooseDirectory.n,v 1.1 2000/01/27 00:23:10 ericm Exp $
+'\"
+.so man.macros
+.TH tk_chooseDirectory n 8.3 Tk "Tk Built-In Commands"
+.BS
+'\" Note: do not modify the .SH NAME line immediately below!
+.SH NAME
+tk_chooseDirectory \- pops up a dialog box for the user to select a directory.
+.PP
+.SH SYNOPSIS
+\fBtk_chooseDirectory \fR?\fIoption value ...\fR?
+.BE
+
+.SH DESCRIPTION
+.PP
+The procedure \fBtk_chooseDirectory\fR pops up a dialog box for the
+user to select a directory. The following \fIoption\-value\fR pairs are
+possible as command line arguments:
+.TP
+\fB\-initialdir\fR \fIdirname\fR
+Specifies that the directories in \fIdirectory\fR should be displayed
+when the dialog pops up. If this parameter is not specified, then
+the directories in the current working directory are displayed. If the
+parameter specifies a relative path, the return value will convert the
+relative path to an absolute path. This option may not always work on
+the Macintosh. This is not a bug. Rather, the \fIGeneral Controls\fR
+control panel on the Mac allows the end user to override the
+application default directory.
+.TP
+\fB\-parent\fR \fIwindow\fR
+Makes \fIwindow\fR the logical parent of the dialog. The dialog
+is displayed on top of its parent window.
+.TP
+\fB\-title\fR \fItitleString\fR
+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
+this parameter is true, then the user may only select directories that
+already exist. The default value is \fIfalse\fR.
+.LP
+
+.SH "SEE ALSO"
+tk_getOpenFile, tk_getSaveFile
+
+.SH KEYWORDS
+directory selection dialog
diff --git a/doc/getOpenFile.n b/doc/getOpenFile.n
index 4c19e65..de17086 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.4 1999/12/16 21:57:11 hobbs Exp $
+'\" RCS: @(#) $Id: getOpenFile.n,v 1.5 2000/01/27 00:23:10 ericm Exp $
'\"
.so man.macros
.TH tk_getOpenFile n 4.2 Tk "Tk Built-In Commands"
@@ -152,5 +152,8 @@ if {$filename != ""} {
}
.CE
+.SH "SEE ALSO"
+tk_chooseDirectory
+
.SH KEYWORDS
file selection dialog