Обсуждение: Building PDF documentation
I have determined that the HTML documentation must be built before any of the PDF makefile targets are valid, so I have applied the attached documentation patch to mention this. -- Bruce Momjian <bruce@momjian.us> http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + Index: doc/src/sgml/docguide.sgml =================================================================== RCS file: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v retrieving revision 1.78 diff -c -c -r1.78 docguide.sgml *** doc/src/sgml/docguide.sgml 9 Aug 2009 22:47:59 -0000 1.78 --- doc/src/sgml/docguide.sgml 22 Jan 2010 15:48:19 -0000 *************** *** 590,596 **** <para> If you want to use <application>JadeTex</application> to produce a ! printable rendition of the documentation, you can use one of the following commands: <itemizedlist> --- 590,597 ---- <para> If you want to use <application>JadeTex</application> to produce a ! printable rendition of the documentation, you must first build the ! <acronym>HTML</acronym> output as outlined above, then you can use one of the following commands: <itemizedlist>
Bruce Momjian <bruce@momjian.us> writes:
> I have determined that the HTML documentation must be built before any
> of the PDF makefile targets are valid, so I have applied the attached
> documentation patch to mention this.
Really? It seems to work for me without that. What do you observe
to go wrong?
regards, tom lane
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > I have determined that the HTML documentation must be built before any
> > of the PDF makefile targets are valid, so I have applied the attached
> > documentation patch to mention this.
>
> Really? It seems to work for me without that. What do you observe
> to go wrong?
Sure, here it is:
$ gmake clean
rm -f INSTALL HISTORY regress_README
rm -f INSTALL.html HISTORY.html regress_README.html
rm -f *.rtf *.tex-ps *.tex-pdf *.dvi *.aux *.log *.ps *.pdf *.out *.fot
rm -f HTML.index bookindex.sgml version.sgml features-supported.sgml
features-unsupported.sgml
rm -f postgres.xml htmlhelp.hhp toc.hhc index.hhk *.fo
rm -f *.texixml *.texi *.info db2texi.refs
$ gmake postgres.pdf
Makefile:172: *** Invalid target; use postgres-A4.pdf or
postgres-US.pdf as targets. Stop.
$ gmake postgres-A4.pdf
gmake: *** No rule to make target `postgres-A4.pdf'. Stop.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
Bruce Momjian <bruce@momjian.us> writes:
> Tom Lane wrote:
>> Really? It seems to work for me without that. What do you observe
>> to go wrong?
> $ gmake postgres-A4.pdf
> gmake: *** No rule to make target `postgres-A4.pdf'. Stop.
Works for me ... sure you've got a clean copy of the makefile?
regards, tom lane
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Tom Lane wrote:
> >> Really? It seems to work for me without that. What do you observe
> >> to go wrong?
>
> > $ gmake postgres-A4.pdf
> > gmake: *** No rule to make target `postgres-A4.pdf'. Stop.
>
> Works for me ... sure you've got a clean copy of the makefile?
Wow, that is odd then. I pulled down a new copy of CVS, ran configure,
and got the same result:
$ gmake postgres.pdf
Makefile:172: *** Invalid target; use postgres-A4.pdf or
postgres-US.pdf as targets. Stop.
$ gmake postgres-A4.pdf
gmake: *** No rule to make target `postgres-A4.pdf'. Stop.
My gmake is version 3.78.1.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
Bruce Momjian <bruce@momjian.us> writes:
> Wow, that is odd then. I pulled down a new copy of CVS, ran configure,
> and got the same result:
> $ gmake postgres.pdf
> Makefile:172: *** Invalid target; use postgres-A4.pdf or
> postgres-US.pdf as targets. Stop.
> $ gmake postgres-A4.pdf
> gmake: *** No rule to make target `postgres-A4.pdf'. Stop.
> My gmake is version 3.78.1.
Hmm. Might be time to get something a shade less creaky. It works for
me with gmake 3.79.1, released in 2000.
regards, tom lane
On fre, 2010-01-22 at 12:12 -0500, Tom Lane wrote: > Bruce Momjian <bruce@momjian.us> writes: > > Wow, that is odd then. I pulled down a new copy of CVS, ran configure, > > and got the same result: > > > $ gmake postgres.pdf > > Makefile:172: *** Invalid target; use postgres-A4.pdf or > > postgres-US.pdf as targets. Stop. > > $ gmake postgres-A4.pdf > > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > > > My gmake is version 3.78.1. > > Hmm. Might be time to get something a shade less creaky. It works for > me with gmake 3.79.1, released in 2000. Bruce and I had a chat about this and agreed to raise the "recommended" make version to 3.79.1, rather than hunting down this issue.
Peter Eisentraut wrote: > On fre, 2010-01-22 at 12:12 -0500, Tom Lane wrote: > > Bruce Momjian <bruce@momjian.us> writes: > > > Wow, that is odd then. I pulled down a new copy of CVS, ran configure, > > > and got the same result: > > > > > $ gmake postgres.pdf > > > Makefile:172: *** Invalid target; use postgres-A4.pdf or > > > postgres-US.pdf as targets. Stop. > > > $ gmake postgres-A4.pdf > > > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > > > > > My gmake is version 3.78.1. > > > > Hmm. Might be time to get something a shade less creaky. It works for > > me with gmake 3.79.1, released in 2000. > > Bruce and I had a chat about this and agreed to raise the "recommended" > make version to 3.79.1, rather than hunting down this issue. Agreed. I have reverted the doc mention about HTML being required first, and bumped up the required gmake version to 3.79.1; patch attached. -- Bruce Momjian <bruce@momjian.us> http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + Index: doc/src/sgml/docguide.sgml =================================================================== RCS file: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v retrieving revision 1.79 diff -c -c -r1.79 docguide.sgml *** doc/src/sgml/docguide.sgml 22 Jan 2010 15:49:29 -0000 1.79 --- doc/src/sgml/docguide.sgml 22 Jan 2010 22:48:55 -0000 *************** *** 590,597 **** <para> If you want to use <application>JadeTex</application> to produce a ! printable rendition of the documentation, you must first build the ! <acronym>HTML</acronym> output as outlined above, then you can use one of the following commands: <itemizedlist> --- 590,596 ---- <para> If you want to use <application>JadeTex</application> to produce a ! printable rendition of the documentation, you can use one of the following commands: <itemizedlist> Index: doc/src/sgml/installation.sgml =================================================================== RCS file: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v retrieving revision 1.338 diff -c -c -r1.338 installation.sgml *** doc/src/sgml/installation.sgml 16 Jan 2010 20:38:54 -0000 1.338 --- doc/src/sgml/installation.sgml 22 Jan 2010 22:48:58 -0000 *************** *** 79,85 **** <screen> <userinput>gmake --version</userinput> </screen> ! It is recommended to use version 3.76.1 or later. </para> </listitem> --- 79,85 ---- <screen> <userinput>gmake --version</userinput> </screen> ! It is recommended to use version 3.79.1 or later. </para> </listitem>