Re: [DOCS] Switching to XML

2006-12-12 Thread Peter Eisentraut
Joshua D. Drake wrote:
> Of course your changes that you make from release to release for
> volumes won't be permanent

Well, of course he'd make his changes in the sources, not in the 
intermediate XML file.  Or he is talking about a kind of changes which 
I cannot fathom at the moment.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(end of broadcast)---
TIP 3: Have you checked our extensive FAQ?

   http://www.postgresql.org/docs/faq


Re: [DOCS] Switching to XML

2006-12-12 Thread Peter Eisentraut
David Blewett wrote:
> Excuse my ignorance, but I thought XSLT stylesheets can only be used
> on XML files?

FWIW, you can use XSLT stylesheets on SGML as well, but we don't do 
that.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(end of broadcast)---
TIP 9: In versions below 8.0, the planner will ignore your desire to
   choose an index scan if your joining column's datatypes do not
   match


Re: [DOCS] Switching to XML

2006-12-12 Thread Peter Eisentraut
Guillaume Lelarge wrote:
> A summary :
>  * to build HTML manual with XSLT :
>make postgres.xml
>make xslthtml

Just the last command should be enough.

>  * to build PDF manual with XSLT :
>make postgres.xml
>make postgres-A4.fo

Same here.

>fop.sh postgres-A4.fo postgres-A4.pdf
>
> I think my fop install is broken because I'm not able to build the
> PDF file...

I have been using FOP on and off for many years and I've never seen it 
produce any real document longer than two pages, so I'm not surprised.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(end of broadcast)---
TIP 5: don't forget to increase your free space map settings


Re: [DOCS] Switching to XML

2006-12-12 Thread Guillaume Lelarge

Peter Eisentraut a ecrit le 12/12/2006 09:10:

Guillaume Lelarge wrote:

   fop.sh postgres-A4.fo postgres-A4.pdf

I think my fop install is broken because I'm not able to build the
PDF file...


I have been using FOP on and off for many years and I've never seen it 
produce any real document longer than two pages, so I'm not surprised.




It produces PDF file for the PostgreSQL french manual. I really have no 
problem to build the 1098 pages PDF file for 8.1.5 release.



--
Guillaume.

---(end of broadcast)---
TIP 7: You can help support the PostgreSQL project by donating at

   http://www.postgresql.org/about/donate


Re: [DOCS] Authoring Tools WAS: Switching to XML

2006-12-12 Thread Peter Eisentraut
Josh Berkus wrote:
> Anyway, from the sound of it whether or not there are better
> authoring tools for XML than SGML is "undetermined pending further
> investigation."

I'll be the first to welcome better editing options, but so far I have 
only heard them being theorized about.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(end of broadcast)---
TIP 3: Have you checked our extensive FAQ?

   http://www.postgresql.org/docs/faq


Re: [DOCS] Switching to XML

2006-12-12 Thread Joshua D. Drake
On Tue, 2006-12-12 at 08:59 +0100, Peter Eisentraut wrote:
> Joshua D. Drake wrote:
> > 5. The format objects development (FOP) seems to be better maintained
> > then the dblatex/db2latex/pdflatex stuff.
> 
> Check the facts.  The latest stable FOP release was more than three 
> years ago. 

Actually it was about 8 months ago. 0.92 Beta. 

>  The latest stable dblatex release was less than a month 
> ago.

I have found dblatex to not work very well (as in at all) but that could
very well be my installation.

Joshua D. Drake


> 
-- 

  === The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive  PostgreSQL solutions since 1997
 http://www.commandprompt.com/

Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate




---(end of broadcast)---
TIP 4: Have you searched our list archives?

   http://archives.postgresql.org


Re: [DOCS] Switching to XML

2006-12-12 Thread Joshua D. Drake
On Tue, 2006-12-12 at 09:10 +0100, Peter Eisentraut wrote:
> Guillaume Lelarge wrote:
> > A summary :
> >  * to build HTML manual with XSLT :
> >make postgres.xml
> >make xslthtml
> 
> Just the last command should be enough.
> 
> >  * to build PDF manual with XSLT :
> >make postgres.xml
> >make postgres-A4.fo
> 
> Same here.
> 
> >fop.sh postgres-A4.fo postgres-A4.pdf
> >
> > I think my fop install is broken because I'm not able to build the
> > PDF file...
> 
> I have been using FOP on and off for many years and I've never seen it 
> produce any real document longer than two pages, so I'm not surprised.

I was able to easily (once I got the environment sorted out) generate
the entire french documentation with FOP.

Joshua D. Drake

> 
-- 

  === The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive  PostgreSQL solutions since 1997
 http://www.commandprompt.com/

Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate




---(end of broadcast)---
TIP 1: if posting/reading through Usenet, please send an appropriate
   subscribe-nomail command to [EMAIL PROTECTED] so that your
   message can get through to the mailing list cleanly


Re: [DOCS] Switching to XML

2006-12-12 Thread Peter Eisentraut
Joshua D. Drake wrote:
> > Check the facts.  The latest stable FOP release was more than three
> > years ago.
>
> Actually it was about 8 months ago. 0.92 Beta.

That is not a stable release.  And the fact that the latest beta is 8 
months old doesn't impress me either.
-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(end of broadcast)---
TIP 2: Don't 'kill -9' the postmaster


Re: [DOCS] Switching to XML

2006-12-12 Thread Joshua D. Drake
On Tue, 2006-12-12 at 20:27 +0100, Peter Eisentraut wrote:
> Joshua D. Drake wrote:
> > > Check the facts.  The latest stable FOP release was more than three
> > > years ago.
> >
> > Actually it was about 8 months ago. 0.92 Beta.
> 
> That is not a stable release.  And the fact that the latest beta is 8 
> months old doesn't impress me either.

I am not going to argue with you further. I have better things to do.

Sincerely,

Joshua D. Drake


-- 

  === The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive  PostgreSQL solutions since 1997
 http://www.commandprompt.com/

Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate




---(end of broadcast)---
TIP 7: You can help support the PostgreSQL project by donating at

http://www.postgresql.org/about/donate


Re: [DOCS] Switching to XML

2006-12-12 Thread Bruce Momjian
Tom Lane wrote:
> Josh Berkus  writes:
> > As I said then, this is absolutely untrue.  OpenOffice.org, for example, 
> > works with DocBook XML but not SGML.  There are also a plethora of XML 
> > editing and publishing tools which can been used for Docbook XML which 
> > are not available for SGML.  A simple look at this page: 
> > http://wiki.docbook.org/topic/DocBookAuthoringTools
> >  shows that there are more than twice as many authoring tools which 
> > support only XML as support SGML -- and that most of the tools which 
> > support SGML are out-of-maintenance.
> 
> This is confusing authoring tools (ie, stuff for more or less WYSIWYG
> editing of the document source) with output generation tools.
> 
> As for authoring tools, show me one that produces SGML or XML that's
> reasonably readable, and I might worry about allowing people to use it.
> Most of the ones I've seen would render the doc sources unreadable for
> anyone not using an authoring tool (possibly even the very same
> authoring tool).  We are not going to move in that direction
> because it would piss off the people who do the bulk of the work now.

And diffs would be either very large or useless.

-- 
  Bruce Momjian   [EMAIL PROTECTED]
  EnterpriseDBhttp://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

---(end of broadcast)---
TIP 5: don't forget to increase your free space map settings