Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eR307-0000KS-Tr for pgsql-docs@arkaria.postgresql.org; Mon, 18 Dec 2017 21:31:08 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eR307-0007WU-GP for pgsql-docs@arkaria.postgresql.org; Mon, 18 Dec 2017 21:31:07 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1eR307-0007WJ-BH for pgsql-docs@lists.postgresql.org; Mon, 18 Dec 2017 21:31:07 +0000 Received: from wrigleys.postgresql.org ([204.145.124.246]) by magus.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1eR303-0001bx-QX for pgsql-docs@postgresql.org; Mon, 18 Dec 2017 21:31:06 +0000 Content-Type: multipart/mixed; boundary="===============8024424338136789429==" MIME-Version: 1.0 Subject: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader To: pgsql-docs@postgresql.org From: =?utf-8?q?PG_Doc_comments_form?= Cc: jim@room118solutions.com Reply-To: jim@room118solutions.com, pgsql-docs@postgresql.org Date: Mon, 18 Dec 2017 21:30:41 +0000 Message-ID: <20171218213041.25744.8414@wrigleys.postgresql.org> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --===============8024424338136789429== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 VGhlIGZvbGxvd2luZyBkb2N1bWVudGF0aW9uIGNvbW1lbnQgaGFzIGJlZW4gbG9nZ2VkIG9uIHRo ZSB3ZWJzaXRlOgoKUGFnZTogaHR0cHM6Ly93d3cucG9zdGdyZXNxbC5vcmcvZG9jcy85LjYvc3Rh dGljL3BndXBncmFkZS5odG1sCkRlc2NyaXB0aW9uOgoKSWYgYSByZWFkZXIgd2hvIGlzIHVuZmFt aWxpYXIgd2l0aCBQb3N0Z3JlU1FMJiMzOTtzIHZlcnNpb25pbmcgKHdoZXJlIDkuNSBhbmQKOS42 IGFyZSBjb25zaWRlcmVkIG1ham9yIHZlcnNpb25zKSByZWFkcyB0aGUgZG9jdW1lbnRhdGlvbiwg aXQgaXMgdW5jbGVhciBpZgp0aGV5IG5lZWQgdG8gdXNlIHBnX3VwZ3JhZGUgdG8gbWlncmF0ZSBm cm9tIDkuNSB0byA5LjYsIGZvciBleGFtcGxlLg0KDQpUaGUgZG9jdW1lbnRhdGlvbiBzYXlzIHVw Z3JhZGluZyAmcXVvdDtmcm9tIDkuNi4zIHRvIHRoZSBjdXJyZW50IG1ham9yIHJlbGVhc2UmcXVv dDsKcmVxdWlyZXMgcGdfdXBncmFkZSwgYnV0IG5vdCAmcXVvdDtmcm9tIDkuNi4yIHRvIDkuNi4z JnF1b3Q7LiANCg0KVGhlIHByb2JsZW0gd2l0aCB0aGF0IGxhbmd1YWdlIGlzIHRoYXQgdGhlIGN1 cnJlbnQgcmVsZWFzZSBvZiBQb3N0Z3JlU1FMIGlzCjEwLiAgU28gaXMgcGdfdXBncmFkZSByZXF1 aXJlZCB0byB1cGdyYWRlIGZyb20gOS42LjMgdG8gY3VycmVudCAoMTApIGJlY2F1c2UKOSBhbmQg MTAgYXJlIG1ham9yIHZlcnNpb25zIG9yIGJlY2F1c2UgOS42IGFuZCAxMC4wIGFyZSBtYWpvciB2 ZXJzaW9ucz8gKHRoZQpsYXR0ZXIpLg0KDQpJdCB3b3VsZCBiZSBjbGVhcmVyIGlmIHRoZSBkb2N1 bWVudGF0aW9uIGNvdmVyZWQgYWxsIHRocmVlIGNhc2VzOg0KOS42LjMgLSZndDsgMTAuMC4wIGFu ZCA5LjUuMSAtJmd0OyA5LjYuMzogcGdfdXBncmFkZSBzaG91bGQgYmUgdXNlZA0KOS42LjIgLSZn dDsgOS42LjM6IHBnX3VwZ3JhZGUgbm90IG5lZWRlZA0KDQpPciBpZiB0aGUgZG9jdW1lbnRhdGlv biBzaW1wbHkgbm90ZWQgdGhhdCB0aGUgc2Vjb25kIGRlY2ltYWwgaXMgY29uc2lkZXJlZCBhCm1h am9yIHJlbGVhc2UuDQoNClRoYW5rcyBmb3IgUG9zdGdyZVNRTCEgDQoNCkppbQ0KCg== --===============8024424338136789429==--