pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedSGML makefile
7+ messages / 3 participants
[nested] [flat]
* SGML makefile
@ 2001-11-23 07:51 Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 2 replies; 7+ messages in thread
From: Bruce Momjian @ 2001-11-23 07:51 UTC (permalink / raw)
To: pgsql-docs
Can I ask why we seem to build the HTML twice in the SGML makefile?
$(addsuffix .tar, $(BOOKS)):
$(MAKE) -C sgml clean
1) $(MAKE) -C sgml $(basename $@).html
2) $(MAKE) -C sgml $(basename $@).html JADEFLAGS='-V html-manifest'
cd sgml && $(TAR) -cf ../$@ `cat HTML.manifest` `echo *.gif | grep -v '\*'` *.css
I don't understand.
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 16:25 Tom Lane <tgl@sss.pgh.pa.us>
parent: Bruce Momjian <pgman@candle.pha.pa.us>
1 sibling, 0 replies; 7+ messages in thread
From: Tom Lane @ 2001-11-23 16:25 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; +Cc: pgsql-docs
Bruce Momjian <pgman@candle.pha.pa.us> writes:
> Can I ask why we seem to build the HTML twice in the SGML makefile?
I suspect that's to get the indexes right. Peter?
regards, tom lane
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 16:56 Peter Eisentraut <peter_e@gmx.net>
parent: Bruce Momjian <pgman@candle.pha.pa.us>
1 sibling, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2001-11-23 16:56 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; +Cc: pgsql-docs
Bruce Momjian writes:
> Can I ask why we seem to build the HTML twice in the SGML makefile?
It's to resolve the index entries. Think LaTeX.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 17:05 Bruce Momjian <pgman@candle.pha.pa.us>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 7+ messages in thread
From: Bruce Momjian @ 2001-11-23 17:05 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> Bruce Momjian writes:
>
> > Can I ask why we seem to build the HTML twice in the SGML makefile?
>
> It's to resolve the index entries. Think LaTeX.
OK, got it. LaTeX sometimes builds three times. :-)
I added a comment to document the purpose. Thanks.
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 17:34 Tom Lane <tgl@sss.pgh.pa.us>
parent: Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 2001-11-23 17:34 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
Bruce Momjian <pgman@candle.pha.pa.us> writes:
> I added a comment to document the purpose. Thanks.
Um ... is it portable to stick a comment into the body of a make
rule like that? Shell comments and make comments aren't always
the same.
regards, tom lane
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 17:53 Bruce Momjian <pgman@candle.pha.pa.us>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 7+ messages in thread
From: Bruce Momjian @ 2001-11-23 17:53 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
> Bruce Momjian <pgman@candle.pha.pa.us> writes:
> > I added a comment to document the purpose. Thanks.
>
> Um ... is it portable to stick a comment into the body of a make
> rule like that? Shell comments and make comments aren't always
> the same.
I thought about that. Gmake texinfo manual says it is OK. I don't see
any other uses of it in our source, though.
---------------------------------------------------------------------------
The commands of a rule consist of shell command lines to be executed
one by one. Each command line must start with a tab, except that the
first command line may be attached to the target-and-prerequisites line
with a semicolon in between. Blank lines and lines of just comments
may appear among the command lines; they are ignored. (But beware, an
apparently "blank" line that begins with a tab is _not_ blank! It is an
empty command; *note Empty Commands::.)
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: SGML makefile
@ 2001-11-23 18:00 Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 0 replies; 7+ messages in thread
From: Bruce Momjian @ 2001-11-23 18:00 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-docs
I also see this. Looks OK:
Users use many different shell programs, but commands in makefiles
are always interpreted by `/bin/sh' unless the makefile specifies
otherwise. *Note Command Execution: Execution.
The shell that is in use determines whether comments can be written
on command lines, and what syntax they use. When the shell is
`/bin/sh', a `#' starts a comment that extends to the end of the line.
The `#' does not have to be at the beginning of a line. Text on a line
before a `#' is not part of the comment.
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2001-11-23 18:00 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-11-23 07:51 SGML makefile Bruce Momjian <pgman@candle.pha.pa.us>
2001-11-23 16:25 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-11-23 16:56 ` Peter Eisentraut <peter_e@gmx.net>
2001-11-23 17:05 ` Bruce Momjian <pgman@candle.pha.pa.us>
2001-11-23 17:34 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-11-23 17:53 ` Bruce Momjian <pgman@candle.pha.pa.us>
2001-11-23 18:00 Re: SGML makefile Bruce Momjian <pgman@candle.pha.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox