pgsql: Document that the parenthesized VACUUM syntax is deprecated, not

Started by Bruce Momjianabout 15 years ago4 messageshackers
Jump to latest
#1Bruce Momjian
bruce@momjian.us

Document that the parenthesized VACUUM syntax is deprecated, not the
FREEZE functionality.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/ad44d505917baf35994f3eabdb42657bf2342b99

Modified Files
--------------
doc/src/sgml/ref/vacuum.sgml | 9 ++++-----
1 files changed, 4 insertions(+), 5 deletions(-)

#2Robert Haas
robertmhaas@gmail.com
In reply to: Bruce Momjian (#1)
Re: [COMMITTERS] pgsql: Document that the parenthesized VACUUM syntax is deprecated, not

On Fri, Mar 11, 2011 at 5:34 AM, Bruce Momjian <bruce@momjian.us> wrote:

Document that the parenthesized VACUUM syntax is deprecated, not the
FREEZE functionality.

The text you added here is flat-out wrong (you used "unparenthesized"
in both halves of the sentence), and it's also not as clear as the
text it replaced. I'd suggest reverting this, and instead adding a
sentence that says simply:

The unparenthesized syntax is deprecated.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

#3Bruce Momjian
bruce@momjian.us
In reply to: Robert Haas (#2)
Re: [COMMITTERS] pgsql: Document that the parenthesized VACUUM syntax is deprecated, not

Robert Haas wrote:

On Fri, Mar 11, 2011 at 5:34 AM, Bruce Momjian <bruce@momjian.us> wrote:

Document that the parenthesized VACUUM syntax is deprecated, not the
FREEZE functionality.

The text you added here is flat-out wrong (you used "unparenthesized"
in both halves of the sentence), and it's also not as clear as the
text it replaced. I'd suggest reverting this, and instead adding a
sentence that says simply:

The unparenthesized syntax is deprecated.

Fixed. Other changes? I didn't like the original sentence because it
started by mentioning 9.0 rather than the syntax itself.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +

Attachments:

/rtmp/vacuum2.difftext/x-diffDownload+2-2
#4Robert Haas
robertmhaas@gmail.com
In reply to: Bruce Momjian (#3)
Re: [COMMITTERS] pgsql: Document that the parenthesized VACUUM syntax is deprecated, not

On Fri, Mar 11, 2011 at 7:58 AM, Bruce Momjian <bruce@momjian.us> wrote:

Robert Haas wrote:

On Fri, Mar 11, 2011 at 5:34 AM, Bruce Momjian <bruce@momjian.us> wrote:

Document that the parenthesized VACUUM syntax is deprecated, not the
FREEZE functionality.

The text you added here is flat-out wrong (you used "unparenthesized"
in both halves of the sentence), and it's also not as clear as the
text it replaced.  I'd suggest reverting this, and instead adding a
sentence that says simply:

The unparenthesized syntax is deprecated.

Fixed.  Other changes?  I didn't like the original sentence because it
started by mentioning 9.0 rather than the syntax itself.

Hmm, well I don't know. I thought the original phrasing was clearer.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company