From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ian Barton <lists@manor-farm.org>
Subject: Re: Re: Language question
Date: Wed, 10 Dec 2008 16:14:50 +0000
Message-ID: <493FEAFA.1000204@manor-farm.org>
References: <8260CEF3-AEEF-4E9C-824D-2DBD184671BC@gmail.com>
	<87y6yoxcsa.fsf@gollum.intra.norang.ca>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1LARiK-0003gL-6G
	for emacs-orgmode@gnu.org; Wed, 10 Dec 2008 11:15:04 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1LARiI-0003fs-Aw
	for emacs-orgmode@gnu.org; Wed, 10 Dec 2008 11:15:03 -0500
Received: from [199.232.76.173] (port=53022 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1LARiI-0003fp-87
	for emacs-orgmode@gnu.org; Wed, 10 Dec 2008 11:15:02 -0500
Received: from a2s22.a2hosting.com ([69.39.86.130]:33111)
	by monty-python.gnu.org with esmtps
	(TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60)
	(envelope-from <lists@manor-farm.org>) id 1LARiH-0001H9-Rz
	for emacs-orgmode@gnu.org; Wed, 10 Dec 2008 11:15:02 -0500
In-Reply-To: <87y6yoxcsa.fsf@gollum.intra.norang.ca>
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Bernt Hansen <bernt@norang.ca>
Cc: emacs org-mode mailing list <emacs-orgmode@gnu.org>, Carsten Dominik <carsten.dominik@gmail.com>

>> If I write in the documentation
>>
>>    "Cross referencing with unique IDs is hard to document"
>>
>> do I then write
>>
>>     ids
>>     IDs
>>     id's
>> or  ID's
>>
> 
> IDs or ids is fine.  id's and ID's is possessive (the ID owns
> something).
> 
> I'd probably use IDs in this case.
> 
> id is just short for identifier normally so 
> ... unique identifiers is hard ...
> would also be fine.
> 

I would suggest calling it a UID. As Bernt said using an apostrophe is 
incorrect in this case. I would also suggest doing it like this:

"Cross referencing with unique IDs (UID) is hard to document"

I was always taught that you place the abbreviation in brackets after 
its definition, so the reader can easily find where it's defined.

Ian.