From mboxrd@z Thu Jan 1 00:00:00 1970 From: Philip Rooke Subject: Re: Org, Org-mode, Orgmode, Org Mode Date: Sun, 03 Jun 2012 09:30:12 +0100 Message-ID: References: <87fwaeyvxl.fsf@Rainer.invalid> <87bol26q5u.fsf@googlemail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:53983) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sb6Cd-0005SC-4X for emacs-orgmode@gnu.org; Sun, 03 Jun 2012 04:30:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sb6CZ-0007AY-V8 for emacs-orgmode@gnu.org; Sun, 03 Jun 2012 04:30:22 -0400 Received: from mail-wg0-f49.google.com ([74.125.82.49]:45722) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sb6CZ-0007AK-On for emacs-orgmode@gnu.org; Sun, 03 Jun 2012 04:30:19 -0400 Received: by wgbds1 with SMTP id ds1so2352629wgb.30 for ; Sun, 03 Jun 2012 01:30:16 -0700 (PDT) In-Reply-To: <87bol26q5u.fsf@googlemail.com> (Thorsten Jolitz's message of "Sat, 02 Jun 2012 11:04:13 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Thorsten Jolitz Cc: emacs-orgmode@gnu.org Thorsten Jolitz writes: > Achim Gratz writes: > >> Looking at the documentation and also the website and Worg, I see that >> we still use all these monikers interchangeably in both capitalized and >> lowercase form throughout. I seem to remember that there was some >> discussion that only one of them should be used going forward, but I >> can't find it... >> >> >> Regards, >> Achim. > > look at: > /org-mode/doc/Documentation_Standards.org > > in your Org-mode (?) distribution See below for an historical data point. I wrote that standards doc after an off-list discussion/agreement with Carsten and Bastien back in early 2008 and just before I made an effort to tidy up these sort of issues in the docs. Obviously Org development, awareness and use has exploded since those days and so it seems reasonable to check whether what we said back then remains relevant today. I don't really mind what the standard is but I certainly agree that having one is a good thing. Regards, Phil --------------- From: Carsten Dominik Subject: Re: Documentation standards To: phil@yax.org.uk Cc: bzg@altern.org Date: Wed, 26 Mar 2008 19:40:08 +0100 (4 years, 9 weeks, 5 days ago) Dear Phil, I am pretty much happy with all the proposed changes, below are some comments. [...snip...] > 7) [...] Thus I have seen Org-mode, org-mode, org or Org referring to > the mode itself, the function 'org-mode' and then a variety of > 'org-mode-...' functions and variables. I would like to standardise > on Org when referring to the mode (as a noun if you like) and > org-... in all other instances. I think it will also work better with > the way a number of other modes (eg Calc) are also already referenced. > Likewise, I would also like to disambiguate Orgtbl the minor mode, and > others, from references to that mode's functions and variables. I am all for it. I thought that I have used "Org-mode" very systematically throughout the manual, but maybe I am mistaken. If you choose "Org", how about the following: Let "Org" refer to the system as a whole, not narrowed down to the mode. Because in fact, Org contains a number of different major modes. So use org-mode or Org-mode when you specifically mean the major mode in .org files and its properties. Use Org as the general term which then in places might be used instead of org- mode if there is not misconception possible. - Carsten