From owner-freebsd-doc@FreeBSD.ORG Thu Nov 7 18:23:21 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 4D0A73A4 for ; Thu, 7 Nov 2013 18:23:21 +0000 (UTC) (envelope-from gabor@kovesdan.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 01672237F for ; Thu, 7 Nov 2013 18:23:20 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id F319614D250C for ; Thu, 7 Nov 2013 19:23:18 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id IQwXq2-n39qA for ; Thu, 7 Nov 2013 19:23:15 +0100 (CET) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id CC5FF14D2436 for ; Thu, 7 Nov 2013 19:23:15 +0100 (CET) Message-ID: <527BDA8B.3030908@kovesdan.org> Date: Thu, 07 Nov 2013 19:23:07 +0100 From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Re: [HEADSUP] Merging DocBook 5.0 update References: <527BADCB.8030308@kovesdan.org> In-Reply-To: <527BADCB.8030308@kovesdan.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit 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: Thu, 07 Nov 2013 18:23:21 -0000 On 2013.11.07. 16:12, Gábor Kövesdán wrote: > Hi, > > I will soon merge the DocBook 5.0 updates to head. The tree will > temporarily be locked until the merge is done. I will send out another > email I have finished. > The merge is done, head is now open again for commits. What you should know about the new infrastructure: - Basically, things work more or less in the same way, except that the tools, that we use for generating the printed output, are different. - Instead of the id attribute, now we use xml:id. - Linking is done with the xlink:href attribute, which can be used on most DocBook elements. Cross-references sill work with the xref element, these generate the link text based on the destination and thus are empty elements. If you want to specify the link text, use the link element with the link text enclosed in the element. - Instead of articleinfo, bookinfo, sect1info etc. now we simply use info. - For a more detailed explanation on the DocBook 5.0 markup changes see this: http://docbook.org/docs/howto/#changes I hope I will have time to update the fdp-primer soon as well. Before you commit, please make sure you run *make lint*. It will validate the documents and tell you about errors in the markup. If they validate fine, rendering should be OK. For this, you don't need Java, only PDF documents require it. There are some element name changes that are meant to reduce and rationalize our DocBook customization layer. I will report these back to the DocBook project, hoping that they will include some of our extensions in further versions: - makevar is now varname - maketarget is now buildtarget - svnref is now revnumber - devicename is now filename - username is now systemitem class="username" - groupname is now systemitem class="groupname" - hostid role=XXX is now systemitem role=YYY - filename role="package" is now package - filename role="port" is now package role="port" Thanks The FreeBSD Foundation for their support on this work and to Hiroki Sato (hrs@) for his comments and review on the pathset and to the rest of people, who commented on the PDF output. Also, big thanks to Glen Barber (gjb@) for updating the cluster to the new dependencies. I hope you will enjoy the new PDF documentation, which looks much better than the old one, yet it still needs some refinements. These adjustments will be done continuously from now on. Gabor