Обсуждение: small improvement to G.2.4.1. Installing OpenJade
Hi there, just spent several hours to build developers documentation following http://developer.postgresql.org/pgdocs/postgres/docguide-toolsets.html and noticed one problem. Installation of OpenJade is a two-step process - firstm, you need to install OpenSP and then OpenJade, so it's important to say, that configure option --enable-default-catalog=/usr/local/share/sgml/catalog should be used in <b>both</b> steps. Regards, Oleg _____________________________________________________________ Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru), Sternberg Astronomical Institute, Moscow University, Russia Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/ phone: +007(495)939-16-83, +007(495)939-23-83
Oleg Bartunov wrote: > just spent several hours to build developers documentation following > http://developer.postgresql.org/pgdocs/postgres/docguide-toolsets.htm >l and noticed one problem. Installation of OpenJade is a two-step > process - firstm, you need to install OpenSP and then OpenJade, so > it's important to say, that configure option > --enable-default-catalog=/usr/local/share/sgml/catalog should be used > in <b>both</b> steps. I think the configure option only belongs with OpenSP, because OpenJade is not an SGML parser, so it wouldn't need that information. I think the installation instructions belong to an older version of these packages. I'll check with the latest versions and update the instructions. -- Peter Eisentraut http://developer.postgresql.org/~petere/
On Wed, 15 Nov 2006, Peter Eisentraut wrote: > Oleg Bartunov wrote: >> just spent several hours to build developers documentation following >> http://developer.postgresql.org/pgdocs/postgres/docguide-toolsets.htm >> l and noticed one problem. Installation of OpenJade is a two-step >> process - firstm, you need to install OpenSP and then OpenJade, so >> it's important to say, that configure option >> --enable-default-catalog=/usr/local/share/sgml/catalog should be used >> in <b>both</b> steps. > > I think the configure option only belongs with OpenSP, because OpenJade > is not an SGML parser, so it wouldn't need that information. I think > the installation instructions belong to an older version of these > packages. I'll check with the latest versions and update the > instructions. Yes, it's OpenSP option ! Also, I had to install docbook2man-sgmlspl, since it was removed from docbook2X and distributed independently. To built man pages I had to export D2MDIR=/usr/bin On slackware box the best way is to install slackware's sgml-tools package and then follow documentation guide. btw, is there template for manual, so I could write separate chapter not bothering with the whole manual ? > > Regards, Oleg _____________________________________________________________ Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru), Sternberg Astronomical Institute, Moscow University, Russia Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/ phone: +007(495)939-16-83, +007(495)939-23-83