From: Philip Rooke <phil@yax.org.uk>
To: Thorsten Jolitz <tjolitz@googlemail.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: Org, Org-mode, Orgmode, Org Mode
Date: Sun, 03 Jun 2012 09:30:12 +0100 [thread overview]
Message-ID: <m2zk8kx0ff.fsf@bo.sak.lan> (raw)
In-Reply-To: <87bol26q5u.fsf@googlemail.com> (Thorsten Jolitz's message of "Sat, 02 Jun 2012 11:04:13 +0200")
Thorsten Jolitz <tjolitz@googlemail.com> writes:
> Achim Gratz <Stromeko@nexgo.de> 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 <carsten.dominik@gmail.com>
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
prev parent reply other threads:[~2012-06-03 8:30 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-06-02 8:12 Org, Org-mode, Orgmode, Org Mode Achim Gratz
2012-06-02 9:04 ` Thorsten Jolitz
2012-06-02 9:40 ` Achim Gratz
2012-06-02 10:00 ` Thorsten Jolitz
2012-06-02 10:11 ` Bastien
2012-06-02 14:06 ` Gregory Benjamin
2012-06-02 14:29 ` Gregor Zattler
2012-06-02 15:32 ` suvayu ali
2012-06-02 19:22 ` Samuel Wales
2012-06-02 20:10 ` Sebastien Vauban
2012-06-02 20:38 ` Scott Randby
2012-06-03 3:23 ` François Pinard
2012-06-03 6:25 ` Thorsten Jolitz
2012-06-03 8:30 ` Philip Rooke [this message]
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
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=m2zk8kx0ff.fsf@bo.sak.lan \
--to=phil@yax.org.uk \
--cc=emacs-orgmode@gnu.org \
--cc=tjolitz@googlemail.com \
/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 public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).