Tcl Source Code

Check-in [f1c04ac99a]
Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to [email protected]
or submit via the online form by Sep 9.

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment: Added docs for public funcs: Tcl_GetCwd & Tcl_Chdir
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | core-8-1-branch-old
Files: files | file ages | folders
SHA1: f1c04ac99a5687b53e2b16af7acf5975a56dac02
User & Date: rjohnson 1999-04-06 02:48:31
Context
1999-04-06
02:56
Fixed bug in man page. check-in: 05fe29e796 user: rjohnson tags: core-8-1-branch-old
02:48
Added docs for public funcs: Tcl_GetCwd & Tcl_Chdir check-in: f1c04ac99a user: rjohnson tags: core-8-1-branch-old
02:05
* tests/io.test: Minor test cleanup.

* generic/tclEncoding.c (Tcl_CreateEncoding): Minor lint to ma... check-in: 5eb05485f4 user: stanton tags: core-8-1-branch-old

Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Added doc/GetCwd.3.

            1  +'\"
            2  +'\" Copyright (c) 1998-1999 Scriptics Corportation
            3  +'\"
            4  +'\" See the file "license.terms" for information on usage and redistribution
            5  +'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
            6  +'\" 
            7  +'\" RCS: @(#) $Id: GetCwd.3,v 1.1.2.1 1999/04/06 02:48:31 rjohnson Exp $
            8  +'\" 
            9  +.so man.macros
           10  +.TH Tcl_GetCwd 3 8.1 Tcl "Tcl Library Procedures"
           11  +.BS
           12  +.SH NAME
           13  +Tcl_GetCwd, Tcl_Chdir \- manipulate the current working directory
           14  +.SH SYNOPSIS
           15  +.nf
           16  +\fB#include <tcl.h>\fR
           17  +.sp
           18  +char *
           19  +\fBTcl_GetCwd\fR(\fIinterp\fR, \fIbufferPtr\fR)
           20  +.sp
           21  +int
           22  +\fBTcl_Chdir\fR(\fIpath\fR)
           23  +.SH ARGUMENTS
           24  +.AS Tcl_DString *bufferPtr
           25  +.AP Tcl_Interp *interp in
           26  +Interpreter in which to report an error, if any.
           27  +.AP char *path in
           28  +File path in UTF\-8 format.
           29  +.BE
           30  +
           31  +.SH DESCRIPTION
           32  +.PP
           33  +These procedures may be used to manipulate the current working
           34  +directory for the application.  They provide C\-level access to
           35  +the same functionality as the Tcl \fBpwd\fR command.
           36  +.PP
           37  +\fBTcl_GetCwd\fR returns a pointer to a string specifying the current
           38  +directory, or NULL if the current directory could not be determined.
           39  +If NULL is returned, an error message is left in the interp's result.
           40  +Storage for the result string is allocated in bufferPtr; the caller
           41  +must call \fBTcl_DStringFree()\fR when the result is no longer needed.
           42  +The format of the path is UTF\-8.
           43  +.PP
           44  +\fBTcl_Chdir\fR changes the applications current working directory to
           45  +the value specified in \fIpath\fR.  The format of the passed in string
           46  +must be UTF\-8.  The function returns -1 on error or 0 on success.
           47  +
           48  +.SH KEYWORDS
           49  +pwd