From owner-freebsd-doc@FreeBSD.ORG Sat May 18 22:43:47 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 137D487B; Sat, 18 May 2013 22:43:47 +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 C49E4820; Sat, 18 May 2013 22:43:46 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id C9F0914D2436; Sun, 19 May 2013 00:43:45 +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 fWiSzYuZOaWm; Sun, 19 May 2013 00:43:40 +0200 (CEST) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id A05C214D242E; Sun, 19 May 2013 00:43:40 +0200 (CEST) Message-ID: <5198041C.6000702@FreeBSD.org> Date: Sun, 19 May 2013 00:43:40 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:19.0) Gecko/20130104 Thunderbird/19.0a2 MIME-Version: 1.0 To: =?UTF-8?B?VWxyaWNoIFNww7ZybGVpbg==?= Subject: Re: move roff papers from src to doc repository References: <20130518042340.GE2055@acme.spoerlein.net> <51973BB7.3070600@FreeBSD.org> <20130518185953.GF2055@acme.spoerlein.net> In-Reply-To: <20130518185953.GF2055@acme.spoerlein.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Cc: doc@FreeBSD.org 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: Sat, 18 May 2013 22:43:47 -0000 On 2013.05.18. 20:59, Ulrich Spörlein wrote: > On Sat, 2013-05-18 at 10:28:39 +0200, Gabor Kovesdan wrote: >> >Em 18-05-2013 06:23, Ulrich Spörlein escreveu: >>> > >So, to get groff out of source we need to first remove the roff >>> > >docs/papers as we will no longer build and install them. As they still >>> > >contain conceivably useful information, I want to move them into the doc >>> > >repository. >> >I don't object to this but I'd like to see them better integrated. In >> >your patch, I see they use bsd.doc.mk, which is not in the doc >> >repository. I'd prefer having the Makefile code for these extracted into >> >a doc.groff.mk or whatever and integrated into the doc build. The >> >overall stuff should fit the existing conventions. > Second version is athttp://people.freebsd.org/~uqs/roff_papers_2.diff > Does that look good? Thanks, looks nice! > > It makes things a bit more ugly, as we cannot rely on the system include > path anymore. The doc.troff.mk is stripped version of bsd.doc.mk, and > I'm not yet sure what to do with the install bits. > > What semantics should 'make install' have for docs in general. Also, do > we prefer to produce Postscript output for these, or ascii. What about > PDF, is ps2pdf included in the doc toolchain? In the doc tree we have a FORMATS variable, which determines what to generate. We support html, html-split, ps, pdf and txt. The default is set to one of the former two, depending on the particular document, but scheduled FTP builds build all of them and regularly update the doc set on the FTP sites. It would be nice if we could support the latter three in these papers, being one of them the default (txt, for example). Do you think it is possible? Yes, we have ps2pdf so you can rely on that. Gabor