all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Drew Adams <drew.adams@oracle.com>
To: 14919@debbugs.gnu.org
Subject: bug#14919: 24.3.50; Bad menu name: `Directory Search'.  Misleading terminology used.
Date: Sat, 20 Jul 2013 17:24:24 -0700 (PDT)	[thread overview]
Message-ID: <773fc1a6-e002-4348-bae4-100a03d5e34e@default> (raw)

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@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''





             reply	other threads:[~2013-07-21  0:24 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-07-21  0:24 Drew Adams [this message]
2014-02-08  6:02 ` bug#14919: 24.3.50; Bad menu name: `Directory Search'. Misleading terminology used Lars Ingebrigtsen
2014-02-08  9:26   ` Eli Zaretskii
2014-02-11 11:48     ` Lars Ingebrigtsen
2016-04-29  1:16     ` Lars Ingebrigtsen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=773fc1a6-e002-4348-bae4-100a03d5e34e@default \
    --to=drew.adams@oracle.com \
    --cc=14919@debbugs.gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.