Added SetFolder

gvanrossum · gvanrossum · commit 910a671ba0b0 · 1996-07-30T18:22:31.000Z
diff --git a/Doc/libmacfs.tex b/Doc/libmacfs.tex
@@ -66,6 +66,18 @@ \section{Built-in Module \sectcode{macfs}}
 Return an FSSpec object and a success-indicator.
 \end{funcdesc}
 
+\begin{funcdesc}{SetFolder}{\optional{fsspec}}
+Set the folder that is initially presented to the user when one of
+the file selection dialogs is presented. \var{Fsspec} should point to
+a file in the folder, not the folder itself (the file need not exist,
+though). If no argument is passed the folder will be set to the
+current directory, i.e. what \code{os.getcwd()} returns.
+
+Note that starting with system 7.5 the user can change Standard File
+behaviour with the ``general controls'' controlpanel, thereby making
+this call inoperative.
+\end{funcdesc}
+
 \begin{funcdesc}{FindFolder}{where\, which\, create}
 Locates one of the ``special'' folders that MacOS knows about, such as
 the trash or the Preferences folder. \var{Where} is the disk to
diff --git a/Doc/mac/libmacfs.tex b/Doc/mac/libmacfs.tex
@@ -66,6 +66,18 @@ \section{Built-in Module \sectcode{macfs}}
 Return an FSSpec object and a success-indicator.
 \end{funcdesc}
 
+\begin{funcdesc}{SetFolder}{\optional{fsspec}}
+Set the folder that is initially presented to the user when one of
+the file selection dialogs is presented. \var{Fsspec} should point to
+a file in the folder, not the folder itself (the file need not exist,
+though). If no argument is passed the folder will be set to the
+current directory, i.e. what \code{os.getcwd()} returns.
+
+Note that starting with system 7.5 the user can change Standard File
+behaviour with the ``general controls'' controlpanel, thereby making
+this call inoperative.
+\end{funcdesc}
+
 \begin{funcdesc}{FindFolder}{where\, which\, create}
 Locates one of the ``special'' folders that MacOS knows about, such as
 the trash or the Preferences folder. \var{Where} is the disk to
