Received: from localhost (unknown [200.46.204.183])
	by postgresql.org (Postfix) with ESMTP id F2A0B9FA33B
	for <pgsql-general-postgresql.org@postgresql.org>;
	Fri, 19 Oct 2007 10:58:41 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024)
	with ESMTP id 61933-06 for
	<pgsql-general-postgresql.org@postgresql.org>;
	Fri, 19 Oct 2007 10:58:36 -0300 (ADT)
X-Greylist: delayed 02:38:04.952321 by SQLgrey-1.7.5
Received: from mail-in-05.arcor-online.net (mail-in-05.arcor-online.net
	[151.189.21.45])
	by postgresql.org (Postfix) with ESMTP id 810519FB4FE
	for <pgsql-general@postgresql.org>;
	Fri, 19 Oct 2007 10:58:36 -0300 (ADT)
Received: from mail-in-04-z2.arcor-online.net (mail-in-04-z2.arcor-online.net
	[151.189.8.16])
	by mail-in-05.arcor-online.net (Postfix) with ESMTP id 0E869183A39;
	Fri, 19 Oct 2007 13:19:50 +0200 (CEST)
Received: from mail-in-10.arcor-online.net (mail-in-10.arcor-online.net
	[151.189.21.50])
	by mail-in-04-z2.arcor-online.net (Postfix) with ESMTP id F1726ABAE7;
	Fri, 19 Oct 2007 13:19:49 +0200 (CEST)
Received: from [192.168.0.6] (dslb-088-077-050-181.pools.arcor-ip.net
	[88.77.50.181])
	by mail-in-10.arcor-online.net (Postfix) with ESMTP id B71A926D361;
	Fri, 19 Oct 2007 13:19:49 +0200 (CEST)
Message-ID: <471892D1.4000507@rp-online.de>
Date: Fri, 19 Oct 2007 13:19:45 +0200
From: Thomas Pundt <mlists@rp-online.de>
Reply-To: thomas.pundt@rp-online.de
User-Agent: Thunderbird 2.0.0.6 (Macintosh/20070728)
MIME-Version: 1.0
To: Alban Hertroys <a.hertroys@magproductions.nl>
CC: Steve Crawford <scrawford@pinpointresearch.com>,
	Alvaro Herrera <alvherre@commandprompt.com>, pgsql-general@postgresql.org
Subject: Re: Abbreviation list
References: <4717AC13.5010609@pinpointresearch.com>
	<20071018191047.GN29379@alvh.no-ip.org>
	<4717F038.1060709@pinpointresearch.com>
	<471889D4.5010500@magproductions.nl>
In-Reply-To: <471889D4.5010500@magproductions.nl>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: ClamAV 0.91.2/4545/Wed Oct 17 23:05:57 2007 on
	mail-in-10.arcor-online.net
X-Virus-Status: Clean
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/971
X-Sequence-Number: 122263

Alban Hertroys schrieb:
> Steve Crawford wrote:
>> My vote is to add "Appendix I. Abbreviations". Don't know if it's
>> practical for 8.3 documentation but it would be nice to add even if it
>> only has a few entries as additional ones could be collected via the
>> user notes.
>>
>> I suggest as a discussion starting-point the following inclusion criteria:
>>
>> 1. Any abbreviation/acronym that appears in the PostgreSQL documentation
>> (even if those terms may not be PG specific - we shouldn't assume that
>> everyone knows them). Good documentation practice recommends defining
>> abbreviations the first time they are used. Better still, ensure that
>> they are in the abbreviation list.
> 
> Isn't this just what the ABBR tag in html is for?

Well, yes; according w3.org its purpose is to describe the
abbreviation/acronym inline in a document using a title attribute:

<acronym title="Grand Unified Configuration">GUC</acronym>

Firefox by default underlines the abbreviation with a dotted line and
displays the title when leaving the cursor on it. In a way this means
probably defining the abbreviation.

Reference: http://www.w3.org/TR/html401/struct/text.html#edef-ABBR

-- 
Thomas Pundt <thomas.pundt@rp-online.de> ---- http://rp-online.de/ ----