Re: Documentation on page files

From: Martijn van Oosterhout <kleptog(at)svana(dot)org>
To: Curt Sampson <cjs(at)cynic(dot)net>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Documentation on page files
Date: 2002-04-21 09:28:32
Message-ID: 20020421192832.A590@svana.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Sun, Apr 21, 2002 at 03:46:07PM +0900, Curt Sampson wrote:
> On Sat, 20 Apr 2002, Tom Lane wrote:
>
> > Martijn van Oosterhout <kleptog(at)svana(dot)org> writes:
> > > 2. If not, would patches be accepted to correct the situation?
> >
> > Go for it.
>
> Yes, please! I'd be happy to review and updated version.

Ok, my first attempt can be seen here:

http://svana.org/kleptog/pgsql/page.sgml.txt

I don't know whatever SGML format this is using, so the layout is not great,
but the information should be accurate. I used it to create a program to
dump the datafiles directly without the postmaster :).

I'll submit a proper patch once we have something useful.

> One thing that would be good, since this is a developers' guide,
> would be to include references to the source files and dates from
> which the information comes. That way one could see if updates are
> necessary by doing a diff on those files between the given date
> and the head, to see what changes have been made since the description
> was written. Also good would be to have the data structures explicitly
> named so that when one dives into the source, one already has a
> good idea of what one's looking at.

Well, I have included the names of the structures involved. Do you think
it's worth adding filenames given that TAGS makes tracking them down easily
enough? I can put in dates if you like.

Issues to be dealt with:
- Do I need to say more about TOAST?
- Indexes?
- Split into sections
- How much detail is enough/too much?

Have a nice day,
--
Martijn van Oosterhout <kleptog(at)svana(dot)org> http://svana.org/kleptog/
> Canada, Mexico, and Australia form the Axis of Nations That
> Are Actually Quite Nice But Secretly Have Nasty Thoughts About America

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Rod Taylor 2002-04-21 13:28:08 Re: On-disk Tuple Size
Previous Message Jean-Michel POURE 2002-04-21 08:15:53 Re: Implement a .NET Data Provider