head	1.13;
access;
symbols
	core-8-5-9:1.11
	core-8-5-8:1.11
	macosx-cocoa-merge:1.13
	macosx-cocoa-premerge:1.13
	macosx-carbon-freeze:1.13
	core-8-5-7:1.11
	core-8-5-6:1.11
	core-8-6-b1:1.13
	core-8-6-a3:1.13
	core-8-5-5:1.11
	core-8-6-a2:1.12
	core-8-5-4:1.11
	core-8-5-3:1.11
	core-8-6-a1:1.11
	core-8-4-19:1.1.10.1
	core-8-5-branch:1.11.0.2
	core-8-5-2:1.11
	core-8-4-18:1.1.10.1
	core-8-5-1:1.11
	core-8-4-17:1.1.10.1
	core-8-5-0:1.11
	core-8-5-b3:1.9
	core-8-5-b2:1.6
	core-8-4-16:1.1.10.1
	core-8-5-b1:1.4
	core-stablilizer-merge:1.4
	core-stabilizer-branch:1.4.0.2
	core-stabilizer-merge:1.11
	core-8-4-15:1.1.10.1
	core-8-5-a6:1.4
	core-8-5-a5:1.4
	core-8-4-14:1.1.10.1
	core-8-5-a4:1.4
	core-8-4-13:1.1.10.1
	core-8-4-12:1.1.10.1
	core-8-4-11:1.1.10.1
	core-8-5-a3:1.4
	core-8-4-10:1.1.10.1
	core-8-4-9-branch:1.1.10.1.0.2
	core-8-5-a2:1.4
	core-8-4-9:1.1.10.1
	core-8-4-8:1.1.10.1
	core-8-4-7:1.1
	core-8-5-a1:1.1
	core-8-4-6:1.1
	core-8-4-5:1.1
	mistachkin-dev-branch:1.1.0.12
	core-8-4-4:1.1
	core-8-4-3:1.1
	core-8-4-branch:1.1.0.10
	core-8-4-2:1.1
	core-8-4-1:1.1
	core-8-3-5:1.1
	core-8-4-0:1.1
	macosx-8-4-merge-2002-08-31-trunk:1.1
	macosx-8-4-premerge-2002-08-31-branch:1.1
	macosx-8-4-premerge-2002-08-31-trunk:1.1
	macosx-8-4-merge-2002-08-30-branch:1.1
	macosx-8-4-merge-2002-08-30-trunk:1.1
	macosx-8-4-merge-2002-08-20-branch:1.1
	macosx-8-4-merge-2002-08-20-trunk:1.1
	core-8-4-b2:1.1
	core-8-4-b1:1.1
	macosx-premerge-6-9-02:1.1
	core-8-4-a4:1.1
	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
	scriptics-sc-2-0-b5:1.1
	scriptics-sc-2-0-fixed:1.1
	scriptics-sc-2-0-b2:1.1
	scriptics-sc-2-0-b1:1.1
	core-8-3-0:1.1;
locks; strict;
comment	@# @;


1.13
date	2008.09.23.13.36.37;	author dkf;	state Exp;
branches;
next	1.12;

1.12
date	2008.06.30.22.57.02;	author dkf;	state Exp;
branches;
next	1.11;

1.11
date	2007.12.13.15.23.43;	author dgp;	state Exp;
branches;
next	1.10;

1.10
date	2007.12.10.16.21.48;	author jenglish;	state Exp;
branches;
next	1.9;

1.9
date	2007.11.04.10.37.50;	author das;	state Exp;
branches;
next	1.8;

1.8
date	2007.10.30.21.29.58;	author dkf;	state Exp;
branches;
next	1.7;

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

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

1.5
date	2007.10.22.14.33.13;	author dkf;	state Exp;
branches;
next	1.4;

1.4
date	2004.10.28.10.22.51;	author dkf;	state Exp;
branches
	1.4.2.1;
next	1.3;

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

1.2
date	2004.06.21.14.19.38;	author dkf;	state Exp;
branches;
next	1.1;

1.1
date	2000.01.27.00.23.10;	author ericm;	state Exp;
branches
	1.1.10.1;
next	;

1.1.10.1
date	2004.10.28.10.19.29;	author dkf;	state Exp;
branches;
next	;

1.4.2.1
date	2007.10.24.12.59.30;	author dgp;	state Exp;
branches;
next	1.4.2.2;

1.4.2.2
date	2007.10.27.04.23.13;	author dgp;	state Exp;
branches;
next	1.4.2.3;

1.4.2.3
date	2007.11.01.16.37.14;	author dgp;	state Exp;
branches;
next	1.4.2.4;

1.4.2.4
date	2007.11.05.14.24.16;	author dgp;	state Exp;
branches;
next	1.4.2.5;

