bug#59611: msdos.texi uses some obsolete function names

bug#59611: msdos.texi uses some obsolete function names

[Juanma Barranquero]

[-- 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

bug#59611: msdos.texi uses some obsolete function names

[Eli Zaretskii]

> 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.

bug#59611: msdos.texi uses some obsolete function names

[Juanma Barranquero]

[-- Attachment #1: Type: text/plain, Size: 45 bytes --]

Installed by commit a22671dbd0 of 2022-11-26

[-- Attachment #2: Type: text/html, Size: 157 bytes --]

bug#59611: msdos.texi uses some obsolete function names

[Stefan Kangas]

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.

bug#59611: msdos.texi uses some obsolete function names

[Juanma Barranquero]

[-- 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 --]

bug#59611: msdos.texi uses some obsolete function names

[Stefan Kangas]

> There's no harm in asking.

That's true.