CVSROOT:	/cvsroot
Module name:	pgsql
Changes by:	tgl@postgresql.org	02/07/30 01:24:56

Modified files:
	doc/src/sgml   : catalogs.sgml xindex.sgml 
	src/tutorial   : complex.source 

Log message:
	Rewrite xindex.sgml for CREATE OPERATOR CLASS.  catalogs.sgml finally
	contains descriptions of every single system table.  Update 'complex'
	tutorial example too.


Tue, 30 Jul 2002 01:24:56 -0400 (EDT)
tgl@postgresql.org (Tom Lane)
pgsql/ oc/src/sgml/catalogs.sgml oc/src/sgml/x ...
What's with this manual page?

http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html

Seems like it's almost accidental - like a copied and pasted email.  It
doesn't look like it should be there?

Chris


Tue, 30 Jul 2002 14:06:27 +0800
"Christopher Kings-Lynne" <chriskl@familyhealth.com.au>
Weird manual page
"Christopher Kings-Lynne" <chriskl@familyhealth.com.au> writes:
> What's with this manual page?
> http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html

GiST is, um, *very* poorly documented.  Feel free to submit doc patches.
(I've just committed a few tidbits in xindex.sgml, but much more work
is needed.)

			regards, tom lane

Tue, 30 Jul 2002 02:20:46 -0400
Tom Lane <tgl@sss.pgh.pa.us>
Re: Weird manual page 
> > What's with this manual page?
> > http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html
> 
> GiST is, um, *very* poorly documented.  Feel free to submit doc patches.
> (I've just committed a few tidbits in xindex.sgml, but much more work
> is needed.)

Weeeeeell...first I'd have to learn GiST...

Chris


Tue, 30 Jul 2002 14:28:49 +0800
"Christopher Kings-Lynne" <chriskl@familyhealth.com.au>
Re: Weird manual page 
On Tue, 30 Jul 2002, Tom Lane wrote:

> "Christopher Kings-Lynne" <chriskl@familyhealth.com.au> writes:
> > What's with this manual page?
> > http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html
>
> GiST is, um, *very* poorly documented.  Feel free to submit doc patches.
> (I've just committed a few tidbits in xindex.sgml, but much more work
> is needed.)
>

We have some docs

http://www.sai.msu.su/~megera/postgres/gist/

there is introduction
http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml

and description of current GiST interface
http://www.sai.msu.su/~megera/postgres/gist/doc/gist-inteface-r.shtml
it's written in Russian.
I could try to translate if needed.

> 			regards, tom lane
>
> ---------------------------(end of broadcast)---------------------------
> TIP 3: if posting/reading through Usenet, please send an appropriate
> subscribe-nomail command to majordomo@postgresql.org so that your
> message can get through to the mailing list cleanly
>

	Regards,
		Oleg
_____________________________________________________________
Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
Sternberg Astronomical Institute, Moscow University (Russia)
Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
phone: +007(095)939-16-83, +007(095)939-23-83


Tue, 30 Jul 2002 10:06:03 +0300 (GMT)
Oleg Bartunov <oleg@sai.msu.su>
Re: Weird manual page 
> We have some docs...
> it's written in Russian.
> I could try to translate if needed.

That would be great! Perhaps someone would help to go through and edit
it after you do a first cut, so you don't need to spend time working on
exact phrasing but rather on the content itself. I admire your command
of English (and Russian of course) but in my limited experience with
languages it seems that much time can be spent trying to get it "just
right"...

                     - Thomas

Tue, 30 Jul 2002 06:43:13 -0700
Thomas Lockhart <lockhart@fourpalms.org>
Re: Weird manual page

I wonder if we should just point to Oleg's URL from our docs.  That way,
as he adds stuff, people can go there to get it.

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

