* bug#59611: msdos.texi uses some obsolete function names
@ 2022-11-26 14:39 Juanma Barranquero
2022-11-26 14:51 ` Eli Zaretskii
2022-11-26 15:59 ` Stefan Kangas
0 siblings, 2 replies; 6+ messages in thread
From: Juanma Barranquero @ 2022-11-26 14:39 UTC (permalink / raw)
To: 59611
[-- Attachment #1.1: Type: text/plain, Size: 195 bytes --]
msdos.texi refers to the w32-(add|remove)-untranslated-filesystem functions
by their obsolete, non w32- name.
OK to install this patch, or were the old names kept in the manual for some
reason?
[-- Attachment #1.2: Type: text/html, Size: 301 bytes --]
[-- Attachment #2: 0001-doc-fix-Use-w32-names-instead-of-obsolete-ones.patch --]
[-- Type: application/octet-stream, Size: 2896 bytes --]
From 34b016d46a421245fb1dcaeb0543cc27d0277fb1 Mon Sep 17 00:00:00 2001
From: Juanma Barranquero <lekktu@gmail.com>
Date: Sat, 26 Nov 2022 15:34:07 +0100
Subject: [PATCH] ; doc fix: Use w32-* names instead of obsolete ones
* doc/emacs/msdos.texi (Text and Binary): Describe
w32-(add|remove)-untranslated-fiesystem functions by
their non-obsolete name.
---
doc/emacs/msdos.texi | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi
index dd0787cd38..d55c751210 100644
--- a/doc/emacs/msdos.texi
+++ b/doc/emacs/msdos.texi
@@ -206,40 +206,40 @@ Text and Binary
@code{dos2unix} program.
@cindex untranslated file system
-@findex add-untranslated-filesystem
+@findex w32-add-untranslated-filesystem
When you use NFS, Samba, or some other similar method to access file
systems that reside on computers using GNU or Unix systems, Emacs
should not perform end-of-line translation on any files in these file
systems---not even when you create a new file. To request this,
designate these file systems as @dfn{untranslated} file systems by
-calling the function @code{add-untranslated-filesystem}. It takes one
-argument: the file system name, including a drive letter and
+calling the function @code{w32-add-untranslated-filesystem}. It takes
+one argument: the file system name, including a drive letter and
optionally a directory. For example,
@example
-(add-untranslated-filesystem "Z:")
+(w32-add-untranslated-filesystem "Z:")
@end example
@noindent
designates drive Z as an untranslated file system, and
@example
-(add-untranslated-filesystem "Z:\\foo")
+(w32-add-untranslated-filesystem "Z:\\foo")
@end example
@noindent
designates directory @file{\foo} on drive Z as an untranslated file
system.
- Most often you would use @code{add-untranslated-filesystem} in your
+ Most often you would use @code{w32-add-untranslated-filesystem} in your
@file{.emacs} or @file{init.el} init file, or in @file{site-start.el}
so that all the users at your site get the benefit of it.
-@findex remove-untranslated-filesystem
- To countermand the effect of @code{add-untranslated-filesystem}, use
-the function @code{remove-untranslated-filesystem}. This function takes
-one argument, which should be a string just like the one that was used
-previously with @code{add-untranslated-filesystem}.
+@findex w32-remove-untranslated-filesystem
+ To countermand the effect of @code{w32-add-untranslated-filesystem},
+use the function @code{w32-remove-untranslated-filesystem}. This
+function takes one argument, which should be a string just like the
+one that was used previously with @code{w32-add-untranslated-filesystem}.
Designating a file system as untranslated does not affect character
set conversion, only end-of-line conversion. Essentially, it directs
--
2.38.1.windows.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* bug#59611: msdos.texi uses some obsolete function names
2022-11-26 14:39 bug#59611: msdos.texi uses some obsolete function names Juanma Barranquero
@ 2022-11-26 14:51 ` Eli Zaretskii
2022-11-26 14:55 ` Juanma Barranquero
2022-11-26 15:59 ` Stefan Kangas
1 sibling, 1 reply; 6+ messages in thread
From: Eli Zaretskii @ 2022-11-26 14:51 UTC (permalink / raw)
To: Juanma Barranquero; +Cc: 59611
> From: Juanma Barranquero <lekktu@gmail.com>
> Date: Sat, 26 Nov 2022 15:39:12 +0100
>
> msdos.texi refers to the w32-(add|remove)-untranslated-filesystem functions by their obsolete, non w32-
> name.
>
> OK to install this patch, or were the old names kept in the manual for some reason?
Please install, and thanks.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#59611: msdos.texi uses some obsolete function names
2022-11-26 14:51 ` Eli Zaretskii
@ 2022-11-26 14:55 ` Juanma Barranquero
0 siblings, 0 replies; 6+ messages in thread
From: Juanma Barranquero @ 2022-11-26 14:55 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: 59611-done
[-- Attachment #1: Type: text/plain, Size: 45 bytes --]
Installed by commit a22671dbd0 of 2022-11-26
[-- Attachment #2: Type: text/html, Size: 157 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#59611: msdos.texi uses some obsolete function names
2022-11-26 14:39 bug#59611: msdos.texi uses some obsolete function names Juanma Barranquero
2022-11-26 14:51 ` Eli Zaretskii
@ 2022-11-26 15:59 ` Stefan Kangas
2022-11-26 16:02 ` Juanma Barranquero
1 sibling, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2022-11-26 15:59 UTC (permalink / raw)
To: Juanma Barranquero, 59611
Juanma Barranquero <lekktu@gmail.com> writes:
> msdos.texi refers to the w32-(add|remove)-untranslated-filesystem functions
> by their obsolete, non w32- name.
>
> OK to install this patch, or were the old names kept in the manual for some
> reason?
BTW, it's generally uncontroversial to replace obsolete names in our
documentation with their new ones.
I've fixed quite a few such documentation bugs, and in all cases I've
seen so far, it was a just an oversight/mistake that the old names were
kept.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#59611: msdos.texi uses some obsolete function names
2022-11-26 15:59 ` Stefan Kangas
@ 2022-11-26 16:02 ` Juanma Barranquero
2022-11-26 16:11 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Juanma Barranquero @ 2022-11-26 16:02 UTC (permalink / raw)
To: Stefan Kangas; +Cc: 59611
[-- Attachment #1: Type: text/plain, Size: 118 bytes --]
Yeah, you're right and I supposed as much, but sometimes there are
unexpected assumptions. There's no harm in asking.
[-- Attachment #2: Type: text/html, Size: 217 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#59611: msdos.texi uses some obsolete function names
2022-11-26 16:02 ` Juanma Barranquero
@ 2022-11-26 16:11 ` Stefan Kangas
0 siblings, 0 replies; 6+ messages in thread
From: Stefan Kangas @ 2022-11-26 16:11 UTC (permalink / raw)
To: Juanma Barranquero; +Cc: 59611
> There's no harm in asking.
That's true.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2022-11-26 16:11 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-26 14:39 bug#59611: msdos.texi uses some obsolete function names Juanma Barranquero
2022-11-26 14:51 ` Eli Zaretskii
2022-11-26 14:55 ` Juanma Barranquero
2022-11-26 15:59 ` Stefan Kangas
2022-11-26 16:02 ` Juanma Barranquero
2022-11-26 16:11 ` Stefan Kangas
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.