Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIXLZ-0002T8-O6 for pgsql-docs@arkaria.postgresql.org; Sat, 25 Nov 2017 10:06:05 +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 1eIXLY-0003Mo-Po for pgsql-docs@arkaria.postgresql.org; Sat, 25 Nov 2017 10:06:04 +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 1eIXLY-0003MY-IF for pgsql-docs@lists.postgresql.org; Sat, 25 Nov 2017 10:06:04 +0000 Received: from mail-wr0-x242.google.com ([2a00:1450:400c:c0c::242]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1eIXLR-0002HR-0m for pgsql-docs@postgresql.org; Sat, 25 Nov 2017 10:06:01 +0000 Received: by mail-wr0-x242.google.com with SMTP id z75so20864279wrc.5 for ; Sat, 25 Nov 2017 02:05:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=4PSl/UPpzLoIuYp5lFh8SaftYdwj76wH7NOFxvwlx1U=; b=I9nr80+Di9YJmkRrygcl5BIQ+KLd3VHhFHZKwAj5Dfv8OSuBnFWyMTD8auP37yqmZx xrmcCE5/bk7s0HNPNbqq8QasKY+LxGr4l7+LDskW4idkYXSu5Yb8DlI5Xt/rthO+TdtC HdCyVMFlm/GFcjWU+Db46LTwQI6u6iAs4AUBdc4RsNvmg42cGfQDFSWDi6jxwX3APeYT D0/nHPWmUA8O5g0dtUmQqInrvs01glSMIZt19To1sdG9Hwp66rHClnP/kaszy/IoGJeL SiU1rV4vOugvhdQaAWl2rRCUrgY9X8q+G/LkfQAsJI+GnJ/2zdpiuSnbBTUr6lvYZYOW UqLA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=4PSl/UPpzLoIuYp5lFh8SaftYdwj76wH7NOFxvwlx1U=; b=jHW+CiXzwlNxxLQQ/ajHWvwkHmXF2KiCkfEWOnzsZaWLxEmSRwxm3m6/v3yaxgMSjv JmXzSEosrPbc5cuOIQI4C1u0i+lK6n/QIlyfkzAqbJeclAJKSBKXN/CqvpF2Q5712/8V UxYki2ebVKv4Qn0VZpobSAffxlXgq4QqGcwM5d7XS8kP83rccSYpa/wn5pivl/J4SiKY LHIYFp2CeFsnIqXNhNEAkTRqc6wzLt5JbM3b7bdAqOLJVspHu8KAxaIJu66ttOHhzGZw bGW+4Nbvk1UsFaZzjMdyqA0Eim5FK7XrFOigYP8Y+/NLI3c07hJ1hV+UWhAJ6iSNXwPs 51aA== X-Gm-Message-State: AJaThX5NN7SXf02yE6HhinZHTZF6OWzT5kg4lwu5WbK9ryIHqfb0qvf0 nnBHHWD7q3BUlI3/OTPr9KFs+ZyxR54L+oVJeUU= X-Google-Smtp-Source: AGs4zMaOPa0gpJSk3ptSeh+5VG6lTfVC7ww3H3pqLuaOC6bdEJ96oEwLor4yprB3e8Y6IXlVEqhScwjIL/NefPTnPIQ= X-Received: by 10.223.150.118 with SMTP id c51mr24600412wra.202.1511604355262; Sat, 25 Nov 2017 02:05:55 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.157.137 with HTTP; Sat, 25 Nov 2017 02:05:54 -0800 (PST) In-Reply-To: References: <20171122132714.1463.27247@wrigleys.postgresql.org> From: Michael Paquier Date: Sat, 25 Nov 2017 19:05:54 +0900 Message-ID: Subject: Re: libpq options To: sahapasci@gmail.com Cc: pgsql-docs@postgresql.org, Fujii Masao Content-Type: multipart/mixed; boundary="001a1147d0f2a31854055ecbd0b5" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --001a1147d0f2a31854055ecbd0b5 Content-Type: text/plain; charset="UTF-8" On Wed, Nov 22, 2017 at 11:36 PM, Michael Paquier wrote: > Yeah, it is mainly a developer option which is why I guess it is not > documented. Like you, I think it should be added as part of the > connection parameter, and mentioned it a couple of days back: > https://www.postgresql.org/message-id/CAB7nPqQAtKfG3H%2BuK11JNivtJtZYE9yVCrPuejRMjp8tUDe0nQ%40mail.gmail.com Attached is a patch as an attempt to bring together the best of both worlds. The idea is to move the description of how the connection parameter replication works from the replication protocol page into the section of libpq dedicated to connection parameters, and add links between both sections. Thoughts? -- Michael --001a1147d0f2a31854055ecbd0b5 Content-Type: text/x-patch; charset="US-ASCII"; name="replication-param-doc.patch" Content-Disposition: attachment; filename="replication-param-doc.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: f_jaf63bcx0 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9saWJwcS5zZ21sIGIvZG9jL3NyYy9zZ21sL2xpYnBx LnNnbWwKaW5kZXggNDcwMzMwOTI1NC4uMDliZmNiYmVjMyAxMDA2NDQKLS0tIGEvZG9jL3NyYy9z Z21sL2xpYnBxLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL2xpYnBxLnNnbWwKQEAgLTEyMjIsNiAr MTIyMiwyNCBAQCBwb3N0Z3Jlc3FsOi8vJTJGdmFyJTJGbGliJTJGcG9zdGdyZXNxbC9kYm5hbWUK ICAgICAgIDwvbGlzdGl0ZW0+CiAgICAgIDwvdmFybGlzdGVudHJ5PgogCisgICAgIDx2YXJsaXN0 ZW50cnkgaWQ9ImxpYnBxLWNvbm5lY3QtcmVwbGljYXRpb24iIHhyZWZsYWJlbD0icmVwbGljYXRp b24iPgorICAgICAgPHRlcm0+PGxpdGVyYWw+cmVwbGljYXRpb248L2xpdGVyYWw+PC90ZXJtPgor ICAgICAgPGxpc3RpdGVtPgorICAgICAgPHBhcmE+CisgICAgICAgVGhpcyBvcHRpb24gZGV0ZXJt aW5lcyBpZiBhIGJhY2tlbmQgc2hvdWxkIHVzZSB0aGUgcmVwbGljYXRpb24KKyAgICAgICBwcm90 b2NvbC4gQSBCb29sZWFuIHZhbHVlIG9mIDxsaXRlcmFsPnRydWU8L2xpdGVyYWw+IHRlbGxzIHRo ZSBiYWNrZW5kCisgICAgICAgdG8gZ28gaW50byB3YWxzZW5kZXIgbW9kZSwgd2hlcmVpbiBhIHNt YWxsIHNldCBvZiByZXBsaWNhdGlvbiBjb21tYW5kcworICAgICAgIGNhbiBiZSBpc3N1ZWQgaW5z dGVhZCBvZiBTUUwgc3RhdGVtZW50cy4gT25seSB0aGUgc2ltcGxlIHF1ZXJ5IHByb3RvY29sCisg ICAgICAgY2FuIGJlIHVzZWQgaW4gd2Fsc2VuZGVyIG1vZGUuIFBhc3NpbmcgPGxpdGVyYWw+ZGF0 YWJhc2U8L2xpdGVyYWw+CisgICAgICAgYXMgdGhlIHZhbHVlIGluc3RydWN0cyB3YWxzZW5kZXIg dG8gY29ubmVjdCB0byB0aGUgZGF0YWJhc2Ugc3BlY2lmaWVkCisgICAgICAgaW4gdGhlIDxsaXRl cmFsPmRibmFtZTwvbGl0ZXJhbD4gcGFyYW1ldGVyLCB3aGljaCB3aWxsIGFsbG93IHRoZQorICAg ICAgIGNvbm5lY3Rpb24gdG8gYmUgdXNlZCBmb3IgbG9naWNhbCByZXBsaWNhdGlvbiBmcm9tIHRo YXQgZGF0YWJhc2UuCisgICAgICAgRm9yIGEgZGV0YWlsZWQgZGVzY3JpcHRpb24gYWJvdXQgdGhl IHJlcGxpY2F0aW9uIHByb3RvY29sLCBjb25zdWx0CisgICAgICAgPHhyZWYgbGlua2VuZD0icHJv dG9jb2wtcmVwbGljYXRpb24iLz4uCisgICAgICA8L3BhcmE+CisgICAgICA8L2xpc3RpdGVtPgor ICAgICA8L3Zhcmxpc3RlbnRyeT4KKwogICAgICA8dmFybGlzdGVudHJ5IGlkPSJsaWJwcS1jb25u ZWN0LXNzbG1vZGUiIHhyZWZsYWJlbD0ic3NsbW9kZSI+CiAgICAgICA8dGVybT48bGl0ZXJhbD5z c2xtb2RlPC9saXRlcmFsPjwvdGVybT4KICAgICAgIDxsaXN0aXRlbT4KZGlmZiAtLWdpdCBhL2Rv Yy9zcmMvc2dtbC9wcm90b2NvbC5zZ21sIGIvZG9jL3NyYy9zZ21sL3Byb3RvY29sLnNnbWwKaW5k ZXggODE3NGUzZGVmYS4uYjg1YTNlZGRhOSAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL3Byb3Rv Y29sLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL3Byb3RvY29sLnNnbWwKQEAgLTE2MzAsMTUgKzE2 MzAsOSBAQCBzdXBwb3J0ZWQgYXQgdGhlIG1vbWVudCBpcyA8bGl0ZXJhbD50bHMtdW5pcXVlPC9s aXRlcmFsPiwgZGVmaW5lZCBpbiBSRkMgNTkyOS4KIAogPHBhcmE+CiBUbyBpbml0aWF0ZSBzdHJl YW1pbmcgcmVwbGljYXRpb24sIHRoZSBmcm9udGVuZCBzZW5kcyB0aGUKLTxsaXRlcmFsPnJlcGxp Y2F0aW9uPC9saXRlcmFsPiBwYXJhbWV0ZXIgaW4gdGhlIHN0YXJ0dXAgbWVzc2FnZS4gQSBCb29s ZWFuIHZhbHVlCi1vZiA8bGl0ZXJhbD50cnVlPC9saXRlcmFsPiB0ZWxscyB0aGUgYmFja2VuZCB0 byBnbyBpbnRvIHdhbHNlbmRlciBtb2RlLCB3aGVyZWluIGEKLXNtYWxsIHNldCBvZiByZXBsaWNh dGlvbiBjb21tYW5kcyBjYW4gYmUgaXNzdWVkIGluc3RlYWQgb2YgU1FMIHN0YXRlbWVudHMuIE9u bHkKLXRoZSBzaW1wbGUgcXVlcnkgcHJvdG9jb2wgY2FuIGJlIHVzZWQgaW4gd2Fsc2VuZGVyIG1v ZGUuCi1SZXBsaWNhdGlvbiBjb21tYW5kcyBhcmUgbG9nZ2VkIGluIHRoZSBzZXJ2ZXIgbG9nIHdo ZW4KKzx4cmVmIGxpbmtlbmQ9ImxpYnBxLWNvbm5lY3QtcmVwbGljYXRpb24iLz4gY29ubmVjdGlv biBwYXJhbWV0ZXIgaW4gdGhlCitzdGFydHVwIG1lc3NhZ2UuIFJlcGxpY2F0aW9uIGNvbW1hbmRz IGFyZSBsb2dnZWQgaW4gdGhlIHNlcnZlciBsb2cgd2hlbgogPHhyZWYgbGlua2VuZD0iZ3VjLWxv Zy1yZXBsaWNhdGlvbi1jb21tYW5kcyIvPiBpcyBlbmFibGVkLgotUGFzc2luZyA8bGl0ZXJhbD5k YXRhYmFzZTwvbGl0ZXJhbD4gYXMgdGhlIHZhbHVlIGluc3RydWN0cyB3YWxzZW5kZXIgdG8gY29u bmVjdCB0bwotdGhlIGRhdGFiYXNlIHNwZWNpZmllZCBpbiB0aGUgPGxpdGVyYWw+ZGJuYW1lPC9s aXRlcmFsPiBwYXJhbWV0ZXIsIHdoaWNoIHdpbGwgYWxsb3cKLXRoZSBjb25uZWN0aW9uIHRvIGJl IHVzZWQgZm9yIGxvZ2ljYWwgcmVwbGljYXRpb24gZnJvbSB0aGF0IGRhdGFiYXNlLgogPC9wYXJh PgogPHBhcmE+CiAgRm9yIHRoZSBwdXJwb3NlIG9mIHRlc3RpbmcgcmVwbGljYXRpb24gY29tbWFu ZHMsIHlvdSBjYW4gbWFrZSBhIHJlcGxpY2F0aW9uCg== --001a1147d0f2a31854055ecbd0b5--