From owner-freebsd-doc@FreeBSD.ORG Sun May 12 09:21:53 2013 Return-Path: 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 DF90828B; Sun, 12 May 2013 09:21:53 +0000 (UTC) (envelope-from marc@blackend.org) Received: from smtp6-g21.free.fr (smtp6-g21.free.fr [IPv6:2a01:e0c:1:1599::15]) by mx1.freebsd.org (Postfix) with ESMTP id D31B21E6; Sun, 12 May 2013 09:21:51 +0000 (UTC) Received: from emphyrio.blackend.org (unknown [88.179.1.53]) by smtp6-g21.free.fr (Postfix) with ESMTP id EF0D582258; Sun, 12 May 2013 11:21:43 +0200 (CEST) Received: from emphyrio.blackend.org (localhost [127.0.0.1]) by emphyrio.blackend.org (8.14.5/8.14.4) with ESMTP id r4C9Lgnl001765; Sun, 12 May 2013 11:21:42 +0200 (CEST) (envelope-from marc@emphyrio.blackend.org) Received: (from marc@localhost) by emphyrio.blackend.org (8.14.5/8.14.4/Submit) id r4C9Lg4O001764; Sun, 12 May 2013 11:21:42 +0200 (CEST) (envelope-from marc) Date: Sun, 12 May 2013 11:21:42 +0200 From: Marc Fonvieille To: Gabor Kovesdan Subject: Re: [CFR] Migrating the documentation to a real XML toolchain Message-ID: <20130512092142.GA1740@emphyrio.blackend.org> References: <512D2F9C.8080403@FreeBSD.org> <5142357A.9070301@FreeBSD.org> <5142D0C9.70905@FreeBSD.org> <20130508122821.GA1521@emphyrio.blackend.org> <518E89DE.70008@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <518E89DE.70008@FreeBSD.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 8.3-STABLE User-Agent: Mutt/1.5.21 (2010-09-15) Cc: doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 May 2013 09:21:53 -0000 On Sat, May 11, 2013 at 08:11:42PM +0200, Gabor Kovesdan wrote: > 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. > >> >NFS 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. en_US.ISO8859-1/share/xml/glossary.ent -- Marc