[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
gEDA-user: pcb documentation build patches
- To: geda-user@xxxxxxxx
- Subject: gEDA-user: pcb documentation build patches
- From: Dan McMahill <dan@xxxxxxxxxxxx>
- Date: Fri, 24 Mar 2006 17:30:44 -0500
- Delivered-to: archiver@seul.org
- Delivered-to: geda-user-outgoing@seul.org
- Delivered-to: geda-user@seul.org
- Delivery-date: Fri, 24 Mar 2006 17:31:23 -0500
- Reply-to: geda-user@xxxxxxxx
- Sender: owner-geda-user@xxxxxxxx
- User-agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.7.11) Gecko/20050802
A number of people have had various problems building PCB documentation
from CVS sources. I have just checked in several changes to help
address these problems.
------------------------
Building from a distfile
------------------------
Nothing special should be needed. You should end up with documentation
and you should not need to worry about having certain tools available
just for building the docs.
------------------------
Building from CVS
------------------------
You should either
a) use --disable-doc to prevent building any docs
or
b)
i) use --enable-maintainer-mode which will turn on some
extra dependency rules for the documentation (normally
not in place so building from a distfile is easy).
ii) make sure you have version 4.6 or newer of texinfo
(run makeinfo --version to check)
iii) make sure you have latex installed
iv) make sure you compile in the png HID to pcb (this is
enabled by default).
As part of the changes, the build system should fail more gracefully if
you, for example, forget to install latex. I have also included some
checks for a new enough texinfo at configure time. Now if you are in
maintainer mode and have requested a build of the documentation,
configure will fail with an informative message if you don't have the
right tools.
------------------------
------------------------
Hope this helps out.
-Dan