1 files changed, 71 insertions, 0 deletions
diff --git a/devdocs/elisp/files.html b/devdocs/elisp/files.html
new file mode 100644
index 00000000..21b90e2c
--- /dev/null
+++ b/devdocs/elisp/files.html
@@ -0,0 +1,71 @@
+ <h2 class="chapter">Files</h2> <p>This chapter describes the Emacs Lisp functions and variables to find, create, view, save, and otherwise work with files and directories. A few other file-related functions are described in <a href="buffers">Buffers</a>, and those related to backups and auto-saving are described in <a href="backups-and-auto_002dsaving">Backups and Auto-Saving</a>. </p> <p>Many of the file functions take one or more arguments that are file names. A file name is a string. Most of these functions expand file name arguments using the function <code>expand-file-name</code>, so that <samp>~</samp> is handled correctly, as are relative file names (including <samp>../</samp> and the empty string). See <a href="file-name-expansion">File Name Expansion</a>. </p> <p>In addition, certain <em>magic</em> file names are handled specially. For example, when a remote file name is specified, Emacs accesses the file over the network via an appropriate protocol. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Remote-Files.html#Remote-Files">Remote Files</a> in <cite>The GNU Emacs Manual</cite>. This handling is done at a very low level, so you may assume that all the functions described in this chapter accept magic file names as file name arguments, except where noted. See <a href="magic-file-names">Magic File Names</a>, for details. </p> <p>When file I/O functions signal Lisp errors, they usually use the condition <code>file-error</code> (see <a href="handling-errors">Handling Errors</a>). The error message is in most cases obtained from the operating system, according to locale <code>system-messages-locale</code>, and decoded using coding system <code>locale-coding-system</code> (see <a href="locales">Locales</a>). </p> <table class="menu" border="0" cellspacing="0"> <tr>
+<td align="left" valign="top">• <a href="visiting-files" accesskey="1">Visiting Files</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Reading files into Emacs buffers for editing. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="saving-buffers" accesskey="2">Saving Buffers</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Writing changed buffers back into files. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="reading-from-files" accesskey="3">Reading from Files</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Reading files into buffers without visiting. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="writing-to-files" accesskey="4">Writing to Files</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Writing new files from parts of buffers. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="file-locks" accesskey="5">File Locks</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Locking and unlocking files, to prevent simultaneous editing by two people. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="information-about-files" accesskey="6">Information about Files</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Testing existence, accessibility, size of files. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="changing-files" accesskey="7">Changing Files</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Renaming files, changing permissions, etc. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="files-and-storage" accesskey="8">Files and Storage</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Surviving power and media failures </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="file-names" accesskey="9">File Names</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Decomposing and expanding file names. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="contents-of-directories">Contents of Directories</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Getting a list of the files in a directory. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="create_002fdelete-dirs">Create/Delete Dirs</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Creating and Deleting Directories. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="magic-file-names">Magic File Names</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Special handling for certain file names. </td>
+</tr> <tr>
+<td align="left" valign="top">• <a href="format-conversion">Format Conversion</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Conversion to and from various file formats. </td>
+</tr> </table><div class="_attribution">
+  <p class="_attribution-p">
+    Copyright &copy; 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/Files.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Files.html</a>
+  </p>
+</div>