Oleg Bartunov wrote:
> On Tue, 30 Jul 2002, Tom Lane wrote:
> 
> > "Christopher Kings-Lynne" <chriskl@familyhealth.com.au> writes:
> > > What's with this manual page?
> > > http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html
> >
> > GiST is, um, *very* poorly documented.  Feel free to submit doc patches.
> > (I've just committed a few tidbits in xindex.sgml, but much more work
> > is needed.)
> >
> 
> We have some docs
> 
> http://www.sai.msu.su/~megera/postgres/gist/
> 
> there is introduction
> http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml
> 
> and description of current GiST interface
> http://www.sai.msu.su/~megera/postgres/gist/doc/gist-inteface-r.shtml
> it's written in Russian.
> I could try to translate if needed.
> 
> > 			regards, tom lane
> >
> > ---------------------------(end of broadcast)---------------------------
> > TIP 3: if posting/reading through Usenet, please send an appropriate
> > subscribe-nomail command to majordomo@postgresql.org so that your
> > message can get through to the mailing list cleanly
> >
> 
> 	Regards,
> 		Oleg
> _____________________________________________________________
> Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
> Sternberg Astronomical Institute, Moscow University (Russia)
> Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
> phone: +007(095)939-16-83, +007(095)939-23-83
> 
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 5: Have you checked our extensive FAQ?
> 
> http://www.postgresql.org/users-lounge/docs/faq.html
> 

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026

Tue, 30 Jul 2002 11:25:37 -0400 (EDT)
Bruce Momjian <pgman@candle.pha.pa.us>
Re: Weird manual page
On Tue, 30 Jul 2002, Bruce Momjian wrote:

>
> I wonder if we should just point to Oleg's URL from our docs.  That way,
> as he adds stuff, people can go there to get it.

I think better to have basic GiST documentation shipped and a point
to our page. We have complete GiST API documented in Russian and
a little intro in English, so most work is already done. We certainly
need to write info with real-life examples, but for the moment we
have no time. There is a bunch of GiST based contrib modules at least.
I'll try to translate GiST API this week and would be happy if somebody
integrate it with Postgres documentation.

>
> ---------------------------------------------------------------------------
>
> Oleg Bartunov wrote:
> > On Tue, 30 Jul 2002, Tom Lane wrote:
> >
> > > "Christopher Kings-Lynne" <chriskl@familyhealth.com.au> writes:
> > > > What's with this manual page?
> > > > http://candle.pha.pa.us/main/writings/pgsql/sgml/gist.html
> > >
> > > GiST is, um, *very* poorly documented.  Feel free to submit doc patches.
> > > (I've just committed a few tidbits in xindex.sgml, but much more work
> > > is needed.)
> > >
> >
> > We have some docs
> >
> > http://www.sai.msu.su/~megera/postgres/gist/
> >
> > there is introduction
> > http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml
> >
> > and description of current GiST interface
> > http://www.sai.msu.su/~megera/postgres/gist/doc/gist-inteface-r.shtml
> > it's written in Russian.
> > I could try to translate if needed.
> >
> > > 			regards, tom lane
> > >
> > > ---------------------------(end of broadcast)---------------------------
> > > TIP 3: if posting/reading through Usenet, please send an appropriate
> > > subscribe-nomail command to majordomo@postgresql.org so that your
> > > message can get through to the mailing list cleanly
> > >
> >
> > 	Regards,
> > 		Oleg
> > _____________________________________________________________
> > Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
> > Sternberg Astronomical Institute, Moscow University (Russia)
> > Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
> > phone: +007(095)939-16-83, +007(095)939-23-83
> >
> >
> > ---------------------------(end of broadcast)---------------------------
> > TIP 5: Have you checked our extensive FAQ?
> >
> > http://www.postgresql.org/users-lounge/docs/faq.html
> >
>
>

	Regards,
		Oleg
_____________________________________________________________
Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
Sternberg Astronomical Institute, Moscow University (Russia)
Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
phone: +007(095)939-16-83, +007(095)939-23-83


Tue, 30 Jul 2002 18:36:45 +0300 (GMT)
Oleg Bartunov <oleg@sai.msu.su>
Re: Weird manual page
> I wonder if we should just point to Oleg's URL from our docs.  That way,
> as he adds stuff, people can go there to get it.

Oleg has offered to help integrate this into the main documentation set,
and he certainly understands how to work with those for patching etc.
There is no downside to having this as a fundamental part of the docs
afaict.

                       - Thomas

Tue, 30 Jul 2002 08:40:02 -0700
Thomas Lockhart <lockhart@fourpalms.org>
Re: Weird manual page