Bug #278

PATCH build documentation project with pkgsrc

Added by victor over 8 years ago. Updated about 8 years ago.

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/

Please, see the readme before!

History

#1 Updated by justin over 8 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/
>
> Please, see the readme before!

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').

tex-jadetex is needed to generate the PDF version ('make book.pdf').

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)
---! /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
/usr/pkg/bin/tex "&jadetex" ' \nonstopmode\input{book.tex}'
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
/usr/pkg/bin/tex "&jadetex" ' \nonstopmode\input{book.tex}'
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
This is dvips(k) 5.95a Copyright 2005 Radical Eye Software
(www.radicaleye.com)
/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
crack at it, please do.

#2 Updated by joerg over 8 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
> /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.

Joerg

#3 Updated by justin over 8 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 victor over 8 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 victor over 8 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 justin over 8 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
updates in that file?

#7 Updated by victor over 8 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
> updates in that file?

In the last change i've just added some environment variables so that
tex utils can find the fmt files and changed pdflatex for pdfetex
and tex for etex.
The part of using etex instead of tex yes, it's from FreeBSD. The
part about environment variables is mine.

I haven't noticed if there were any other updates. So no, I haven't
imported the rest of the updates.

Also available in: Atom PDF