[DOCS] Why the separate jade calls for pdf and ps output?

2010-04-29 Thread Tom Lane
doc/src/sgml/Makefile asserts

# Regular TeX and pdfTeX have slightly differing requirements, so we
# need to distinguish the path we're taking.

However, diff'ing the results shows that the .tex-pdf and .tex-ps output
files are actually identical.  Would it be reasonable to simplify the
Makefile by eliminating the separate build rules?  I guess we'd have to
make an arbitrary choice between texdvi-output and texpdf-output flags.

regards, tom lane

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Why the separate jade calls for pdf and ps output?

2010-04-29 Thread Peter Eisentraut
On tor, 2010-04-29 at 10:53 -0400, Tom Lane wrote:
> doc/src/sgml/Makefile asserts
> 
> # Regular TeX and pdfTeX have slightly differing requirements, so we
> # need to distinguish the path we're taking.
> 
> However, diff'ing the results shows that the .tex-pdf and .tex-ps output
> files are actually identical.  Would it be reasonable to simplify the
> Makefile by eliminating the separate build rules?  I guess we'd have to
> make an arbitrary choice between texdvi-output and texpdf-output flags.

It has to do with graphics support, because tex and pdftex support
different graphics formats.  Since we don't currently have any graphics,
it's dead code.  I think you can actually do away with it anyway because
TeX should support graphics file references without extensions, ISTR.
So the actual reason for this might have been RTF support.

If it's in the way, remove it.  We can always add it back when someone
wants to add a graphic.  (And in that case we'll probably have to do
some additional coding somewhere anyway.)


-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] Why the separate jade calls for pdf and ps output?

2010-04-29 Thread Tom Lane
Peter Eisentraut  writes:
> On tor, 2010-04-29 at 10:53 -0400, Tom Lane wrote:
>> However, diff'ing the results shows that the .tex-pdf and .tex-ps output
>> files are actually identical.  Would it be reasonable to simplify the
>> Makefile by eliminating the separate build rules?  I guess we'd have to
>> make an arbitrary choice between texdvi-output and texpdf-output flags.

> It has to do with graphics support, because tex and pdftex support
> different graphics formats.  Since we don't currently have any graphics,
> it's dead code.  I think you can actually do away with it anyway because
> TeX should support graphics file references without extensions, ISTR.
> So the actual reason for this might have been RTF support.

> If it's in the way, remove it.

It's not in the way, particularly; I was just curious whether we could
do without it.  The only obvious benefit would be to save some work
when building PS and PDF output at the same time, but I doubt very many
people do that.

Since there was just recently some discussion about adding graphics to
the docs, I don't feel a need to put possible roadblocks in the way of
that.  Maybe the best thing would be to wait for some work of that sort
to land, and then experiment to see if we can simplify without breaking
anything.

regards, tom lane

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


[DOCS] Re: [COMMITTERS] pgsql: Move alpha release notes into a separate file; re-align sgml

2010-04-29 Thread Devrim GÜNDÜZ
On Thu, 2010-04-29 at 20:54 +, Bruce Momjian wrote:
> Move alpha release notes into a separate file;  re-align sgml tags.
> 
> Modified Files:
> --
> pgsql/doc/src/sgml:
> release-9.0.sgml (r2.16 -> r2.17)
> 
> (http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/release-9.0.sgml?r1=2.16&r2=2.17)
> 



! 
!   The above items are explained in more detail in the sections below.
! 


IMHO we need to remove listitem tags here, since this sentence is not an item 
actually.
-- 
Devrim GÜNDÜZ
PostgreSQL Danışmanı/Consultant, Red Hat Certified Engineer
PostgreSQL RPM Repository: http://yum.pgrpms.org
Community: devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org  Twitter: http://twitter.com/devrimgunduz


signature.asc
Description: This is a digitally signed message part


[DOCS] Re: [COMMITTERS] pgsql: Move alpha release notes into a separate file; re-align sgml

2010-04-29 Thread Bruce Momjian
Devrim G?ND?Z wrote:
-- Start of PGP signed section.
> On Thu, 2010-04-29 at 20:54 +, Bruce Momjian wrote:
> > Move alpha release notes into a separate file;  re-align sgml tags.
> > 
> > Modified Files:
> > --
> > pgsql/doc/src/sgml:
> > release-9.0.sgml (r2.16 -> r2.17)
> > 
> > (http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/release-9.0.sgml?r1=2.16&r2=2.17)
> > 
> 
> 
> 
> ! 
> !   The above items are explained in more detail in the sections 
> below.
> ! 
> 
> 
> IMHO we need to remove listitem tags here, since this sentence is not an item 
> actually.

Yea, I caught that and fixed it.

-- 
  Bruce Momjian  http://momjian.us
  EnterpriseDB http://enterprisedb.com

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs