1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
<h3 class="section">Creating, Copying and Deleting Directories</h3> <p>Most Emacs Lisp file-manipulation functions get errors when used on files that are directories. For example, you cannot delete a directory with <code>delete-file</code>. These special functions exist to create and delete directories. </p> <dl> <dt id="make-directory">Command: <strong>make-directory</strong> <em>dirname &optional parents</em>
</dt> <dd><p>This command creates a directory named <var>dirname</var>. If <var>parents</var> is non-<code>nil</code>, as is always the case in an interactive call, that means to create the parent directories first, if they don’t already exist. <code>mkdir</code> is an alias for this. </p></dd>
</dl> <dl> <dt id="make-empty-file">Command: <strong>make-empty-file</strong> <em>filename &optional parents</em>
</dt> <dd><p>This command creates an empty file named <var>filename</var>. As <code>make-directory</code>, this command creates parent directories if <var>parents</var> is non-<code>nil</code>. If <var>filename</var> already exists, this command signals an error. </p></dd>
</dl> <dl> <dt id="copy-directory">Command: <strong>copy-directory</strong> <em>dirname newname &optional keep-time parents copy-contents</em>
</dt> <dd>
<p>This command copies the directory named <var>dirname</var> to <var>newname</var>. If <var>newname</var> is a directory name, <var>dirname</var> will be copied to a subdirectory there. See <a href="directory-names">Directory Names</a>. </p> <p>It always sets the file modes of the copied files to match the corresponding original file. </p> <p>The third argument <var>keep-time</var> non-<code>nil</code> means to preserve the modification time of the copied files. A prefix arg makes <var>keep-time</var> non-<code>nil</code>. </p> <p>The fourth argument <var>parents</var> says whether to create parent directories if they don’t exist. Interactively, this happens by default. </p> <p>The fifth argument <var>copy-contents</var>, if non-<code>nil</code>, means to copy the contents of <var>dirname</var> directly into <var>newname</var> if the latter is a directory name, instead of copying <var>dirname</var> into it as a subdirectory. </p>
</dd>
</dl> <dl> <dt id="delete-directory">Command: <strong>delete-directory</strong> <em>dirname &optional recursive trash</em>
</dt> <dd>
<p>This command deletes the directory named <var>dirname</var>. The function <code>delete-file</code> does not work for files that are directories; you must use <code>delete-directory</code> for them. If <var>recursive</var> is <code>nil</code>, and the directory contains any files, <code>delete-directory</code> signals an error. If recursive is non-<code>nil</code>, there is no error merely because the directory or its files are deleted by some other process before <code>delete-directory</code> gets to them. </p> <p><code>delete-directory</code> only follows symbolic links at the level of parent directories. </p> <p>If the optional argument <var>trash</var> is non-<code>nil</code> and the variable <code>delete-by-moving-to-trash</code> is non-<code>nil</code>, this command moves the file into the system Trash instead of deleting it. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Misc-File-Ops.html#Misc-File-Ops">Miscellaneous File Operations</a> in <cite>The GNU Emacs Manual</cite>. When called interactively, <var>trash</var> is <code>t</code> if no prefix argument is given, and <code>nil</code> otherwise. </p>
</dd>
</dl><div class="_attribution">
<p class="_attribution-p">
Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
<a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Create_002fDelete-Dirs.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Create_002fDelete-Dirs.html</a>
</p>
</div>
|
