Re: [DOCS] Grammar and formatting errors for 9.02 pdf version

2010-12-22 Thread Alvaro Herrera
Excerpts from Robert Haas's message of mar dic 21 23:33:19 -0300 2010: > With respect to formatting errors, we tend to worry more about the > HTML versions of the docs than the PDF. That said, we have certainly made some changes to the text to better acommodate the PDF output, particularly where

Re: [DOCS] Grammar and formatting errors for 9.02 pdf version

2010-12-22 Thread Leslie S Satenstein
--- On Tue, 12/21/10, Robert Haas wrote: From: Robert Haas Subject: Re: [DOCS] Grammar and formatting errors for 9.02 pdf version To: "Leslie S Satenstein" Cc: "pgsql-docs" Date: Tuesday, December 21, 2010, 10:56 PM On Tue, Dec 21, 2010 at 10:43 PM, Leslie S Satenstein wrote: > > Hi Robert,

[DOCS] OID

2010-12-22 Thread Leslie S Satenstein
I am reading the PDF document and ran into the term OID in the section 4.2.11. Array Constructors However, OID is first defined in Chapter 5.    (5.4 System Columns).  Is it reasonable to perhaps move the contents of or repeat part of the contents of section 5.4 in sectioln 4.2.11? Is this unr

[DOCS] Addition to TOAST documentation in 8.4 comprehensive manual

2010-12-22 Thread Aleksey Tsalolikhin
Hello, I'd like to suggest a small addition to the TOAST overview in the 8.4 comprehensive manual, Chapter 53.2 TOAST. This is my first doc patch for postgres, so if this is not appropriate, please advise. I spent almost an hour trying to figure out how to go from the TOAST table id to the o

Re: [DOCS] Addition to TOAST documentation in 8.4 comprehensive manual

2010-12-22 Thread Aleksey Tsalolikhin
I'd like to add the following to my proposed documentation tidbit, please: The more offical/strict way, that does not rely on the implementation artifact that TOAST numeric ID is embedded in the TOAST symbolic name, is: select oid::regclass from pg_class where reltoastrelid='pg_toast_12513885'

Re: [DOCS] OID

2010-12-22 Thread Tom Lane
Leslie S Satenstein writes: > Is this unreferenced term that appears earlier than the definition considered > a document bug?. No. It would be completely impractical, or at least unintelligible, to write the manual with no forward references whatsoever. regards, tom lan