Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 18 May 2013 20:59:53 +0200
From:      Ulrich =?utf-8?B?U3DDtnJsZWlu?= <uqs@FreeBSD.org>
To:        Gabor Kovesdan <gabor@FreeBSD.org>
Cc:        doc@FreeBSD.org
Subject:   Re: move roff papers from src to doc repository
Message-ID:  <20130518185953.GF2055@acme.spoerlein.net>
In-Reply-To: <51973BB7.3070600@FreeBSD.org>
References:  <20130518042340.GE2055@acme.spoerlein.net> <51973BB7.3070600@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130518185953.GF2055>