1.4.2.5
date	2007.12.10.18.39.28;	author dgp;	state Exp;
branches;
next	;


desc
@@


1.13
log
@Fix [Bug 2118116]
@
text
@'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\" 
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.12 2008/06/30 22:57:02 dkf 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.
.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.
.TP
\fB\-mustexist\fR \fIboolean\fR
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.
.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. On Mac OS X, this
turns the file dialog into a sheet attached to the 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.
.SH EXAMPLE
.PP
.CS
set dir [\fBtk_chooseDirectory\fR \e
        \-initialdir ~ \-title "Choose a directory"]
if {$dir eq ""} {
   label .l \-text "No directory selected"
} else {
   label .l \-text "Selected $dir"
}
.CE
.SH "SEE ALSO"
tk_getOpenFile(n), tk_getSaveFile(n)
.SH KEYWORDS
directory, selection, dialog, platform-specific
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.12
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.11 2007/12/13 15:23:43 dgp Exp $
d57 3
@


1.11
log
@merge stable branch onto HEAD
@
text
@d1 1
d6 1
a6 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4.2.5 2007/12/10 18:39:28 dgp Exp $
d44 1
a53 1

@


1.10
log
@Various markup fixes
(mostly: missing quotes on .SH arguments, extraneous .PPs)
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.9 2007/11/04 10:37:50 das Exp $
@


1.9
log
@	* doc/chooseDirectory.n:	remove/correct obsolete Mac OS 9-era
	* doc/getOpenFile.n:		information.
	* doc/menu.n:
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.8 2007/10/30 21:29:58 dkf Exp $
a12 1
.PP
@


1.8
log
@More documentation improvements
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.7 2007/10/29 16:04:13 dkf Exp $
d28 1
a28 4
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.
d37 2
a38 1
is displayed on top of its parent window.
@


1.7
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.6 2007/10/26 20:13:23 dgp Exp $
a16 1

d33 5
a44 5
.TP
\fB\-mustexist\fR \fIboolean\fR
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.
@


1.6
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4 2004/10/28 10:22:51 dkf Exp $
d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \\
d51 1
a51 1
   label .l -text "No directory selected"
d53 1
a53 1
   label .l -text "Selected $dir"
@


1.5
log
@Documentation improvements, all minor.
@
text
@d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \e
@


1.4
log
@Assorted minor documentation fixes
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.3 2004/08/20 10:56:36 dkf Exp $
d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \\
@


1.4.2.1
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4 2004/10/28 10:22:51 dkf Exp $
d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \e
@


1.4.2.2
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4.2.1 2007/10/24 12:59:30 dgp Exp $
d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \\
@


1.4.2.3
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id$
d17 1
a33 5
\fB\-mustexist\fR \fIboolean\fR
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.
.TP
d41 5
d48 1
a48 1
set dir [\fBtk_chooseDirectory\fR \e
d51 1
a51 1
   label .l \-text "No directory selected"
d53 1
a53 1
   label .l \-text "Selected $dir"
@


1.4.2.4
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4.2.3 2007/11/01 16:37:14 dgp Exp $
d28 4
a31 1
relative path to an absolute path.
d40 1
a40 2
is displayed on top of its parent window. On Mac OS X, this
turns the file dialog into a sheet attached to the parent window.
@


1.4.2.5
log
@merge updates from HEAD
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.4.2.4 2007/11/05 14:24:16 dgp Exp $
d13 1
@


1.3
log
@Spelling and grammar fixes from Mikhail Kolesnitchenko. [Patch 1012083]
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.2 2004/06/21 14:19:38 dkf Exp $
d48 1
a48 1
set dir [tk_chooseDirectory \\
@


1.2
log
@Added example
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.1 2000/01/27 00:23:10 ericm Exp $
d43 1
a43 1
Specifies whether the user may specify non-existant directories.  If
@


1.1
log
@* 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).
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id$
d46 10
a55 1
.LP
d58 1
a58 2
tk_getOpenFile, tk_getSaveFile

d60 1
a60 1
directory selection dialog
@


1.1.10.1
log
@Backport of documentation fixes
@
text
@d5 1
a5 1
'\" RCS: @@(#) $Id: chooseDirectory.n,v 1.1 2000/01/27 00:23:10 ericm Exp $
d43 1
a43 1
Specifies whether the user may specify non-existent directories.  If
d46 1
a46 10
.SH EXAMPLE
.CS
set dir [\fBtk_chooseDirectory\fR \\
        \-initialdir ~ \-title "Choose a directory"]
if {$dir eq ""} {
   label .l -text "No directory selected"
} else {
   label .l -text "Selected $dir"
}
.CE
d49 2
a50 1
tk_getOpenFile(n), tk_getSaveFile(n)
d52 1
a52 1
directory, selection, dialog, platform-specific
@


