## Bug #278

### PATCH build documentation project with pkgsrc

Status:ClosedStart date:
Priority:NormalDue date:
Assignee:justin% Done:

0%

Category:-
Target version:-

Description

Hi,
Justin Sherrill and I have created a patch for making the
documentation project compilable with pkgsrc. Right now it
does build the handbook and the arch handbook without
troubles.

You can find the patch here: http://bsdes.net/~victor/dfbsd/

### History

#### #1 Updated by justinover 9 years ago

On Thu, August 3, 2006 3:47 pm, Victor Balada Diaz wrote:
> Hi,
> Justin Sherrill and I have created a patch for making the
> documentation project compilable with pkgsrc. Right now it
> does build the handbook and the arch handbook without
> troubles.
>
> You can find the patch here: http://bsdes.net/~victor/dfbsd/
>

Part of the strategy here is that instead of coming up with a DragonFly
version of scr2png, we delete the .scr files (screen captures produced by
vidcontrol) and put in .png equivalents. It seems unnecessary to put
logic into the doc build system to convert these when we can just put in
converted files, as it's not hard to produce .pngs.

If you need to build this, the needed pkgsrc packages appear to be
netbsd-doc, libxslt, docbook-xsl, ghostscript-gnu, netpbm, and jade to
generate HTML ('make').

It produces the web pages fine, however, creating the PDF produces this
error:

==> TeX pass 1/3
This is TeX, Version 3.141592 (Web2C 7.5.4)
---! /usr/pkg/share/texmf/web2c/jadetex.fmt was written by pdfetex
(Fatal format file error; I'm stymied)
*** Error code 1 (ignored)
==> TeX pass 2/3
This is TeX, Version 3.141592 (Web2C 7.5.4)
---! /usr/pkg/share/texmf/web2c/jadetex.fmt was written by pdfetex
(Fatal format file error; I'm stymied)
*** Error code 1 (ignored)
==> TeX pass 3/3
This is TeX, Version 3.141592 (Web2C 7.5.4)
---! /usr/pkg/share/texmf/web2c/jadetex.fmt was written by pdfetex
(Fatal format file error; I'm stymied)
*** Error code 1 (ignored)
/usr/pkg/bin/dvips -o book.ps book.dvi
/usr/pkg/bin/dvips: ! DVI file can't be opened.
*** Error code 1

Stop in /home/justin/doc/en/books/handbook.

I don't know the immediate cause; there may be a package missing that's
needed, or something else. I don't think the .scr file removal could
cause this. I'll test more tomorrow. If anyone else wants to take a

#### #2 Updated by joergover 9 years ago

On Fri, Aug 04, 2006 at 12:43:38AM -0400, Justin C. Sherrill wrote:
> It produces the web pages fine, however, creating the PDF produces this
> error:
>
> ==> TeX pass 1/3
> This is TeX, Version 3.141592 (Web2C 7.5.4)

[snip]

Why do you use tex and not pdftex/pdfetex? I think that creating
postscript-dvi and converting them to PDF is quite inferior to doing it
directly.

Joerg

#### #3 Updated by justinover 9 years ago

On Fri, August 4, 2006 5:35 am, Joerg Sonnenberger wrote:
> [snip]
>
> Why do you use tex and not pdftex/pdfetex? I think that creating
> postscript-dvi and converting them to PDF is quite inferior to doing it
> directly.

Inertia - because that's what the doc build system was using when we
brought it in. Switching to pdftex sounds like a good idea, especially
since that part seems to be where we're having trouble.

The 'DocBook -> whatever' process has become more simplified as more free
tools have matured; the doc framework could use some updating.

#### #4 Updated by victorover 9 years ago

On Fri, Aug 04, 2006 at 12:43:38AM -0400, Justin C. Sherrill wrote:
> On Thu, August 3, 2006 3:47 pm, Victor Balada Diaz wrote:
> > You can find the patch here: http://bsdes.net/~victor/dfbsd/
>
> I don't know the immediate cause; there may be a package missing that's
> needed, or something else. I don't think the .scr file removal could
> cause this. I'll test more tomorrow. If anyone else wants to take a
> crack at it, please do.

I've updated the patch, it should work now. It's the same URL.
--
La prueba más fehaciente de que existe vida inteligente en otros
planetas, es que no han intentado contactar con nosotros.

#### #5 Updated by victorover 9 years ago

On Fri, Aug 04, 2006 at 11:35:40AM +0200, Joerg Sonnenberger wrote:
> On Fri, Aug 04, 2006 at 12:43:38AM -0400, Justin C. Sherrill wrote:
> > It produces the web pages fine, however, creating the PDF produces this
> > error:
> >
> > ==> TeX pass 1/3
> > /usr/pkg/bin/tex "&jadetex" ' \nonstopmode\input{book.tex}'
> > This is TeX, Version 3.141592 (Web2C 7.5.4)
>
> [snip]
>
> Why do you use tex and not pdftex/pdfetex? I think that creating
> postscript-dvi and converting them to PDF is quite inferior to doing it
> directly.

My current objetive right now is making it work. When that is done we
could try to improve it, but the first step is making it work with
minor modifications.

#### #6 Updated by justinover 9 years ago

On Sat, August 5, 2006 7:32 am, Victor Balada Diaz wrote:
> On Fri, Aug 04, 2006 at 12:43:38AM -0400, Justin C. Sherrill wrote:
>> On Thu, August 3, 2006 3:47 pm, Victor Balada Diaz wrote:
>> > You can find the patch here: http://bsdes.net/~victor/dfbsd/
>>
>> I don't know the immediate cause; there may be a package missing that's
>> needed, or something else. I don't think the .scr file removal could
>> cause this. I'll test more tomorrow. If anyone else wants to take a
>> crack at it, please do.
>
> I've updated the patch, it should work now. It's the same URL.

I noticed that the FreeBSD version of share/mk/doc.docbook.mk has a fix
for it - is that where you got this? If so, did you bring up the other

#### #7 Updated by victorover 9 years ago

On Sun, Aug 06, 2006 at 12:29:06AM -0400, Justin C. Sherrill wrote:
> On Sat, August 5, 2006 7:32 am, Victor Balada Diaz wrote:
> > On Fri, Aug 04, 2006 at 12:43:38AM -0400, Justin C. Sherrill wrote:
> >> On Thu, August 3, 2006 3:47 pm, Victor Balada Diaz wrote:
> >> > You can find the patch here: http://bsdes.net/~victor/dfbsd/
> >>
> >> I don't know the immediate cause; there may be a package missing that's
> >> needed, or something else. I don't think the .scr file removal could
> >> cause this. I'll test more tomorrow. If anyone else wants to take a
> >> crack at it, please do.
> >
> > I've updated the patch, it should work now. It's the same URL.
>
> I noticed that the FreeBSD version of share/mk/doc.docbook.mk has a fix
> for it - is that where you got this? If so, did you bring up the other