move roff papers from src to doc repository

[Gabor Kovesdan]

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