public inbox for [email protected]
help / color / mirror / Atom feedBUG #2560: Web page documentation hard to use
5+ messages / 5 participants
[nested] [flat]
* BUG #2560: Web page documentation hard to use
@ 2006-08-01 16:54 PFudd <[email protected]>
2006-08-08 17:33 ` Re: [BUGS] BUG #2560: Web page documentation hard to use Jim Nasby <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: PFudd @ 2006-08-01 16:54 UTC (permalink / raw)
To: [email protected]
The following bug has been logged online:
Bug reference: 2560
Logged by: PFudd
Email address: [email protected]
PostgreSQL version: 8.1.4
Operating system: N/A
Description: Web page documentation hard to use
Details:
I'm trying to look up the SQL keyword 'in' using the postgresql.org web
search function.
Unfortunately, this word is also present in about every third sentence of
every page, making it impossible to search for.
In fact, a lot of the sql keywords are impossible to search for, because
they're lost in the noise.
Can this be fixed?
Thanks!
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: [BUGS] BUG #2560: Web page documentation hard to use
2006-08-01 16:54 BUG #2560: Web page documentation hard to use PFudd <[email protected]>
@ 2006-08-08 17:33 ` Jim Nasby <[email protected]>
2006-08-09 16:51 ` Re: [BUGS] BUG #2560: Web page documentation hard to use PF <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Jim Nasby @ 2006-08-08 17:33 UTC (permalink / raw)
To: PFudd <[email protected]>; +Cc: pgsql-www
Moving to -www.
I can't think of any good way to fix this; I think this is something
even Google has issues with. Your best bet is probably to ask pgsql-
general whatever questions you have. I don't have the docs handy
right now, but someone else might be able to direct you to wherever IN
() is documented (probably in the expressions section, or maybe in
SELECT).
On Aug 1, 2006, at 4:54 PM, PFudd wrote:
> The following bug has been logged online:
>
> Bug reference: 2560
> Logged by: PFudd
> Email address: [email protected]
> PostgreSQL version: 8.1.4
> Operating system: N/A
> Description: Web page documentation hard to use
> Details:
>
> I'm trying to look up the SQL keyword 'in' using the postgresql.org
> web
> search function.
>
> Unfortunately, this word is also present in about every third
> sentence of
> every page, making it impossible to search for.
>
> In fact, a lot of the sql keywords are impossible to search for,
> because
> they're lost in the noise.
>
> Can this be fixed?
>
> Thanks!
>
> ---------------------------(end of
> broadcast)---------------------------
> TIP 6: explain analyze is your friend
>
--
Jim C. Nasby, Sr. Engineering Consultant [email protected]
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: [BUGS] BUG #2560: Web page documentation hard to use
2006-08-01 16:54 BUG #2560: Web page documentation hard to use PFudd <[email protected]>
2006-08-08 17:33 ` Re: [BUGS] BUG #2560: Web page documentation hard to use Jim Nasby <[email protected]>
@ 2006-08-09 16:51 ` PF <[email protected]>
2006-08-09 22:59 ` Re: [BUGS] BUG #2560: Web page documentation hard to use Jim C. Nasby <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: PF @ 2006-08-09 16:51 UTC (permalink / raw)
To: Jim Nasby <[email protected]>; +Cc: pgsql-www
The php language web site (http://www.php.net/) seems to have a good
solution; the search can be restricted to just the function list.
The other language reference that comes to mind is the perlfunc man
page; every keyword is on one page, with examples. Searching is not as
big a problem because you know you're on the right page already; you
only have to scroll down to the keyword in alphabetical order. It makes
for a long page, but that isn't much of a drawback.
I just had a thought; is there an index of keywords for postgres?
On Tue, 2006-08-08 at 12:33 -0500, Jim Nasby wrote:
> Moving to -www.
>
> I can't think of any good way to fix this; I think this is something
> even Google has issues with. Your best bet is probably to ask pgsql-
> general whatever questions you have. I don't have the docs handy
> right now, but someone else might be able to direct you to wherever IN
> () is documented (probably in the expressions section, or maybe in
> SELECT).
>
> On Aug 1, 2006, at 4:54 PM, PFudd wrote:
> > The following bug has been logged online:
> >
> > Bug reference: 2560
> > Logged by: PFudd
> > Email address: [email protected]
> > PostgreSQL version: 8.1.4
> > Operating system: N/A
> > Description: Web page documentation hard to use
> > Details:
> >
> > I'm trying to look up the SQL keyword 'in' using the postgresql.org
> > web
> > search function.
> >
> > Unfortunately, this word is also present in about every third
> > sentence of
> > every page, making it impossible to search for.
> >
> > In fact, a lot of the sql keywords are impossible to search for,
> > because
> > they're lost in the noise.
> >
> > Can this be fixed?
> >
> > Thanks!
> >
> > ---------------------------(end of
> > broadcast)---------------------------
> > TIP 6: explain analyze is your friend
> >
>
> --
> Jim C. Nasby, Sr. Engineering Consultant [email protected]
> Pervasive Software http://pervasive.com work: 512-231-6117
> vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
>
--
PF <[email protected]>
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: [BUGS] BUG #2560: Web page documentation hard to use
2006-08-01 16:54 BUG #2560: Web page documentation hard to use PFudd <[email protected]>
2006-08-08 17:33 ` Re: [BUGS] BUG #2560: Web page documentation hard to use Jim Nasby <[email protected]>
2006-08-09 16:51 ` Re: [BUGS] BUG #2560: Web page documentation hard to use PF <[email protected]>
@ 2006-08-09 22:59 ` Jim C. Nasby <[email protected]>
0 siblings, 0 replies; 5+ messages in thread
From: Jim C. Nasby @ 2006-08-09 22:59 UTC (permalink / raw)
To: PF <[email protected]>; +Cc: pgsql-www
On Wed, Aug 09, 2006 at 09:51:48AM -0700, PF wrote:
> The php language web site (http://www.php.net/) seems to have a good
> solution; the search can be restricted to just the function list.
>
> The other language reference that comes to mind is the perlfunc man
> page; every keyword is on one page, with examples. Searching is not as
> big a problem because you know you're on the right page already; you
> only have to scroll down to the keyword in alphabetical order. It makes
> for a long page, but that isn't much of a drawback.
>
> I just had a thought; is there an index of keywords for postgres?
No... anyone know the grammar well enough to know if it'd be easy to
extract them? Though I guess we'd still need to come up with references
back to the appropriate documentation page, but it might make sense to
embed that in the grammar code...
--
Jim C. Nasby, Sr. Engineering Consultant [email protected]
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
^ permalink raw reply [nested|flat] 5+ messages in thread
* [Fwd: [BUGS] BUG #2560: Web page documentation hard to use]
@ 2006-08-02 13:53 Devrim GUNDUZ <[email protected]>
0 siblings, 0 replies; 5+ messages in thread
From: Devrim GUNDUZ @ 2006-08-02 13:53 UTC (permalink / raw)
To: pgsql-www
-------- Forwarded Message --------
> From: PFudd <[email protected]>
> To: [email protected]
> Subject: [BUGS] BUG #2560: Web page documentation hard to use
> Date: Tue, 1 Aug 2006 16:54:03 GMT
>
> The following bug has been logged online:
>
> Bug reference: 2560
> Logged by: PFudd
> Email address: [email protected]
> PostgreSQL version: 8.1.4
> Operating system: N/A
> Description: Web page documentation hard to use
> Details:
>
> I'm trying to look up the SQL keyword 'in' using the postgresql.org web
> search function.
>
> Unfortunately, this word is also present in about every third sentence of
> every page, making it impossible to search for.
>
> In fact, a lot of the sql keywords are impossible to search for, because
> they're lost in the noise.
>
> Can this be fixed?
>
> Thanks!
>
> ---------------------------(end of broadcast)---------------------------
> TIP 6: explain analyze is your friend
--
The PostgreSQL Company - Command Prompt, Inc. 1.503.667.4564
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
Managed Services, Shared and Dedicated Hosting
Co-Authors: plPHP, plPerlNG - http://www.commandprompt.com/
Attachments:
[application/pgp-signature] signature.asc (189B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2006-08-09 22:59 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2006-08-01 16:54 BUG #2560: Web page documentation hard to use PFudd <[email protected]>
2006-08-08 17:33 ` Jim Nasby <[email protected]>
2006-08-09 16:51 ` PF <[email protected]>
2006-08-09 22:59 ` Jim C. Nasby <[email protected]>
2006-08-02 13:53 [Fwd: [BUGS] BUG #2560: Web page documentation hard to use] Devrim GUNDUZ <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox