From owner-freebsd-doc@FreeBSD.ORG Fri May 31 07:27:36 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 69322B9 for ; Fri, 31 May 2013 07:27:36 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 2836BA4D for ; Fri, 31 May 2013 07:27:36 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 9912A14D2519 for ; Fri, 31 May 2013 09:20:12 +0200 (CEST) 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 4vBjqM7ZfyQ8 for ; Fri, 31 May 2013 09:20:10 +0200 (CEST) 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 66C6714D2516 for ; Fri, 31 May 2013 09:20:10 +0200 (CEST) Message-ID: <51A84F2C.9030504@FreeBSD.org> Date: Fri, 31 May 2013 09:20:12 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Thunderbird/22.0 MIME-Version: 1.0 To: doc@freebsd.org Subject: Re: RFC: Upgrading to DocBook 5.0 References: <519FA4FE.4030305@FreeBSD.org> <51A51C40.1030205@FreeBSD.org> In-Reply-To: <51A51C40.1030205@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit 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: Fri, 31 May 2013 07:27:36 -0000 Em 28-05-2013 23:06, Gabor Kovesdan escreveu: > I have a patch to preview how it would look like: > http://kovesdan.org/patches/fbsd-docbook5.diff > > Please comment on this. It is very important to discuss this kind of > changes. There are three more changes I would like to do. The maketarget and makevar elements always sounded a bit weird to me. I think they are too specific and do not reflect well the more general semantic nature of their content. 1, As for makevar, it is just a variable just like in any other programming language, so I propose that. 2, As for maketarget, it is a build target. Unfortunately, DocBook doesn't have an appropriate element for this, I'd like to use buildtarget and submit a feature request for that. 3, To mark up revision numbers, we use svnref, which generates links to our SVNWeb interface. The same happens here, revnumber would be just fine. The problem is plain DocBook doesn't allow it inline but I'd like to submit a feature request for this. Gabor