[DOCS] Terms.
Hey all, At http://www.postgresql.org/docs/9.0/static/libpq-connect.html the first sentence is "The following functions deal with making a connection to a PostgreSQLbackend server." Please, change "backend server" to "backend" or "server", as of at http://www.postgresql.org/docs/9.0/static/protocol.html written: "...the terms "backend" and "server" are interchangeable..." Accuracy - the politeness of kings. :-) Regards, Dmitriy
Re: [DOCS] Terms.
On Fri, Sep 17, 2010 at 3:32 AM, Dmitriy Igrishin wrote: > At http://www.postgresql.org/docs/9.0/static/libpq-connect.html > the first sentence is > "The following functions deal with making a connection to a PostgreSQL > backend server." > Please, change "backend server" to "backend" or "server", as of > at http://www.postgresql.org/docs/9.0/static/protocol.html > written: > "...the terms "backend" and "server" are interchangeable..." > > Accuracy - the politeness of kings. :-) Hmm. The existing text might be redundant, but I don't think it's inaccurate. Since the rest of the section alternates back and forth between the two terms, it seems like this might help to remind the reader that they are effectively synonymous. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise Postgres Company -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Terms.
Hey Robert, Hmm. The existing text might be redundant, but I don't think it's > inaccurate. Since the rest of the section alternates back and forth > between the two terms, it seems like this might help to remind the > reader that they are effectively synonymous. > I am the reader and just a user of libpq, not a guru :-). I must admit that this is a trifle, but I think it's indeed inaccurate. Also I think, that it's inaccurate to call one function PQnfields() and another PQftablecol(). Yes, terms "field" and "column" are interchangeable, but (personally) I don't clearly understand why two functions named not monotonous. But all of the above is my personal point of view. So, just ignore it if you don't like it :-) Regards, Dmitriy
