From owner-svn-doc-head@FreeBSD.ORG  Wed Mar  6 20:39:36 2013
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id 578CD12A;
 Wed,  6 Mar 2013 20:39:36 +0000 (UTC)
 (envelope-from pali.gabor@gmail.com)
Received: from mail-ob0-x230.google.com (mail-ob0-x230.google.com
 [IPv6:2607:f8b0:4003:c01::230])
 by mx1.freebsd.org (Postfix) with ESMTP id 01A5F6D3;
 Wed,  6 Mar 2013 20:39:35 +0000 (UTC)
Received: by mail-ob0-f176.google.com with SMTP id v19so3864470obq.21
 for <multiple recipients>; Wed, 06 Mar 2013 12:39:35 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:x-received:sender:in-reply-to:references:date
 :x-google-sender-auth:message-id:subject:from:to:cc:content-type;
 bh=qElD40jzz3hy8tgujnvMtJ/puZEeHwgf4JT8seAorIc=;
 b=QVEZUW0d/NT0SeMA8g7sk86WOVouR9FPpoXt+FJct7ceHvgTNHDmLhSfTwcclRnLCe
 SWehh+k9PVhFhhnypIYrnxDNB0t252QnjegfmXj3XDBb9b7AQyQ9J9ips4PS0jYqLxHp
 u5MnsCaMkDoTw0SsUBligQyyNn+PihbVqGRJwNHXheoft3p1D2+RNlqjzroTFuQ5fmTd
 Rz1f0wmawe4D0U7sHX/MRc3sWjq4gPQHwHV2XqOsctzjOwh4fUiwtoNgXLBRladI+cvz
 VSHHLI1ed6ep4Dok3M6tqTrIm8b/y5O37G3salr+MuWPrEgu0mkTKlxPzAHvGQA+hBd1
 6o/g==
MIME-Version: 1.0
X-Received: by 10.182.222.101 with SMTP id ql5mr21611345obc.55.1362602375652; 
 Wed, 06 Mar 2013 12:39:35 -0800 (PST)
Sender: pali.gabor@gmail.com
Received: by 10.182.87.195 with HTTP; Wed, 6 Mar 2013 12:39:35 -0800 (PST)
In-Reply-To: <5137A6EB.3000507@FreeBSD.org>
References: <201303061910.r26JAnUN037073@svn.freebsd.org>
 <5137A6EB.3000507@FreeBSD.org>
Date: Wed, 6 Mar 2013 21:39:35 +0100
X-Google-Sender-Auth: 8NxLenm8gogvMfzae91iWlNQ3E4
Message-ID: <CAHnG2CzbLTckquPzy8s-RoHPZhC_3FsLGv+8aZEPfvpoGwPHLQ@mail.gmail.com>
Subject: Re: svn commit: r41112 - head/en_US.ISO8859-1/books/porters-handbook
From: Gabor Pali <pgj@FreeBSD.org>
To: Gabor Kovesdan <gabor@freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1
Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org,
 doc-committers@freebsd.org
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 06 Mar 2013 20:39:36 -0000

On Wed, Mar 6, 2013 at 9:28 PM, Gabor Kovesdan <gabor@freebsd.org> wrote:
> It would be preferred to move this a bit more above to avoid comments in the
> preamble.

Right.

> This will fail to build once you add any more row entries below this. XML
> entities must be well-nested (which means practically the same as
> well-formed) so they must have exactly one root element. A possible solution
> is factoring out the whole table to the uses.xml file.

Hm...  That was my initial idea, but I tried to spare ports people
(like bapt) from the added syntactical noise.  I will play with this
further and refactor, but actually I did not see any difficulty with
this as, to my intuition, the entity is just replaced by the contents
textually.

Probably that is what I missed to consider?