From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel 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 Message-ID: <19194CE5D764449083CCF6814B538D8C@us.oracle.com> References: <20130217232707.b03e9a514cf5b249b5060b8c@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1361128867 6928 80.91.229.3 (17 Feb 2013 19:21:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 17 Feb 2013 19:21:07 +0000 (UTC) Cc: emacs-devel@gnu.org To: "'Xue Fuqiao'" , "'Stefan Monnier'" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Feb 17 20:21:28 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1U79nf-0000WT-OW for ged-emacs-devel@m.gmane.org; Sun, 17 Feb 2013 20:21:23 +0100 Original-Received: from localhost ([::1]:42384 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U79nL-00010N-JG for ged-emacs-devel@m.gmane.org; Sun, 17 Feb 2013 14:21:03 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:39985) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U79nI-000107-H3 for emacs-devel@gnu.org; Sun, 17 Feb 2013 14:21:02 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U79nH-0006SE-5y for emacs-devel@gnu.org; Sun, 17 Feb 2013 14:21:00 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:40310) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U79nG-0006S5-VQ for emacs-devel@gnu.org; Sun, 17 Feb 2013 14:20:59 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r1HJKusM017943 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 17 Feb 2013 19:20:56 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r1HJKtOS013022 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 17 Feb 2013 19:20:56 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r1HJKtiE031947; Sun, 17 Feb 2013 13:20:55 -0600 Original-Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 17 Feb 2013 11:20:55 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <20130217232707.b03e9a514cf5b249b5060b8c@gmail.com> Thread-Index: Ac4NI03DaG3ZMnOgQvKPo0VTcg7HqAAGP9pQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 141.146.126.69 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:157108 Archived-At: > > > - '(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