diff options
| author | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
| commit | 82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch) | |
| tree | 158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/elisp/subroutines-of-visiting.html | |
| parent | 9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff) | |
| download | dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip | |
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/elisp/subroutines-of-visiting.html')
| -rw-r--r-- | devdocs/elisp/subroutines-of-visiting.html | 23 |
1 files changed, 0 insertions, 23 deletions
diff --git a/devdocs/elisp/subroutines-of-visiting.html b/devdocs/elisp/subroutines-of-visiting.html deleted file mode 100644 index 2a3befb2..00000000 --- a/devdocs/elisp/subroutines-of-visiting.html +++ /dev/null @@ -1,23 +0,0 @@ - <h4 class="subsection">Subroutines of Visiting</h4> <p>The <code>find-file-noselect</code> function uses two important subroutines which are sometimes useful in user Lisp code: <code>create-file-buffer</code> and <code>after-find-file</code>. This section explains how to use them. </p> <dl> <dt id="create-file-buffer">Function: <strong>create-file-buffer</strong> <em>filename</em> -</dt> <dd> -<p>This function creates a suitably named buffer for visiting <var>filename</var>, and returns it. It uses <var>filename</var> (sans directory) as the name if that name is free; otherwise, it appends a string such as ‘<samp><2></samp>’ to get an unused name. See also <a href="creating-buffers">Creating Buffers</a>. Note that the <samp>uniquify</samp> library affects the result of this function. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Uniquify.html#Uniquify">Uniquify</a> in <cite>The GNU Emacs Manual</cite>. </p> <p><strong>Please note:</strong> <code>create-file-buffer</code> does <em>not</em> associate the new buffer with a file and does not select the buffer. It also does not use the default major mode. </p> <div class="example"> <pre class="example">(create-file-buffer "foo") - ⇒ #<buffer foo> -</pre> -<pre class="example">(create-file-buffer "foo") - ⇒ #<buffer foo<2>> -</pre> -<pre class="example">(create-file-buffer "foo") - ⇒ #<buffer foo<3>> -</pre> -</div> <p>This function is used by <code>find-file-noselect</code>. It uses <code>generate-new-buffer</code> (see <a href="creating-buffers">Creating Buffers</a>). </p> -</dd> -</dl> <dl> <dt id="after-find-file">Function: <strong>after-find-file</strong> <em>&optional error warn noauto after-find-file-from-revert-buffer nomodes</em> -</dt> <dd> -<p>This function sets the buffer major mode, and parses local variables (see <a href="auto-major-mode">Auto Major Mode</a>). It is called by <code>find-file-noselect</code> and by the default revert function (see <a href="reverting">Reverting</a>). </p> <p>If reading the file got an error because the file does not exist, but its directory does exist, the caller should pass a non-<code>nil</code> value for <var>error</var>. In that case, <code>after-find-file</code> issues a warning: ‘<samp>(New file)</samp>’. For more serious errors, the caller should usually not call <code>after-find-file</code>. </p> <p>If <var>warn</var> is non-<code>nil</code>, then this function issues a warning if an auto-save file exists and is more recent than the visited file. </p> <p>If <var>noauto</var> is non-<code>nil</code>, that says not to enable or disable Auto-Save mode. The mode remains enabled if it was enabled before. </p> <p>If <var>after-find-file-from-revert-buffer</var> is non-<code>nil</code>, that means this call was from <code>revert-buffer</code>. This has no direct effect, but some mode functions and hook functions check the value of this variable. </p> <p>If <var>nomodes</var> is non-<code>nil</code>, that means don’t alter the buffer’s major mode, don’t process local variables specifications in the file, and don’t run <code>find-file-hook</code>. This feature is used by <code>revert-buffer</code> in some cases. </p> <p>The last thing <code>after-find-file</code> does is call all the functions in the list <code>find-file-hook</code>. </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/Subroutines-of-Visiting.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Subroutines-of-Visiting.html</a> - </p> -</div> |