GNU bug report logs - #14919
24.3.50; Bad menu name: `Directory Search'. Misleading terminology used.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 14919 in the body.
You can then email your comments to 14919 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.3.50; Bad menu name: `Directory Search'.  Misleading terminology
 used.
Date: Sat, 20 Jul 2013 17:24:24 -0700 (PDT)

This menu is apparently about directory services or directory servers.
It should be called something appropriate.

In Emacs generally, "directory" means a file-system directory - a
folder.  A directory service such as LDAP is something quite different,
and this menu name is misleading.  Consider perhaps `Directory Services'
or `Directory Servers'.

It is important to look at all of Emacs when coming up with a menu name
or even a command name.  It is a big mistake to look only inside an
individual Lisp library, which might well use terminology limited to a
particular domain.  Even then, when adding such a file to Emacs, the
file should be cleaned up to remove any ambiguity or confusion.

In this file, most of the occurrences of "directory" are followed by
"server", which is fine.  But there are some, including the first
lines of doc strings, that are not and that promote confusion.  E.g.,

eudc-format-attribute-name-for-display:
"Format a directory attribute name for display."

eudc-print-attribute-value:
"Insert the value of the directory FIELD at point."

And there are others, particularly referring to "directory queries".
Better to call these "directory service queries" etc.


In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-07-14 on ODIEONE
Bzr revision: 113423 lekktu <at> gmail.com-20130715004922-i67tg2ois14h3fpm
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 CFLAGS='-O0 -g3' CPPFLAGS='-Ic:/Devel/emacs/include'
 LDFLAGS='-Lc:/Devel/emacs/lib''

Message #8 received at 14919 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 14919 <at> debbugs.gnu.org
Subject: Re: bug#14919: 24.3.50;
 Bad menu name: `Directory Search'.  Misleading terminology used.
Date: Fri, 07 Feb 2014 22:02:06 -0800

Drew Adams <drew.adams <at> oracle.com> writes:

> This menu is apparently about directory services or directory servers.
> It should be called something appropriate.
>
> In Emacs generally, "directory" means a file-system directory - a
> folder.  A directory service such as LDAP is something quite different,
> and this menu name is misleading.  Consider perhaps `Directory Services'
> or `Directory Servers'.

Yeah, I agree.  Anybody mind if I rename this to "Directory Services"?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #11 received at 14919 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 14919 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#14919: 24.3.50;
 Bad menu name: `Directory Search'.  Misleading terminology used.
Date: Sat, 08 Feb 2014 11:26:45 +0200

> From: Lars Ingebrigtsen <larsi <at> gnus.org>
> Date: Fri, 07 Feb 2014 22:02:06 -0800
> Cc: 14919 <at> debbugs.gnu.org
> 
> Drew Adams <drew.adams <at> oracle.com> writes:
> 
> > This menu is apparently about directory services or directory servers.
> > It should be called something appropriate.
> >
> > In Emacs generally, "directory" means a file-system directory - a
> > folder.  A directory service such as LDAP is something quite different,
> > and this menu name is misleading.  Consider perhaps `Directory Services'
> > or `Directory Servers'.
> 
> Yeah, I agree.  Anybody mind if I rename this to "Directory Services"?

"Directory Servers" or "Emacs Directory Client" sound better to me.
What you suggests can still be interpreted as related to filesystem
directories.

Message #14 received at 14919 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 14919 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#14919: 24.3.50;
 Bad menu name: `Directory Search'.  Misleading terminology used.
Date: Tue, 11 Feb 2014 03:48:57 -0800

Eli Zaretskii <eliz <at> gnu.org> writes:

>> From: Lars Ingebrigtsen <larsi <at> gnus.org>
>> Date: Fri, 07 Feb 2014 22:02:06 -0800
>> Cc: 14919 <at> debbugs.gnu.org
>> 
>> Drew Adams <drew.adams <at> oracle.com> writes:
>> 
>> > This menu is apparently about directory services or directory servers.
>> > It should be called something appropriate.
>> >
>> > In Emacs generally, "directory" means a file-system directory - a
>> > folder.  A directory service such as LDAP is something quite different,
>> > and this menu name is misleading.  Consider perhaps `Directory Services'
>> > or `Directory Servers'.
>> 
>> Yeah, I agree.  Anybody mind if I rename this to "Directory Services"?
>
> "Directory Servers" or "Emacs Directory Client" sound better to me.
> What you suggests can still be interpreted as related to filesystem
> directories.

Yup.  Should wait until the next release cycle, though.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #17 received at 14919 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 14919 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#14919: 24.3.50;
 Bad menu name: `Directory Search'.  Misleading terminology used.
Date: Fri, 29 Apr 2016 03:16:17 +0200

Eli Zaretskii <eliz <at> gnu.org> writes:

>> From: Lars Ingebrigtsen <larsi <at> gnus.org>
>> Date: Fri, 07 Feb 2014 22:02:06 -0800
>> Cc: 14919 <at> debbugs.gnu.org
>> 
>> Drew Adams <drew.adams <at> oracle.com> writes:
>> 
>> > This menu is apparently about directory services or directory servers.
>> > It should be called something appropriate.
>> >
>> > In Emacs generally, "directory" means a file-system directory - a
>> > folder.  A directory service such as LDAP is something quite different,
>> > and this menu name is misleading.  Consider perhaps `Directory Services'
>> > or `Directory Servers'.
>> 
>> Yeah, I agree.  Anybody mind if I rename this to "Directory Services"?
>
> "Directory Servers" or "Emacs Directory Client" sound better to me.
> What you suggests can still be interpreted as related to filesystem
> directories.

I've now renamed it to "Directory Servers".

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.