From owner-freebsd-doc@FreeBSD.ORG Thu Aug 18 06:51:06 2011 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C9B881065680 for ; Thu, 18 Aug 2011 06:51:06 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from tux15.hoststar.at (tux15.hoststar.at [213.239.217.242]) by mx1.freebsd.org (Postfix) with ESMTP id 6417F8FC08 for ; Thu, 18 Aug 2011 06:51:05 +0000 (UTC) Received: from freebsd.bsdkisten.at (chello084115173108.graz.surfer.at [84.115.173.108]) (authenticated bits=0) by tux15.hoststar.at (8.13.8/8.12.11) with ESMTP id p7I6p2Qr008540; Thu, 18 Aug 2011 08:51:03 +0200 Message-ID: <4E4CB653.5040700@FreeBSD.org> Date: Thu, 18 Aug 2011 08:50:59 +0200 From: Johann Kois User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:6.0) Gecko/20110817 Thunderbird/6.0 MIME-Version: 1.0 To: Jason Helfman References: <20110816002225.7ebb265b@serene.no-ip.org> <4E4AD76C.6060508@FreeBSD.org> <20110816171311.1f845047@serene.no-ip.org> <4E4B8ED3.8040708@FreeBSD.org> <20110817125425.GA26287@lonesome.com> <20110817164653.GC79663@eggman.experts-exchange.com> In-Reply-To: <20110817164653.GC79663@eggman.experts-exchange.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Mark Linimon , freebsd-doc@FreeBSD.org Subject: Re: Broken link to articles/problem-reports/pr-writing.html in porters-handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Aug 2011 06:51:06 -0000 On 08/17/2011 18:46, Jason Helfman wrote: > On Wed, Aug 17, 2011 at 07:54:25AM -0500, Mark Linimon thus spake: >> On Wed, Aug 17, 2011 at 11:50:11AM +0200, Johann Kois wrote: >>> For example if you build the local handbook you will get no >>> book.html. If you build a local article you will get only >>> article.html, but no "split-html". >> >> I usually test by e.g. 'make book.html' instead of just 'make'. I find >> it easier to search for things on the single output. Either way works. >> >> mcl > > I build the entire site @work, and get both split and one page (book), and > haven't had any issues yet with it. Well, the "problem" is you should not get both versions. ;-) For example: * Makefile for the fdp-primer: FORMATS?= html html-split (so you get both formats, both locally and on FreeBSD.org) * Makefile for the handbook: FORMATS?= html-split (so no book.html when built locally, although it is there on www.FreeBSD.org). * Makefile for all the articles: FORMATS?= html (so only article.html when built locally, but also "html-split files" when built on FreeBSD.org). This happens when you build the documentation from within the doc tree (so for example started from a checked out doc/en_US.ISO8859-1 dir). So something is done differently when you create a full copy of FreeBSD www/doc. At least that is how it looks to me. jkois -- Johann Kois jkois(at)FreeBSD.org FreeBSD Documentation Project FreeBSD German Documentation Project - https://doc.bsdgroup.de