From owner-freebsd-doc@FreeBSD.ORG Mon Jun 17 20:05:35 2013 Return-Path: Delivered-To: freebsd-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 852913AE for ; Mon, 17 Jun 2013 20:05:35 +0000 (UTC) (envelope-from dru.lavigne@att.net) Received: from nm21.access.bullet.mail.sp2.yahoo.com (nm21.access.bullet.mail.sp2.yahoo.com [98.139.44.148]) by mx1.freebsd.org (Postfix) with ESMTP id 64F251CC9 for ; Mon, 17 Jun 2013 20:05:35 +0000 (UTC) Received: from [98.139.44.102] by nm21.access.bullet.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 20:05:28 -0000 Received: from [98.139.44.74] by tm7.access.bullet.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 20:05:28 -0000 Received: from [127.0.0.1] by omp1011.access.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 20:05:28 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 962604.53051.bm@omp1011.access.mail.sp2.yahoo.com Received: (qmail 6385 invoked by uid 60001); 17 Jun 2013 20:05:28 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s1024; t=1371499528; bh=Oyppk+Pv930E1rZ9Cpg7s987X09l33Bi2apIa1l/c6Y=; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Subject:To:In-Reply-To:MIME-Version:Content-Type; b=A//GvJQ7cMC9HKnDdqySUsPo8JYx3rCVqGxUPSXUw+pGXYS+EamIKzH0eclB/KXjgJ9NRsci6odwOfoQnu93mP4MSoBPIoGGeQ41X9T4ga8snaVHJ0kEY5LATTg7spLzVYWwdrboAL+/nTi5wEfSpdG1TuSjtet7VALSDYS6Ot0= DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=att.net; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Subject:To:In-Reply-To:MIME-Version:Content-Type; b=jC96TAEXnq1XxqKzA+irnD6XTzx0FahKe5yHgB3mC7G+l7tIkF25NZG3yMnNkZcGAf1Nx8VOUFAIx6XVYWp4kW5tmk3gqB/+ygKhjzB4DSAtP1hplL39zM090rhnsrkYSQUiU94SZRxzNf/pzSRM4gBgobfkcDPDCkK4BSKMpdc=; X-YMail-OSG: Fkr24fYVM1lkP0TYiyBgsXl_DD.Lj.saK7aLKXfCCQYi4y8 .dtXh6qYdeNPaO6gGCR8CWRVlE_BNanjBj3G48J7VzbwcNQvmRldw7v.SgNX n7Q228O.EvYZUkfJKJi2P37MIbh0ITByQHeegerU640g9SWtUuZwDjyjIFsv IN.aUEaK446TMNjeNBQgOnBgaTklwS5PjPOkDr8PhZvpbxm9NTA7wp.HZDWV LyZ471shuQfFePTN0R7QFGRy.ci5f2K_nUThGT3keCm.UBW_AfA5ZtV2KQEv vt0wY5bml3KX7V2LXnGco4bu97noIXzu8h6LNVk_KTpkjEEiUWBK2CmyycGc 7eD6SBKSN0cnk_wtJWBX..MOXIvmQDmPhvKKbnSGA7OT64LAxbDWC2sv44F0 REv1wplQOaFXQlKHN6ejUatYAp2bi5xCUiKG3PLX6PtaKsCuCDb6tcLOz5iz gd_MSjYKY5oBMc8OhDk4fBUxVCNawmkEC4selQmt9CihruKdFukNxPN0n9_s NGmKkVsjUK5xLvfQwpebf1bkXoWWrVWM8PIzwgYKZlDia Received: from [98.100.91.226] by web184906.mail.gq1.yahoo.com via HTTP; Mon, 17 Jun 2013 13:05:28 PDT X-Rocket-MIMEInfo: 002.001, Z2E.IEVtIDA1LTA2LTIwMTMgMTQ6MTAsIEhpcm9raSBTYXRvIGVzY3JldmV1OgpnYT4gPiBHYWJvciBLb3Zlc2RhbiA8Z2Fib3IgYXQgRnJlZUJTRC5vcmc.IHdyb3RlCmdhPiA.ICAgIGluIDw1MTlGQTRGRS40MDMwMzA1IGF0IEZyZWVCU0Qub3JnPjoKZ2E.ID4KZ2E.ID4gZ2E.IHVzZXJuYW1lIC0tPiBzeXN0ZW1pdGVtIGNsYXNzPSJ1c2VybmFtZSIKZ2E.ID4gZ2E.IGdyb3VwbmFtZSAtLT4gc3lzdGVtaXRlbSBjbGFzcz0iZ3JvdXBuYW1lIgpnYT4gPiBnYT4gaG9zdGlkIHJvbGU9ImZxZG4iIC0tPiBzeXMBMAEBAQE- X-Mailer: YahooMailClassic/16.0.3 YahooMailWebService/0.8.147.553 Message-ID: <1371499528.97592.YahooMailClassic@web184906.mail.gq1.yahoo.com> Date: Mon, 17 Jun 2013 13:05:28 -0700 (PDT) From: Dru Lavigne Subject: Re: RFC: Upgrading to DocBook 5.0 To: freebsd-doc@freebsd.org In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 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: Mon, 17 Jun 2013 20:05:35 -0000 ga> Em 05-06-2013 14:10, Hiroki Sato escreveu: ga> > Gabor Kovesdan wrote ga> > in <519FA4FE.4030305 at FreeBSD.org>: ga> > ga> > ga> username --> systemitem class="username" ga> > ga> groupname --> systemitem class="groupname" ga> > ga> hostid role="fqdn" --> systemitem class="fqdomainname" ga> > ga> hostid role="hostname" --> systemitem class="fqdomainname" ga> > ga> hostid role="domainname" --> systemitem class="fqdomainname" ga> > ga> hostid role="netmask" --> systemitem class="netmask" ga> > ga> hostid role="mac" --> systemitem class="etheraddress" ga> > ga> hostid role="ipaddr" --> systemitem class="ipaddress" ga> > ga> hostid --> systemitem ga> > ga> > Hmm, I do not like to create "a rule" to mark up both a username and ga> > a hostname by using element without attribute. Even if ga> > the rendering results are the same, they are different. Is it ga> > problem with allowing both writing s without attribute ga> > and adding attributes into them later (or at the same time)? I do ga> > not think limiting the vocabulary is useful for learning. Allowing ga> > people who are not familiar with DocBook to mark up by using ga> > only should be enough if it is really an issue. ga> Technically it is easily possible to convert them "correctly", i.e. as ga> described above, it was just my suggestion to leave out class ga> attributes. It is also possible to allow systemitem with and without ga> the class attribute specified. Yes, it is just my preference, too. ga> > ga> This is actually a type of file and the filename class attribute ga> > may ga> > ga> also be devicefile, which expresses its semantics. Again, we ga> > should ga> > ga> consider dropping the class attributes to simplify things: ga> > ga> devicename --> filename class="devicefile" ga> > ga> ga> > ga> These are not actually distinguished in formatting and the package ga> > ga> element expresses them better: ga> > ga> filename role="package" --> package ga> > ga> filename role="port" --> package ga> > ga> > package should support a role to distinguish if it is a port or a ga> > package because the linkend can be different. The following DSSSL ga> > fragment was removed in our XSLT: ga> > ga> > ---- ga> > (element filename ga> > (let* ((class (attribute-string (normalize "role")))) ga> > (cond ga> > ((equal? class "package") ga> > (let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi") ga> > (href (string-append urlurl "?ports/" ga> > (data (current-node)) ga> > "/pkg-descr"))) ga> > (create-link (list (list "HREF" href)) ($mono-seq$)))) ga> > (else ($mono-seq$))))) ga> > ---- ga> It's true that I didn't notice this distinction in the rendering. But ga> why not addding this link to both packages and ports? My personal ga> impression is that there are people, who mostly use packages and ga> others, who use ports. This preference is independent from the ga> context. If the text talks about the textproc/docproj ports but I ga> prefer dealing with packages, I will still want to install the package ga> and vice versa. In the essence, they are the same. This is why I would ga> not distinguish them. I think both can have a link, but ftp/wget and wget-1.14.tbz will have different linkends, for example. Although a single linkend like http://.../ports/ftp/wget.html can be applied to the both via XSLT, algorithms of URL generation from the markup text become different between ports and packages. Simplification of markup restricts such a possibility, I think. Can we have a summary for the FDP (and for the benefit of Handbook editors) of when/if systemitem class= should be used? Are there also systemitems for the different types of s which should be used instead? Cheers, Dru