Re: Guide to PostgreSQL source tree

From: "Serguei Mokhov" <sa_mokho(at)alcor(dot)concordia(dot)ca>
To: "Gavin Sherry" <swm(at)linuxworld(dot)com(dot)au>, <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Guide to PostgreSQL source tree
Date: 2001-08-19 14:47:03
Message-ID: 001101c128bd$d1aeac20$5dd9fea9@gunn
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers


----- Original Message -----
From: Gavin Sherry <swm(at)linuxworld(dot)com(dot)au>
Sent: Sunday, August 19, 2001 3:40 AM

> Hi all,
>
> For a few months now I've been thinking about whether or not a guide
> ('line-by-line') to the Postgres source tree would be of any value.

[snip]

> So, what do people think?

Such a guide would be nice to have handy as a reference, but how
are you going to keep up with frequent code changes
and the new code added? Keeping this thing up-to-date
is an enormous effort even if you're not the only
one involved.

And what's wrong in automated guide generation? Like
if put specially formatted comments (responsibility of the author of the piece)
for the guide in the source, and run through the source tree
your guide generator from time to time (like on every beta, RC, and release perhaps?).
This way the guide maintenance will be much easier, but the quality will solely
depend on comments supplied by the author.

My two Canadian cents.

Serguei

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2001-08-19 15:13:41 Re: encoding names
Previous Message Tatsuo Ishii 2001-08-19 13:46:34 Re: [PATCHES] encoding names