Received: from magus.postgresql.org ([87.238.57.229]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1TSAc4-00069X-Ph for pgsql-docs@postgresql.org; Sat, 27 Oct 2012 17:56:00 +0000 Received: from smtp-vbr10.xs4all.nl ([194.109.24.30]) by magus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1TSAbz-0005iQ-8C for pgsql-docs@postgresql.org; Sat, 27 Oct 2012 17:56:00 +0000 Received: from webmail.xs4all.nl (dovemail18.xs4all.nl [194.109.26.20]) by smtp-vbr10.xs4all.nl (8.13.8/8.13.8) with ESMTP id q9RHtGnR072194; Sat, 27 Oct 2012 19:55:22 +0200 (CEST) (envelope-from er@xs4all.nl) Received: from 83.163.19.29 (SquirrelMail authenticated user er) by webmail.xs4all.nl with HTTP; Sat, 27 Oct 2012 19:55:23 +0200 Message-ID: <80168799c2325740e298fca917a9b9e7.squirrel@webmail.xs4all.nl> In-Reply-To: <21287.1351356283@sss.pgh.pa.us> References: <21287.1351356283@sss.pgh.pa.us> Date: Sat, 27 Oct 2012 19:55:23 +0200 Subject: Re: LATERAL synopsis (patch to wrap long line) From: "Erik Rijkers" To: "Tom Lane" Cc: pgsql-docs@postgresql.org User-Agent: SquirrelMail/1.4.18 MIME-Version: 1.0 Content-Type: multipart/mixed;boundary="----=_20121027195522_58566" X-Virus-Scanned: by XS4ALL Virus Scanner X-Pg-Spam-Score: -2.6 (--) X-Archive-Number: 201210/11 X-Sequence-Number: 7491 ------=_20121027195522_58566 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 8bit On Sat, October 27, 2012 18:44, Tom Lane wrote: > "Erik Rijkers" 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 ------=_20121027195522_58566 Content-Type: application/octet-stream; name="select.sgml.diff" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="select.sgml.diff" LS0tIGRvYy9zcmMvc2dtbC9yZWYvc2VsZWN0LnNnbWwub3JpZwkyMDEyLTEwLTI3IDExOjQwOjUy LjY5NTc3ODg3NSArMDIwMAorKysgZG9jL3NyYy9zZ21sL3JlZi9zZWxlY3Quc2dtbAkyMDEyLTEw LTI3IDE5OjE3OjUwLjI0MjgwNTU5NSArMDIwMApAQCAtNTIsNyArNTIsOCBAQAogICAgIFsgT05M WSBdIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj50YWJsZV9uYW1lPC9yZXBsYWNlYWJs ZT4gWyAqIF0gWyBbIEFTIF0gPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmFsaWFzPC9y ZXBsYWNlYWJsZT4gWyAoIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5jb2x1bW5fYWxp YXM8L3JlcGxhY2VhYmxlPiBbLCAuLi5dICkgXSBdCiAgICAgWyBMQVRFUkFMIF0gKCA8cmVwbGFj ZWFibGUgY2xhc3M9InBhcmFtZXRlciI+c2VsZWN0PC9yZXBsYWNlYWJsZT4gKSBbIEFTIF0gPHJl cGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmFsaWFzPC9yZXBsYWNlYWJsZT4gWyAoIDxyZXBs YWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5jb2x1bW5fYWxpYXM8L3JlcGxhY2VhYmxlPiBbLCAu Li5dICkgXQogICAgIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj53aXRoX3F1ZXJ5X25h bWU8L3JlcGxhY2VhYmxlPiBbIFsgQVMgXSA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ YWxpYXM8L3JlcGxhY2VhYmxlPiBbICggPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmNv bHVtbl9hbGlhczwvcmVwbGFjZWFibGU+IFssIC4uLl0gKSBdIF0KLSAgICBbIExBVEVSQUwgXSA8 cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ZnVuY3Rpb25fbmFtZTwvcmVwbGFjZWFibGU+ ICggWyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+YXJndW1lbnQ8L3JlcGxhY2VhYmxl PiBbLCAuLi5dIF0gKSBbIEFTIF0gPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmFsaWFz PC9yZXBsYWNlYWJsZT4gWyAoIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5jb2x1bW5f YWxpYXM8L3JlcGxhY2VhYmxlPiBbLCAuLi5dIHwgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0 ZXIiPmNvbHVtbl9kZWZpbml0aW9uPC9yZXBsYWNlYWJsZT4gWywgLi4uXSApIF0KKyAgICBbIExB VEVSQUwgXSA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ZnVuY3Rpb25fbmFtZTwvcmVw bGFjZWFibGU+ICggWyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+YXJndW1lbnQ8L3Jl cGxhY2VhYmxlPiBbLCAuLi5dIF0gKQorICAgICAgICAgWyBBUyBdIDxyZXBsYWNlYWJsZSBjbGFz cz0icGFyYW1ldGVyIj5hbGlhczwvcmVwbGFjZWFibGU+IFsgKCA8cmVwbGFjZWFibGUgY2xhc3M9 InBhcmFtZXRlciI+Y29sdW1uX2FsaWFzPC9yZXBsYWNlYWJsZT4gWywgLi4uXSB8IDxyZXBsYWNl YWJsZSBjbGFzcz0icGFyYW1ldGVyIj5jb2x1bW5fZGVmaW5pdGlvbjwvcmVwbGFjZWFibGU+IFss IC4uLl0gKSBdCiAgICAgWyBMQVRFUkFMIF0gPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIi PmZ1bmN0aW9uX25hbWU8L3JlcGxhY2VhYmxlPiAoIFsgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJh bWV0ZXIiPmFyZ3VtZW50PC9yZXBsYWNlYWJsZT4gWywgLi4uXSBdICkgQVMgKCA8cmVwbGFjZWFi bGUgY2xhc3M9InBhcmFtZXRlciI+Y29sdW1uX2RlZmluaXRpb248L3JlcGxhY2VhYmxlPiBbLCAu Li5dICkKICAgICA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ZnJvbV9pdGVtPC9yZXBs YWNlYWJsZT4gWyBOQVRVUkFMIF0gPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmpvaW5f dHlwZTwvcmVwbGFjZWFibGU+IDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5mcm9tX2l0 ZW08L3JlcGxhY2VhYmxlPiBbIE9OIDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5qb2lu X2NvbmRpdGlvbjwvcmVwbGFjZWFibGU+IHwgVVNJTkcgKCA8cmVwbGFjZWFibGUgY2xhc3M9InBh cmFtZXRlciI+am9pbl9jb2x1bW48L3JlcGxhY2VhYmxlPiBbLCAuLi5dICkgXQogCg== ------=_20121027195522_58566--