pgsql/ oc/src/sgml/catalogs.sgml oc/src/sgml/x ...

CVSROOT: /cvsroot
Module name: pgsql
Changes by: tgl(at)postgresql(dot)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.

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

"Christopher Kings-Lynne" <chriskl(at)familyhealth(dot)com(dot)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

> > 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

On Tue, 30 Jul 2002, Tom Lane wrote:

> "Christopher Kings-Lynne" <chriskl(at)familyhealth(dot)com(dot)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(at)postgresql(dot)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(at)sai(dot)msu(dot)su, http://www.sai.msu.su/~megera/
phone: +007(095)939-16-83, +007(095)939-23-83

> 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

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(at)familyhealth(dot)com(dot)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(at)postgresql(dot)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(at)sai(dot)msu(dot)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(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026

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(at)familyhealth(dot)com(dot)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(at)postgresql(dot)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(at)sai(dot)msu(dot)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(at)sai(dot)msu(dot)su, http://www.sai.msu.su/~megera/
phone: +007(095)939-16-83, +007(095)939-23-83

> 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