From a16d8f2b2583799ab935fd5645622d448a54486e Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Wed, 21 Jan 2004 02:45:10 +0000 Subject: [PATCH] Improved a couple comments. --- util.c | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/util.c b/util.c index bda3bc21..3eefd4a4 100644 --- a/util.c +++ b/util.c @@ -763,8 +763,9 @@ char curr_dir[MAXPATHLEN]; unsigned int curr_dir_len; /** - * Like chdir() but can be reversed with pop_dir() if @p save is set. - * It is also much faster as it remembers where we have been. + * Like chdir(), but it keeps track of the current directory (in the + * global "curr_dir"), and ensures that the path size doesn't overflow. + * Also cleans the path using the clean_fname() function. **/ int push_dir(char *dir) { @@ -804,7 +805,10 @@ int push_dir(char *dir) return 1; } -/** Reverse a push_dir() call */ +/** + * Reverse a push_dir() call. You must pass in an absolute path + * that was copied from a prior value of "curr_dir". + **/ int pop_dir(char *dir) { if (chdir(dir)) -- 2.34.1