Обсуждение: FAQ.html corrections

Поиск
Список
Период
Сортировка

FAQ.html corrections

От
"Greg Sabino Mullane"
Дата:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1


Since the FAQ is a shared beast (on the website and in the main
codebase), it's not available via cvs for the web-developers,
but I am sure that someone on this list has the ability to make
these changes:

Line 163: "reffered" should be "referred"

Line 783: "compatability" should be "compatibility"

Line 916: "avergages" should be "averages"

Line 995: "utilise" should be "utilize" (yes, I know its valid in the UK :)

Line 1044: "through nonexhaustive" should be "through a non-exhaustive"

Line 1327: "prefered" should be "preferred"

The OS2 search string given in section 1.4 is better written as:

http://hobbes.nmsu.edu/cgi-bin/h-search?sh=1&key=postgreSQL+OS%2F2&sort=date

which removes non-OS/2 links, and puts more recent stuff at the top.

Section 1.15 mentions visiting

http://store.pgsql.com/shopping/

which does not seem to exist. Since this FAQ is in widespread distribution,
we should probably put at least a placeholder page there.

Section 4.15, concerning OIDs, is out of date: we should not
be referring to OIDs as "PostgreSQL's answer to unique row ids."

All the URLs given in the FAQ should be replacing "&" with "&"

It would be nice to clean up the HTML and make it more standard (lowercase
the tags), but that's not as vital as the typos above.

That's all for tonight, will look at it closer when I have more time.

- --
Greg Sabino Mullane greg@turnstep.com
PGP Key: 0x14964AC8 200501162028
http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8

-----BEGIN PGP SIGNATURE-----

iD8DBQFB6xgVvJuQZxSWSsgRAp5wAJ9njmqrZolfjDa4ByAEifsFgzP/bACfbt7m
G7Aq7Wm0rRX77vr+trvlk+I=
=eaMq
-----END PGP SIGNATURE-----



Re: FAQ.html corrections

От
Justin Clift
Дата:
Greg Sabino Mullane wrote:
<snip>
> Line 995: "utilise" should be "utilize" (yes, I know its valid in the UK :)

Heh, we'll skip this one for sure.

Words look better spelled properly, not with 'z's.  ;)

+ Justin

--
"One who sees the invisible can do the impossible."
  + Frank Gaines

Re: FAQ.html corrections

От
Bruce Momjian
Дата:
Changed.  I think we have to use US spelling for consistency. I think
our docs made that adjustment too.

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

Justin Clift wrote:
> Greg Sabino Mullane wrote:
> <snip>
> > Line 995: "utilise" should be "utilize" (yes, I know its valid in the UK :)
>
> Heh, we'll skip this one for sure.
>
> Words look better spelled properly, not with 'z's.  ;)
>
> + Justin
>
> --
> "One who sees the invisible can do the impossible."
>   + Frank Gaines
>
> ---------------------------(end of broadcast)---------------------------
> TIP 6: Have you searched our list archives?
>
>                http://archives.postgresql.org
>

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

Re: FAQ.html corrections

От
Justin Clift
Дата:
Bruce Momjian wrote:
> Changed.  I think we have to use US spelling for consistency. I think
> our docs made that adjustment too.

Ugh, you've got to be kidding.

+ Justin

--
"One who sees the invisible can do the impossible."
  + Frank Gaines

Re: FAQ.html corrections

От
Josh Berkus
Дата:
Bruce,

> Bruce Momjian wrote:
> > Changed.  I think we have to use US spelling for consistency. I think
> > our docs made that adjustment too.

Since when?  We've been agnostic about US/British spellings for years.   For
example, our license is as licence.html.

--
--Josh

Josh Berkus
Aglio Database Solutions
San Francisco

Re: FAQ.html corrections

От
Bruce Momjian
Дата:
Josh Berkus wrote:
> Bruce,
>
> > Bruce Momjian wrote:
> > > Changed.  I think we have to use US spelling for consistency. I think
> > > our docs made that adjustment too.
>
> Since when?  We've been agnostic about US/British spellings for years.   For
> example, our license is as licence.html.

Oh, I thought we had made changes for consistency in the docs.  Maybe
someone just suggested it in the past.  I have not feeling one way or
the other myself.  If we could mix non-English in to the docs that would
be cool too.

I will say I can't spell most words that are different in US and UK
anymore because I can't remember which is which anymore.  License is one
of the confusing ones.

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

Re: FAQ.html corrections

От
Robert Treat
Дата:
On Monday 17 January 2005 00:01, Bruce Momjian wrote:
> Josh Berkus wrote:
> > Bruce,
> >
> > > Bruce Momjian wrote:
> > > > Changed.  I think we have to use US spelling for consistency. I think
> > > > our docs made that adjustment too.
> >
> > Since when?  We've been agnostic about US/British spellings for years.
> > For example, our license is as licence.html.
>
> Oh, I thought we had made changes for consistency in the docs.  Maybe
> someone just suggested it in the past.  I have not feeling one way or
> the other myself.  If we could mix non-English in to the docs that would
> be cool too.
>
> I will say I can't spell most words that are different in US and UK
> anymore because I can't remember which is which anymore.  License is one
> of the confusing ones.

I just got tripped up by vacuum/explain analyze and analyse. Everwhere in the
docs we refer to it as analyze, but both work and analyse is a reserved word.
Was thinking maybe the analyze page should be updated if we don't have any
intention to move toward one or the other.  Incidentally, while my opinion
may be a little coloured ;-) I do think the Z spelling is more correct, since
afaik everyone says it with z phonetics.

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

Re: FAQ.html corrections

От
Bruce Momjian
Дата:
Robert Treat wrote:
> On Monday 17 January 2005 00:01, Bruce Momjian wrote:
> > Josh Berkus wrote:
> > > Bruce,
> > >
> > > > Bruce Momjian wrote:
> > > > > Changed.  I think we have to use US spelling for consistency. I think
> > > > > our docs made that adjustment too.
> > >
> > > Since when?  We've been agnostic about US/British spellings for years.
> > > For example, our license is as licence.html.
> >
> > Oh, I thought we had made changes for consistency in the docs.  Maybe
> > someone just suggested it in the past.  I have not feeling one way or
> > the other myself.  If we could mix non-English in to the docs that would
> > be cool too.
> >
> > I will say I can't spell most words that are different in US and UK
> > anymore because I can't remember which is which anymore.  License is one
> > of the confusing ones.
>
> I just got tripped up by vacuum/explain analyze and analyse. Everwhere in the
> docs we refer to it as analyze, but both work and analyse is a reserved word.
> Was thinking maybe the analyze page should be updated if we don't have any
> intention to move toward one or the other.  Incidentally, while my opinion
> may be a little coloured ;-) I do think the Z spelling is more correct, since
> afaik everyone says it with z phonetics.

How do you want to modify the analyze manual page?  Add a mention of
ANALYSE?  Sure.

I like supporting both spellings for user input.

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