public inbox for [email protected]
help / color / mirror / Atom feedFrom: Erik Rijkers <[email protected]>
To: Tom Lane <[email protected]>
Cc: [email protected]
Subject: Re: LATERAL synopsis (patch to wrap long line)
Date: Sat, 27 Oct 2012 19:55:23 +0200
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
<[email protected]>
On Sat, October 27, 2012 18:44, Tom Lane wrote:
> "Erik Rijkers" <[email protected]> writes:
>> [ LATERAL ] function_name ( [ argument [, ...] ] ) AS ( column_definition [, ...] )
>
>> But what does 'column_definition' stand for? (These are the only occurrences of
>> 'column_definition' in the manual.)
>
> This is the syntax for specifying what columns a
> function-returning-RECORD is actually going to return. I'm too lazy to
> chase down the reference and see whether it's really inconsistent or
> not --- but that line was like that before I added [ LATERAL ] to it ...
>
OK. I see it goes back to 7.3. It's probably not a problem.
I returned to the initial reason that I looked at the select.sgml, namely the truncation of some
of the synopsis-lines in the .pdf page for select.sgml.
Attached patch wraps the worst-longest line so that if becomes visible in pdf. It makes the .html
version slightly less pretty, but I hope the .pdf readability (integrity, even) counts for
something too.
(the remaining long lines in select.sgml page are cut off (for pdf) in the middle of some last
element and as such are still readable / clear enough.)
If changes like these (where the .html suffers slightly for .pdf integrity) are acceptable, I
would like to make some more doc-patches where the .pdf is rendered readable (almost always the
synopsis, but maybe there are still some code examples).
Thanks,
Erik Rijkers
Attachments:
[application/octet-stream] select.sgml.diff (2.0K, 2-select.sgml.diff)
download | inline diff:
--- doc/src/sgml/ref/select.sgml.orig 2012-10-27 11:40:52.695778875 +0200
+++ doc/src/sgml/ref/select.sgml 2012-10-27 19:17:50.242805595 +0200
@@ -52,7 +52,8 @@
[ ONLY ] <replaceable class="parameter">table_name</replaceable> [ * ] [ [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] ) ] ]
[ LATERAL ] ( <replaceable class="parameter">select</replaceable> ) [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] ) ]
<replaceable class="parameter">with_query_name</replaceable> [ [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] ) ] ]
- [ LATERAL ] <replaceable class="parameter">function_name</replaceable> ( [ <replaceable class="parameter">argument</replaceable> [, ...] ] ) [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] | <replaceable class="parameter">column_definition</replaceable> [, ...] ) ]
+ [ LATERAL ] <replaceable class="parameter">function_name</replaceable> ( [ <replaceable class="parameter">argument</replaceable> [, ...] ] )
+ [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] | <replaceable class="parameter">column_definition</replaceable> [, ...] ) ]
[ LATERAL ] <replaceable class="parameter">function_name</replaceable> ( [ <replaceable class="parameter">argument</replaceable> [, ...] ] ) AS ( <replaceable class="parameter">column_definition</replaceable> [, ...] )
<replaceable class="parameter">from_item</replaceable> [ NATURAL ] <replaceable class="parameter">join_type</replaceable> <replaceable class="parameter">from_item</replaceable> [ ON <replaceable class="parameter">join_condition</replaceable> | USING ( <replaceable class="parameter">join_column</replaceable> [, ...] ) ]
view thread (3+ messages)
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected]
Subject: Re: LATERAL synopsis (patch to wrap long line)
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox