From owner-freebsd-doc@FreeBSD.ORG Wed Jun 5 12:35:34 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 AABF381C; Wed, 5 Jun 2013 12:35:34 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id 299841716; Wed, 5 Jun 2013 12:35:34 +0000 (UTC) Received: from alph.d.allbsd.org (p2175-ipbf701funabasi.chiba.ocn.ne.jp [122.25.209.175]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id r55CZGpS027420 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 5 Jun 2013 21:35:26 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) (authenticated bits=0) by alph.d.allbsd.org (8.14.5/8.14.5) with ESMTP id r55CZEhR067478; Wed, 5 Jun 2013 21:35:15 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Wed, 05 Jun 2013 21:10:48 +0900 (JST) Message-Id: <20130605.211048.366435368879986578.hrs@allbsd.org> To: gabor@FreeBSD.org Subject: Re: RFC: Upgrading to DocBook 5.0 From: Hiroki Sato In-Reply-To: <519FA4FE.4030305@FreeBSD.org> References: <519FA4FE.4030305@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 24.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Wed_Jun__5_21_10_48_2013_696)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Wed, 05 Jun 2013 21:35:26 +0900 (JST) X-Spam-Status: No, score=-94.5 required=13.0 tests=CONTENT_TYPE_PRESENT, ONLY1HOPDIRECT,RCVD_IN_PBL,SAMEHELOBY2HOP,USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org 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: Wed, 05 Jun 2013 12:35:34 -0000 ----Security_Multipart(Wed_Jun__5_21_10_48_2013_696)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Gabor Kovesdan wrote in <519FA4FE.4030305@FreeBSD.org>: ga> username --> systemitem class="username" ga> groupname --> systemitem class="groupname" ga> hostid role="fqdn" --> systemitem class="fqdomainname" ga> hostid role="hostname" --> systemitem class="fqdomainname" ga> hostid role="domainname" --> systemitem class="fqdomainname" ga> hostid role="netmask" --> systemitem class="netmask" ga> hostid role="mac" --> systemitem class="etheraddress" ga> hostid role="ipaddr" --> systemitem class="ipaddress" ga> hostid --> systemitem Hmm, I do not like to create "a rule" to mark up both a username and a hostname by using element without attribute. Even if the rendering results are the same, they are different. Is it problem with allowing both writing s without attribute and adding attributes into them later (or at the same time)? I do not think limiting the vocabulary is useful for learning. Allowing people who are not familiar with DocBook to mark up by using only should be enough if it is really an issue. ga> This is actually a type of file and the filename class attribute may ga> also be devicefile, which expresses its semantics. Again, we should ga> consider dropping the class attributes to simplify things: ga> devicename --> filename class="devicefile" ga> ga> These are not actually distinguished in formatting and the package ga> element expresses them better: ga> filename role="package" --> package ga> filename role="port" --> package package should support a role to distinguish if it is a port or a package because the linkend can be different. The following DSSSL fragment was removed in our XSLT: ---- (element filename (let* ((class (attribute-string (normalize "role")))) (cond ((equal? class "package") (let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi") (href (string-append urlurl "?ports/" (data (current-node)) "/pkg-descr"))) (create-link (list (list "HREF" href)) ($mono-seq$)))) (else ($mono-seq$))))) ---- -- Hiroki ----Security_Multipart(Wed_Jun__5_21_10_48_2013_696)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.13 (FreeBSD) iEYEABECAAYFAlGvKsgACgkQTyzT2CeTzy09xQCdHLwi5itfu21vC0Qw6cHnv+IL T+QAnRwuKtgCtJKi9FbUrojX+AwD8Oun =J87K -----END PGP SIGNATURE----- ----Security_Multipart(Wed_Jun__5_21_10_48_2013_696)----