public inbox for [email protected]
help / color / mirror / Atom feedXML documentation question
13+ messages / 4 participants
[nested] [flat]
* XML documentation question
@ 2009-04-24 03:17 Bruce Momjian <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Bruce Momjian @ 2009-04-24 03:17 UTC (permalink / raw)
To: pgsql-docs
What does this first sentence mean in our XML function documentation;
would someone please rewrite it to be intelligable?
In addition, the following functions are available to produce
analogous mappings of entire schemas or the entire current
database.
<synopsis>
schema_to_xml(schema name, nulls boolean, tableforest boolean, targetns text)
schema_to_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text)
schema_to_xml_and_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text)
database_to_xml(nulls boolean, tableforest boolean, targetns text)
database_to_xmlschema(nulls boolean, tableforest boolean, targetns text)
database_to_xml_and_xmlschema(nulls boolean, tableforest boolean, targetns text)
</synopsis>
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-24 11:15 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Peter Eisentraut @ 2009-04-24 11:15 UTC (permalink / raw)
To: pgsql-docs; +Cc: Bruce Momjian <[email protected]>
On Friday 24 April 2009 06:17:47 Bruce Momjian wrote:
> What does this first sentence mean in our XML function documentation;
> would someone please rewrite it to be intelligable?
>
> In addition, the following functions are available to produce
> analogous mappings of entire schemas or the entire current
> database.
It means that the functions described below produce mappings that are
analogous to the ones described earlier in that section which map tables
instead of schemas or databases.
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-24 12:48 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Bruce Momjian @ 2009-04-24 12:48 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs
Peter Eisentraut wrote:
> On Friday 24 April 2009 06:17:47 Bruce Momjian wrote:
> > What does this first sentence mean in our XML function documentation;
> > would someone please rewrite it to be intelligable?
> >
> > In addition, the following functions are available to produce
> > analogous mappings of entire schemas or the entire current
> > database.
>
> It means that the functions described below produce mappings that are
> analogous to the ones described earlier in that section which map tables
> instead of schemas or databases.
Apologies, I quoted the wrong section; I meant to ask about this
sentence:
The following functions return XML Schema documents describing the
mappings made by the data mappings produced by the corresponding
functions above.
<synopsis>
table_to_xmlschema(tbl regclass, nulls boolean, tableforest boolean,
targetns text)
query_to_xmlschema(query text, nulls boolean, tableforest boolean,
targetns text)
cursor_to_xmlschema(cursor refcursor, nulls boolean, tableforest
boolean, targetns text)
</synopsis>
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-26 11:34 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Peter Eisentraut @ 2009-04-26 11:34 UTC (permalink / raw)
To: pgsql-docs; +Cc: Bruce Momjian <[email protected]>
On Friday 24 April 2009 15:48:52 Bruce Momjian wrote:
> Apologies, I quoted the wrong section; I meant to ask about this
> sentence:
>
> The following functions return XML Schema documents describing the
> mappings made by the data mappings produced by the corresponding
> functions above.
I don't know what is unclear about this.
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-26 13:14 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Bruce Momjian @ 2009-04-26 13:14 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs
Peter Eisentraut wrote:
> On Friday 24 April 2009 15:48:52 Bruce Momjian wrote:
> > Apologies, I quoted the wrong section; I meant to ask about this
> > sentence:
> >
> > The following functions return XML Schema documents describing the
> > mappings made by the data mappings produced by the corresponding
> > functions above.
>
> I don't know what is unclear about this.
The "mappings made by" and "mappings produced by" seem redundant, and
hence confusing.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-26 15:27 Tom Lane <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 2 replies; 13+ messages in thread
From: Tom Lane @ 2009-04-26 15:27 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs
Bruce Momjian <[email protected]> writes:
> Peter Eisentraut wrote:
>> On Friday 24 April 2009 15:48:52 Bruce Momjian wrote:
>>> Apologies, I quoted the wrong section; I meant to ask about this
>>> sentence:
>>>
>>> The following functions return XML Schema documents describing the
>>> mappings made by the data mappings produced by the corresponding
>>> functions above.
>>
>> I don't know what is unclear about this.
> The "mappings made by" and "mappings produced by" seem redundant, and
> hence confusing.
Couldn't the sentence be trimmed to just
The following functions return XML Schema documents describing the
mappings produced by the corresponding functions above.
If that phrasing is wrong for some reason, then I agree with Bruce that
the sentence needs a complete rewrite.
regards, tom lane
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 17:20 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 2 replies; 13+ messages in thread
From: Bruce Momjian @ 2009-04-27 17:20 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs
Tom Lane wrote:
> Bruce Momjian <[email protected]> writes:
> > Peter Eisentraut wrote:
> >> On Friday 24 April 2009 15:48:52 Bruce Momjian wrote:
> >>> Apologies, I quoted the wrong section; I meant to ask about this
> >>> sentence:
> >>>
> >>> The following functions return XML Schema documents describing the
> >>> mappings made by the data mappings produced by the corresponding
> >>> functions above.
> >>
> >> I don't know what is unclear about this.
>
> > The "mappings made by" and "mappings produced by" seem redundant, and
> > hence confusing.
>
> Couldn't the sentence be trimmed to just
>
> The following functions return XML Schema documents describing the
> mappings produced by the corresponding functions above.
>
> If that phrasing is wrong for some reason, then I agree with Bruce that
> the sentence needs a complete rewrite.
I updated the text to:
The following functions return XML Schema documents similar to the
mappings produced by the corresponding functions above:
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 17:55 Tom Lane <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 1 reply; 13+ messages in thread
From: Tom Lane @ 2009-04-27 17:55 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs
Bruce Momjian <[email protected]> writes:
> Tom Lane wrote:
>> Couldn't the sentence be trimmed to just
>>
>> The following functions return XML Schema documents describing the
>> mappings produced by the corresponding functions above.
> I updated the text to:
> The following functions return XML Schema documents similar to the
> mappings produced by the corresponding functions above:
Hmm, I'm not sure that means the same thing at all.
regards, tom lane
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 18:23 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
0 siblings, 0 replies; 13+ messages in thread
From: Bruce Momjian @ 2009-04-27 18:23 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs
Tom Lane wrote:
> Bruce Momjian <[email protected]> writes:
> > Tom Lane wrote:
> >> Couldn't the sentence be trimmed to just
> >>
> >> The following functions return XML Schema documents describing the
> >> mappings produced by the corresponding functions above.
>
> > I updated the text to:
>
> > The following functions return XML Schema documents similar to the
> > mappings produced by the corresponding functions above:
>
> Hmm, I'm not sure that means the same thing at all.
Well, short of getting new text from Peter, that's the best I can do.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 18:46 Peter Eisentraut <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 0 replies; 13+ messages in thread
From: Peter Eisentraut @ 2009-04-27 18:46 UTC (permalink / raw)
To: pgsql-docs; +Cc: Tom Lane <[email protected]>; Bruce Momjian <[email protected]>
On Sunday 26 April 2009 18:27:27 Tom Lane wrote:
> Couldn't the sentence be trimmed to just
>
> The following functions return XML Schema documents describing the
> mappings produced by the corresponding functions above.
Sounds good.
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 18:48 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 1 reply; 13+ messages in thread
From: Peter Eisentraut @ 2009-04-27 18:48 UTC (permalink / raw)
To: pgsql-docs; +Cc: Bruce Momjian <[email protected]>; Tom Lane <[email protected]>
On Monday 27 April 2009 20:20:29 Bruce Momjian wrote:
> I updated the text to:
>
> The following functions return XML Schema documents similar to the
> mappings produced by the corresponding functions above:
Sorry, that is completely wrong.
Are you aware of what "XML Schema" is? Should that perhaps be explained in
the docs?
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 18:52 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 13+ messages in thread
From: Bruce Momjian @ 2009-04-27 18:52 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs; Tom Lane <[email protected]>
Peter Eisentraut wrote:
> On Monday 27 April 2009 20:20:29 Bruce Momjian wrote:
> > I updated the text to:
> >
> > The following functions return XML Schema documents similar to the
> > mappings produced by the corresponding functions above:
OK, that is what is in our SGML now.
> Sorry, that is completely wrong.
You did just email "sounds good", but were mistaken, right?
> Are you aware of what "XML Schema" is? Should that perhaps be explained in
> the docs?
Uh, it would be nice to explain it, yes. My guess it that the paragraph
is much too short and needs perhaps an addtional sentence, but I have no
clue what it should be.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 13+ messages in thread
* Re: XML documentation question
@ 2009-04-27 20:00 Alvaro Herrera <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 0 replies; 13+ messages in thread
From: Alvaro Herrera @ 2009-04-27 20:00 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs; Tom Lane <[email protected]>
Bruce Momjian wrote:
> Peter Eisentraut wrote:
> > On Monday 27 April 2009 20:20:29 Bruce Momjian wrote:
> > > I updated the text to:
> > >
> > > The following functions return XML Schema documents similar to the
> > > mappings produced by the corresponding functions above:
>
> OK, that is what is in our SGML now.
>
> > Sorry, that is completely wrong.
>
> You did just email "sounds good", but were mistaken, right?
But that was to Tom proposal, which is completely different (yes -- one
word can change the meaning of a sentence).
I agree the paragraph (even with Tom's rework) is a bit confusing to the
uninitiated. Maybe the subsection could be reflowed so that each
function is described along the corresponding XML Schema function (to
table_to_xml and table_to_xmlschema, later query_to_xml and
query_to_xmlschema and so on).
--
Alvaro Herrera http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 13+ messages in thread
end of thread, other threads:[~2009-04-27 20:00 UTC | newest]
Thread overview: 13+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2009-04-24 03:17 XML documentation question Bruce Momjian <[email protected]>
2009-04-24 11:15 ` Peter Eisentraut <[email protected]>
2009-04-24 12:48 ` Bruce Momjian <[email protected]>
2009-04-26 11:34 ` Peter Eisentraut <[email protected]>
2009-04-26 13:14 ` Bruce Momjian <[email protected]>
2009-04-26 15:27 ` Tom Lane <[email protected]>
2009-04-27 17:20 ` Bruce Momjian <[email protected]>
2009-04-27 17:55 ` Tom Lane <[email protected]>
2009-04-27 18:23 ` Bruce Momjian <[email protected]>
2009-04-27 18:48 ` Peter Eisentraut <[email protected]>
2009-04-27 18:52 ` Bruce Momjian <[email protected]>
2009-04-27 20:00 ` Alvaro Herrera <[email protected]>
2009-04-27 18:46 ` Peter Eisentraut <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox