From owner-freebsd-doc@FreeBSD.ORG Fri Dec 12 16:47:38 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5407F1065676; Fri, 12 Dec 2008 16:47:38 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (unknown [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id C554E8FC12; Fri, 12 Dec 2008 16:47:37 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p2191-ipbf1403funabasi.chiba.ocn.ne.jp [118.7.161.191]) (authenticated bits=128) by mail.allbsd.org (8.14.2/8.14.2) with ESMTP id mBCGlPAG010816; Sat, 13 Dec 2008 01:47:36 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) (authenticated bits=0) by delta.allbsd.org (8.13.4/8.13.4) with ESMTP id mBCGlFJb090153; Sat, 13 Dec 2008 01:47:19 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sat, 13 Dec 2008 01:46:06 +0900 (JST) Message-Id: <20081213.014606.247395509.hrs@allbsd.org> To: keramida@FreeBSD.org From: Hiroki Sato In-Reply-To: <871vwdahna.fsf@kobe.laptop> References: <87k5a63z2d.fsf@kobe.laptop> <871vwdahna.fsf@kobe.laptop> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.1 on Emacs 22.2 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart0(Sat_Dec_13_01_46_06_2008_990)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV version 0.93.3, clamav-milter version 0.93.3 on gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0 (mail.allbsd.org [133.31.130.32]); Sat, 13 Dec 2008 01:47:36 +0900 (JST) Cc: doc@FreeBSD.org Subject: Re: [PATCH] Adding elements to wlan Handbook section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Dec 2008 16:47:38 -0000 ----Security_Multipart0(Sat_Dec_13_01_46_06_2008_990)-- Content-Type: Multipart/Mixed; boundary="--Next_Part(Sat_Dec_13_01_46_06_2008_632)--" Content-Transfer-Encoding: 7bit ----Next_Part(Sat_Dec_13_01_46_06_2008_632)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Giorgos Keramidas wrote in <871vwdahna.fsf@kobe.laptop>: ke> On Fri, 12 Dec 2008 08:51:07 +0100, "Rene Ladan" wrote: ke> > I am in favour of the full expansion, so that you can write ke> > ke> > Using &acronym.wlan.wep; encryption is not really safe anymore, ke> > but a lot of people use it anyway. ke> > ke> > This form is shorter and we don't have to write the word "acronym" ke> > three times. ke> > ke> > Maybe the acronyms can link to the glossary of the Handbook as well? ke> ke> That's an interesting idea :-) ke> ke> On Fri, 12 Dec 2008 09:58:28 +0100, Gabor PALI wrote: ke> > Maybe you can have different versions in the .ent file, like you did ke> > in case of mailing lists (defer the design decisions :)): ke> > ke> > WEP'> ke> > WEP'> ke> ke> Heh, cool! I'll try to update the patch to include entities like this. Hmm, this is not directly related to your idea, but I did not noticed that role attrib is used for adding the description so far. I think this is incorrect from viewpoint of DocBook because it is for classification of the element, not real content. In DocBook vocabulary, cannot have such a expanded text, unfortunately. As a workaround, how about using the following phrase: WEPWired Equivalent Privacy I use with role attrib here (probably this is the only option which looks reasonable). The necessary changes to the stylesheet and an SGML example of vm-design/article.sgml are attached (indentation is incomplete, though). We need to rewrite the existing elements, too. For entity definition, I like the following: FOODESC OF FOO'> Generating link to glossary, suppressing rendering of , or so on can be controlled by stylesheet, so multiple definitions are not needed at the level, IMHO. -- | Hiroki SATO ----Next_Part(Sat_Dec_13_01_46_06_2008_632)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="acronym.diff" Index: share/sgml/freebsd.dsl =================================================================== RCS file: /home/ncvs/doc/share/sgml/freebsd.dsl,v retrieving revision 1.94 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$Translation:.*\$ -I\$hrs:.*\$ -r1.94 freebsd.dsl --- share/sgml/freebsd.dsl 24 May 2008 16:16:20 -0000 1.94 +++ share/sgml/freebsd.dsl 12 Dec 2008 16:13:56 -0000 @@ -78,19 +78,25 @@ ;; Taken from Norm's stylesheets; modified to add support for TITLE so ;; that we get a mouse over definition for acronyms in HTML output. - (define ($acronym-seq$ #!optional (sosofo (process-children))) - ;; FIXME: html4 only - (let ((title (attribute-string (normalize "role") (current-node)))) - (if title - (make element gi: "ACRONYM" - attributes: (list - (list "TITLE" title) - (list "CLASS" (gi))) - sosofo) - (make element gi: "ACRONYM" - attributes: (list - (list "CLASS" (gi))) - sosofo)))) +(define ($acronym-seq$ #!optional (sosofo (process-children))) + (let* ((acronym-remark (select-elements + (children (current-node)) + (normalize "remark")))) + (let* ((title (if (and acronym-remark + (equal? (attribute-string (normalize "role") acronym-remark) "acronym")) + (data acronym-remark) + ""))) + (make element gi: "ACRONYM" + attributes: (list + (list "CLASS" (gi)) + (list "TITLE" title)) + sosofo)))) + +(element (acronym remark) + (let* ((role (attribute-string (normalize "role")))) + (if (not (equal? role "acronym")) + ($charseq$) + (empty-sosofo)))) (define (book-titlepage-recto-elements) (list (normalize "title") @@ -305,6 +311,7 @@ (if (not (last-sibling? (current-node))) (literal ", ") (empty-sosofo)))) + ]]> Index: en_US.ISO8859-1/articles/vm-design/article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/vm-design/article.sgml,v retrieving revision 1.16 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$Translation:.*\$ -I\$hrs:.*\$ -r1.16 article.sgml --- en_US.ISO8859-1/articles/vm-design/article.sgml 24 Sep 2006 13:36:59 -0000 1.16 +++ en_US.ISO8859-1/articles/vm-design/article.sgml 12 Dec 2008 16:25:08 -0000 @@ -34,7 +34,7 @@ The title is really just a fancy way of saying that I am going to - attempt to describe the whole VM enchilada, hopefully in a way that + attempt to describe the whole VMVirtual Memory enchilada, hopefully in a way that everyone can follow. For the last year I have concentrated on a number of major kernel subsystems within FreeBSD, with the VM and Swap subsystems being the most interesting and NFS being a necessary ----Next_Part(Sat_Dec_13_01_46_06_2008_632)---- ----Security_Multipart0(Sat_Dec_13_01_46_06_2008_990)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAklClU4ACgkQTyzT2CeTzy01sACdHFFABUM+GFAfUH4/7WN2ROui KxYAnjuO7RXs2GxfHmTcq/+uOF2uR+0X =jvdq -----END PGP SIGNATURE----- ----Security_Multipart0(Sat_Dec_13_01_46_06_2008_990)----