From: Eli Zaretskii Date: Fri, 6 Apr 2018 06:44:42 +0000 (+0300) Subject: * lisp/files.el (find-file-literally): Doc fix. X-Git-Tag: emacs-26.1-rc1~5 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5659b2fe843627aa4b6d450758f71920143ac173;p=emacs.git * lisp/files.el (find-file-literally): Doc fix. --- diff --git a/lisp/files.el b/lisp/files.el index 974d39ceee9..1e44f43be1e 100644 --- a/lisp/files.el +++ b/lisp/files.el @@ -2342,10 +2342,15 @@ and local variable specifications in the file are ignored. Automatic uncompression and adding a newline at the end of the file due to `require-final-newline' is also disabled. -You cannot absolutely rely on this function to result in -visiting the file literally. If Emacs already has a buffer -which is visiting the file, you get the existing buffer, -regardless of whether it was created literally or not. +If Emacs already has a buffer which is visiting the file, +this command asks you whether to visit it literally instead. + +In non-interactive use, the value is the buffer where the file is +visited literally. If the file was visited in a buffer before +this command was invoked, it will reuse the existing buffer, +regardless of whether it was created literally or not; however, +the contents of that buffer will be the literal text of the file +without any conversions. In a Lisp program, if you want to be sure of accessing a file's contents literally, you should create a temporary buffer and then read