what to do with backend flowchart

Started by Robert Treatalmost 21 years ago8 messages
#1Robert Treat
xzilla@users.sourceforge.net

I'm currently working on consolidating some of the content on the developer
site with the current web code cvs and am wondering what to do with
http://developer.postgresql.org/docs/pgsql/src/tools/backend/index.html.
This link actually comes right out of the postgresql sources, but it is
actually quite a bit out of date at this point. I guess it might be worth
asking if it is so out of date that it isnt even worth displaying anymore...
it looks usefull to me but I'm not certain how far out of whack it is, just
know that it doesn't match reality at this point. We could have someone
update it and then generate it out of cvs onto the website, but it really
seems like the kind of thing that should live in the web code rather than
core cvs anyway. I'm willing to import it all into the web cvs, and send a
patch removing it from the core cvs if no one objects, lmk.

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Robert Treat (#1)
Re: what to do with backend flowchart

Robert Treat <xzilla@users.sourceforge.net> writes:

I'm currently working on consolidating some of the content on the developer
site with the current web code cvs and am wondering what to do with
http://developer.postgresql.org/docs/pgsql/src/tools/backend/index.html.
This link actually comes right out of the postgresql sources, but it is
actually quite a bit out of date at this point.

At the level of detail that that's giving, it's not all that out of
date; though I agree that it could probably do with a lookthrough.

know that it doesn't match reality at this point. We could have someone
update it and then generate it out of cvs onto the website, but it really
seems like the kind of thing that should live in the web code rather than
core cvs anyway. I'm willing to import it all into the web cvs, and send a
patch removing it from the core cvs if no one objects, lmk.

If your objection is that it's not being maintained, then that is no
solution. Once it's out of the source code CVS it is *guaranteed* to
not get updated to track source-code changes.

regards, tom lane

#3Qingqing Zhou
zhouqq@cs.toronto.edu
In reply to: Robert Treat (#1)
Re: what to do with backend flowchart

"Tom Lane" <tgl@sss.pgh.pa.us> writes

If your objection is that it's not being maintained, then that is no
solution. Once it's out of the source code CVS it is *guaranteed* to
not get updated to track source-code changes.

Is it possible that we insert some tags (like doc++ does) into source code
comments and write a small parser to retrieve them automatically and
generate most part of the backend flowchat?

Regards,
Qingqing

#4Robert Treat
xzilla@users.sourceforge.net
In reply to: Tom Lane (#2)
Re: [HACKERS] what to do with backend flowchart

On Sunday 20 March 2005 13:24, Tom Lane wrote:

Robert Treat <xzilla@users.sourceforge.net> writes:

know that it doesn't match reality at this point. We could have someone
update it and then generate it out of cvs onto the website, but it really
seems like the kind of thing that should live in the web code rather than
core cvs anyway. I'm willing to import it all into the web cvs, and send
a patch removing it from the core cvs if no one objects, lmk.

If your objection is that it's not being maintained, then that is no
solution. Once it's out of the source code CVS it is *guaranteed* to
not get updated to track source-code changes.

My thoughts were that it is certainly easier for us to implement web code that
comes from the web cvs rather than the core cvs, and also that it seems wierd
to have this type of html/graphics living tucked away inside the application
code. You seem to be opposed to moving it though (or at least unconvinced)
so I guess we will work things out on the web side.

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

#5Dave Page
dpage@vale-housing.co.uk
In reply to: Robert Treat (#4)
Re: [HACKERS] what to do with backend flowchart

-----Original Message-----
From: pgsql-hackers-owner@postgresql.org
[mailto:pgsql-hackers-owner@postgresql.org] On Behalf Of Robert Treat
Sent: 21 March 2005 19:05
To: Tom Lane
Cc: pgsql-hackers@postgresql.org; pgsql-www@postgresql.org
Subject: Re: [HACKERS] what to do with backend flowchart

My thoughts were that it is certainly easier for us to
implement web code that
comes from the web cvs rather than the core cvs, and also
that it seems wierd
to have this type of html/graphics living tucked away inside
the application
code. You seem to be opposed to moving it though (or at
least unconvinced)
so I guess we will work things out on the web side.

It wouldn't be the first thing we suck from the core CVS for the web. If
it's just a case of keeping the correct set of files up to date on the
webside, let me know what they are and I'll set it up for you Robert.

/D

#6Robert Treat
xzilla@users.sourceforge.net
In reply to: Dave Page (#5)
Re: [HACKERS] what to do with backend flowchart

On Tuesday 22 March 2005 04:11, Dave Page wrote:

-----Original Message-----
From: pgsql-hackers-owner@postgresql.org
[mailto:pgsql-hackers-owner@postgresql.org] On Behalf Of Robert Treat
Sent: 21 March 2005 19:05
To: Tom Lane
Cc: pgsql-hackers@postgresql.org; pgsql-www@postgresql.org
Subject: Re: [HACKERS] what to do with backend flowchart

My thoughts were that it is certainly easier for us to
implement web code that
comes from the web cvs rather than the core cvs, and also
that it seems wierd
to have this type of html/graphics living tucked away inside
the application

code. You seem to be opposed to moving it though (or at
least unconvinced)
so I guess we will work things out on the web side.

,
It wouldn't be the first thing we suck from the core CVS for the web. If
it's just a case of keeping the correct set of files up to date on the
webside, let me know what they are and I'll set it up for you Robert.

Sure... I took a little look and the place where it points to on the developer
machine is actually a symbolic link into Bruce's home directory where he
presumably keeps an updating copy of the cvs code. What we need to
reproduce this is backend_dirs.html, flow.gif, and index.html from
src/tools/backend/ I guess it could live under files/developer/ within the
web hierarchy.

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

#7Bruce Momjian
pgman@candle.pha.pa.us
In reply to: Robert Treat (#6)
Re: [HACKERS] what to do with backend flowchart

Robert Treat wrote:

It wouldn't be the first thing we suck from the core CVS for the web. If
it's just a case of keeping the correct set of files up to date on the
webside, let me know what they are and I'll set it up for you Robert.

Sure... I took a little look and the place where it points to on the developer
machine is actually a symbolic link into Bruce's home directory where he
presumably keeps an updating copy of the cvs code. What we need to
reproduce this is backend_dirs.html, flow.gif, and index.html from
src/tools/backend/ I guess it could live under files/developer/ within the
web hierarchy.

Feel free to do whatever you want with the backend flowcart.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
#8Bruce Momjian
pgman@candle.pha.pa.us
In reply to: Robert Treat (#4)
Re: [HACKERS] what to do with backend flowchart

I have update the backend flowchart to more closely match current CVS.
The web site pulls from our CVS automatically so it should be updated
soon on the web site.

---------------------------------------------------------------------------

Robert Treat wrote:

On Sunday 20 March 2005 13:24, Tom Lane wrote:

Robert Treat <xzilla@users.sourceforge.net> writes:

know that it doesn't match reality at this point. We could have someone
update it and then generate it out of cvs onto the website, but it really
seems like the kind of thing that should live in the web code rather than
core cvs anyway. I'm willing to import it all into the web cvs, and send
a patch removing it from the core cvs if no one objects, lmk.

If your objection is that it's not being maintained, then that is no
solution. Once it's out of the source code CVS it is *guaranteed* to
not get updated to track source-code changes.

My thoughts were that it is certainly easier for us to implement web code that
comes from the web cvs rather than the core cvs, and also that it seems wierd
to have this type of html/graphics living tucked away inside the application
code. You seem to be opposed to moving it though (or at least unconvinced)
so I guess we will work things out on the web side.

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

---------------------------(end of broadcast)---------------------------
TIP 5: Have you checked our extensive FAQ?

http://www.postgresql.org/docs/faq

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073