From owner-freebsd-doc@FreeBSD.ORG  Sat May 11 18:11:56 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id 10EAB255;
 Sat, 11 May 2013 18:11:56 +0000 (UTC)
 (envelope-from gabor@FreeBSD.org)
Received: from server.mypc.hu (server.mypc.hu [87.229.73.95])
 by mx1.freebsd.org (Postfix) with ESMTP id C1AD324D;
 Sat, 11 May 2013 18:11:55 +0000 (UTC)
Received: from server.mypc.hu (localhost [127.0.0.1])
 by server.mypc.hu (Postfix) with ESMTP id 9D91514D251B;
 Sat, 11 May 2013 20:11:48 +0200 (CEST)
X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com
Received: from server.mypc.hu ([127.0.0.1])
 by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024)
 with LMTP id IzAssBkwad9m; Sat, 11 May 2013 20:11:38 +0200 (CEST)
Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77])
 (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
 (No client certificate requested)
 by server.mypc.hu (Postfix) with ESMTPSA id B982614D2431;
 Sat, 11 May 2013 20:11:38 +0200 (CEST)
Message-ID: <518E89DE.70008@FreeBSD.org>
Date: Sat, 11 May 2013 20:11:42 +0200
From: Gabor Kovesdan <gabor@FreeBSD.org>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:20.0) Gecko/20100101 Thunderbird/20.0
MIME-Version: 1.0
To: Marc Fonvieille <blackend@FreeBSD.org>
Subject: Re: [CFR] Migrating the documentation to a real XML toolchain
References: <512D2F9C.8080403@FreeBSD.org>
 <alpine.BSF.2.00.1302261759420.49330@wonkity.com>
 <5142357A.9070301@FreeBSD.org>
 <alpine.BSF.2.00.1303141642470.84119@wonkity.com>
 <5142D0C9.70905@FreeBSD.org> <20130508122821.GA1521@emphyrio.blackend.org>
In-Reply-To: <20130508122821.GA1521@emphyrio.blackend.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 11 May 2013 18:11:56 -0000

Em 08-05-2013 14:28, Marc Fonvieille escreveu:
> On Fri, Mar 15, 2013 at 08:42:01AM +0100, Gabor Kovesdan wrote:
>>> > >
>>> > >Good question.  I know this is given as a reason why acronyms should
>>> > >always be marked up, and I thought I'd seen it at some point in the
>>> > >FreeBSD docs.  But it does not do it now, and I may have been looking
>>> > >at something else.  It is something that would really benefit the reader.
>> >I also agree that it would be a nice feature but actually I don't even
>> >understand how it is supposed to work at the moment. In most cases, the
>> >markup does not hold the expansion, it just says e.g.
>> ><acronym>NFS</acronym> but does not include what it needs to expand to.
>> >We could add an attribute but then it would only appear if the attribute
>> >is present. Shall we expand all occurrences (would mean lots of
>> >redundancy) or just the first?
> It was supposed working in the same way as the trademarks, i.e., the 1st
> occurence is expanded/rendered.
>
I just don't where the expanded text is taken from. I cannot find it in 
our markup. I googled about it and I see very different pieces of 
information. I'll look at it better when the current changeset is merged 
back.

Gabor