emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: [Emacs-diffs] /srv/bzr/emacs/trunk r111816: * lisp/menu-bar.el(menu-


From: Drew Adams
Subject: RE: [Emacs-diffs] /srv/bzr/emacs/trunk r111816: * lisp/menu-bar.el(menu-bar-tools-menu): Fix case of EDE entry.
Date: Sun, 17 Feb 2013 11:20:45 -0800

> > > -      '(menu-item "Project support (EDE)"
> > > +      '(menu-item "Project Support (EDE)"
> > FWIW, I prefer the "less capitalized" forms.
> 
> Maybe it can be written into the "Tips and Conventions" 
> section in elisp manual (if most people approve of it).

1. The most important things are (a) to be fairly consistent across a given
context (e.g. a mode or an application) and (b) to use the same capitalization
as found in the application, for any terms that serve more or less like proper
nouns there (e.g. the name of a buffer that serves as a menu item in menu
`Buffers', or an Imenu menu item).

2. Emacs Dev can decide what it wants, beyond that.  The two most common
capitalization conventions are (a) title case and (b) sentence case (sometimes
called downstyle).  Title case generally means capitalizing the important words
(plus the first), not all the words (sometimes called start case).

3. Historically, title case has tended to be used more in the US; sentence case
in Europe and the UK.  Dunno about other areas, and usage no doubt varies across
media and contexts.

4. #1b means that, barring some other typographical notation to set off such
proper terms, sentence case is advantageous when the proper term is itself
capitalized, and title case is advantageous when it is not.  IOW, what is odd
stands out.

5. "The less capitalized forms" is not very operational as guidance.  Presumably
what Stefan expresses is a preference for sentence case in menus, as opposed to
title case or to capitalizing every word.

6. Personally, I favor title case in menus (but again see #1: be consistent).  I
do so in part because it is overwhelmingly used in menus (to my knowledge), both
within Emacs and beyond, and in part because it leads your eye to terms that
more important, facilitating scanning.

7. Emacs generally sets off menu names using `...' in the manual (e.g., "Click
on `Set Default Font' in the `Options' menu", "click on the menu item named
`Source Code Parsers (Semantic)' in the `Tools' menu").

But sometimes it does not (bugs), and in those cases another advantage to title
case is that it can be easier to separate visually from the surrounding text.

8. I agree that whatever convention is decided on, it would be good to mention
it in the manual, as a guideline.  That helps people know what is generally
preferred.

Given the fact that Emacs already appears pretty consistent in this regard, I
thought that title case had already been chosen as our convention, but whatever
the choice is, it would be good to document it, as guidance.

http://en.wikipedia.org/wiki/Letter_case




reply via email to

[Prev in Thread] Current Thread [Next in Thread]