Date: Sun, 12 May 2013 11:21:42 +0200 From: Marc Fonvieille <blackend@FreeBSD.org> To: Gabor Kovesdan <gabor@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: [CFR] Migrating the documentation to a real XML toolchain Message-ID: <20130512092142.GA1740@emphyrio.blackend.org> In-Reply-To: <518E89DE.70008@FreeBSD.org> 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> <518E89DE.70008@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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. > >> ><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. en_US.ISO8859-1/share/xml/glossary.ent -- Marc
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130512092142.GA1740>