From owner-freebsd-doc@FreeBSD.ORG  Sat May 18 18:59:55 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 05E8B758;
 Sat, 18 May 2013 18:59:55 +0000 (UTC) (envelope-from uqs@FreeBSD.org)
Received: from acme.spoerlein.net (acme.spoerlein.net
 [IPv6:2a01:4f8:131:23c2::1])
 by mx1.freebsd.org (Postfix) with ESMTP id 97623E78;
 Sat, 18 May 2013 18:59:54 +0000 (UTC)
Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1])
 by acme.spoerlein.net (8.14.7/8.14.6) with ESMTP id r4IIxrq5032365
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
 Sat, 18 May 2013 20:59:53 +0200 (CEST)
 (envelope-from uqs@FreeBSD.org)
Date: Sat, 18 May 2013 20:59:53 +0200
From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= <uqs@FreeBSD.org>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Subject: Re: move roff papers from src to doc repository
Message-ID: <20130518185953.GF2055@acme.spoerlein.net>
References: <20130518042340.GE2055@acme.spoerlein.net>
 <51973BB7.3070600@FreeBSD.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <51973BB7.3070600@FreeBSD.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
Cc: doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 18 May 2013 18:59:55 -0000

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 at http://people.freebsd.org/~uqs/roff_papers_2.diff
Does that look good?

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?

Cheers,
Uli