Still no support for XML-GUIs on PostgreSQL Docs?

Started by Josh Berkusover 21 years ago4 messagesdocs
Jump to latest
#1Josh Berkus
josh@agliodbs.com

Folks,

I'd the impression, from a discussion last year, that we had upgraded to
DocBook2 and I would be able to use an XML editor to work on docs and
validate them. But that didn't happen, I take it?

--
--Josh

Josh Berkus
Aglio Database Solutions
San Francisco

#2Josh Berkus
josh@agliodbs.com
In reply to: Josh Berkus (#1)
Re: Still no support for XML-GUIs on PostgreSQL Docs?

People,

BTW, that was not a criticism, I just want to know because I'm having a
frustrating time and want to know if it's me or the docs.

--
--Josh

Josh Berkus
Aglio Database Solutions
San Francisco

#3Peter Eisentraut
peter_e@gmx.net
In reply to: Josh Berkus (#1)
Re: Still no support for XML-GUIs on PostgreSQL Docs?

Josh Berkus wrote:

I'd the impression, from a discussion last year, that we had upgraded
to DocBook2 and I would be able to use an XML editor to work on docs
and validate them. But that didn't happen, I take it?

There is no such thing as "DocBook2", and I don't recall any workable
proposals to change the source to XML.

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

#4Michael Glaesemann
grzm@seespotcode.net
In reply to: Peter Eisentraut (#3)
Re: Still no support for XML-GUIs on PostgreSQL Docs?

On Aug 30, 2004, at 12:20 AM, Peter Eisentraut wrote:

Josh Berkus wrote:

I'd the impression, from a discussion last year, that we had upgraded
to DocBook2 and I would be able to use an XML editor to work on docs
and validate them. But that didn't happen, I take it?

There is no such thing as "DocBook2", and I don't recall any workable
proposals to change the source to XML.

As I recall, there were two primary issues in moving from SGML DocBook
to XML DocBook.

Marked sections: SGML DocBook (which is currently used) supports
parameter entities to be used to include or exclude certain sections of
material depending on the desired output. Profiling in XML DocBook may
be able to accomplish the same task.

XML DocBook toolchain: making sure the tools to produce the
documentation in its myriad forms (e.g., html, manpages, PDF) works.

I hadn't heard of anyone attempting to convert the docs to XML DocBook
to see if it can be done, which is probably what needs to be done to
see if works.

Michael Glaesemann
grzm myrealbox com