From owner-svn-doc-head@FreeBSD.ORG  Wed Mar  6 20:28:43 2013
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@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 14FC5D6E;
 Wed,  6 Mar 2013 20:28:43 +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 A9257639;
 Wed,  6 Mar 2013 20:28:42 +0000 (UTC)
Received: from server.mypc.hu (localhost [127.0.0.1])
 by server.mypc.hu (Postfix) with ESMTP id E8C9414D2516;
 Wed,  6 Mar 2013 21:28:34 +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 QcNMZrT3L8lM; Wed,  6 Mar 2013 21:28:26 +0100 (CET)
Received: from [192.168.1.103] (5403A6BE.catv.pool.telekom.hu [84.3.166.190])
 (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
 (No client certificate requested)
 by server.mypc.hu (Postfix) with ESMTPSA id 8C64814D2431;
 Wed,  6 Mar 2013 21:28:25 +0100 (CET)
Message-ID: <5137A6EB.3000507@FreeBSD.org>
Date: Wed, 06 Mar 2013 21:28:27 +0100
From: Gabor Kovesdan <gabor@FreeBSD.org>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:17.0) Gecko/20130107 Thunderbird/17.0.2
MIME-Version: 1.0
To: Gabor Pali <pgj@FreeBSD.org>
Subject: Re: svn commit: r41112 - head/en_US.ISO8859-1/books/porters-handbook
References: <201303061910.r26JAnUN037073@svn.freebsd.org>
In-Reply-To: <201303061910.r26JAnUN037073@svn.freebsd.org>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
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:28:43 -0000

Em 06-03-2013 20:10, Gabor Pali escreveu:
>
> Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Wed Mar  6 18:12:47 2013	(r41111)
> +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Wed Mar  6 19:10:49 2013	(r41112)
> @@ -3,7 +3,6 @@
>   	"../../../share/xml/freebsd42.dtd" [
>   <!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN" "../../share/xml/entities.ent">
>   %entities;
> -]>
>   
>   <!--
>        The FreeBSD Documentation Project
> @@ -11,6 +10,9 @@
>        $FreeBSD$
>   -->
>   
> +<!ENTITY values.uses SYSTEM "uses.xml">
> +]>
> +

It would be preferred to move this a bit more above to avoid comments in 
the preamble.
>
> Added: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
> ==============================================================================
> --- /dev/null	00:00:00 1970	(empty, because file is newly added)
> +++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Wed Mar  6 19:10:49 2013	(r41112)
> @@ -0,0 +1,26 @@
> +<!--
> +
> +  The FreeBSD Documentation Project
> +
> +  $FreeBSD$
> +
> +  This file documents the values of the USES make variable.  The format is
> +  easy to grasp from the already-added entries below (or use this scheme
> +  below as a skeleton):
> +
> +<row>
> +  <entry><literal>FEATURE</literal></entry>
> +  <entry>ARGUMENTS</entry>
> +  <entry>DESCRIPTION</entry>
> +</row>
> +
> +-->
> +
> +<row>
> +  <entry><literal>pathfix</literal></entry>
> +  <entry>none</entry>
> +  <entry>Look for the <filename>Makefile.in</filename> and
> +    <filename>configure</filename> files in the port's associated
> +    sources and fix common paths to make sure they respect the &os;
> +    hierarchy.</entry>
> +</row>
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.

Gabor