@var{filename} is a symbolic link, @code{delete-file} deletes only the
symbolic link and not its target.
-A suitable kind of @code{file-error} error is signaled is not
-deletable. (On GNU and other POSIX-like systems, a file is deletable
-if its directory is writable.) No error is signaled if the file does
-not exist.
+The command signals a suitable kind of @code{file-error} error if
+@var{filename} cannot be deleted. (On GNU and other POSIX-like
+systems, a file can be deleted if its directory is writable.) If the
+file does not exist, this command will not signal any error.
If the optional argument @var{trash} is non-@code{nil} and the
variable @code{delete-by-moving-to-trash} is non-@code{nil}, this