Date: Thu, 10 Jan 2019 20:24:32 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: aleon1220@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: .pgpass
Message-ID: <20190110112432.GO2157@paquier.xyz>
References: <154709193735.22759.14024284152766029001@wrigleys.postgresql.org>
 <781EBDA7-16F8-496C-B96E-D7CDADE6E51E@yesql.se>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="ZgGN478A9hzzvyZc"
Content-Disposition: inline
In-Reply-To: <781EBDA7-16F8-496C-B96E-D7CDADE6E51E@yesql.se>
Precedence: bulk


--ZgGN478A9hzzvyZc
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Jan 10, 2019 at 11:02:08AM +0100, Daniel Gustafsson wrote:
> On 10 Jan 2019, at 04:45, PG Doc comments form <noreply@postgresql.org> w=
rote:
>> I kindly suggest to let me edit this part to create examples such as=20
>> pg_restore -h HOST -p PORT -U SUPERUSERNAME -C -d postgres
>> DBtoRESTORE.BACKUPEXTENSION
>>=20
>> this will be like generalized examples that users can replicate.
>=20
> The documentation isn=E2=80=99t edited online, but is contained in the po=
stgres source
> repository.  If you want to edit it you will have to clone the repository=
 and
> propose a patch with your changes on the pgsql-docs mailinglist.  The =E2=
=80=9CWorking
> with Git=E2=80=9D article on the postgres wiki can be a good place to sta=
rt if you are
> new to working in the source repository.

Before shaping a patch it is always possible to discuss the changes
you would like to do with the paragraphs you would like to introduce
as there is always room for improvements.  No, it is hard to
understand how you would like to improve things, why it makes sense,
and why the current set of examples is not enough to explain what you
are looking for.  The documentation needs to remain concise and a
maximum representative as well, so as any human reading it does not
get lost in a flow of useless information.  Based on the information
given in your initial mail, it is not really possible to see how at
least one of those points can be actually improved, so you need first
to bring more precisions on the matter.
--
Michael

--ZgGN478A9hzzvyZc
Content-Type: application/pgp-signature; name="signature.asc"

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

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAlw3K3AACgkQnvQgOdby
QH3AXQ//fAidmuy10Wwz1fPG8QZziit/R2lzsdVSFMI5JrQcz4ZlZxfBFUOOdhnr
riAI50QFTMiDIs9sXhoixQfEA8qib806iOgyjzNI9WIjwBtEshvbUIlaomaT1Dxs
9/C5OklagdnSkHCF/rToqP+oEFvbWRVkr01e6c86Pugo+3YxXDSJQSK3rr6WzAlF
FtJBM/5X7/KPwuFqpVpRMiKABuOpn+BApf9wQDb2EtQqTDwaY8kE1ynSGfpQ1+ym
b8l1m27pUayBsFwGD0iN3XXTEL42Au9TYg5xaNHngmEUy1Sn8WOgLqWEnyKJlsDc
bM9C9YM99B9c9n9AeBIzuSMGuFbFxNQWKlgJuke534XXWAH0QFQtVKTXuOrY/yA5
crgWsNVJo/aCg3Wn/NfdEaYgdtEzR9oVi7tPeTT1YjFprXD1Okyw5Vzym+/WR1MZ
EeHlKR7cODTw0ddRE7aGhx+D5AI+EmtCdIyUImQqgZkxO7KLaiWoChNuOdbOPVjz
kbB6yteOpr0omq/ceDNYHW5nTgJUdgdg0HbQiCL1vjytsMP5KKBGysB8CWJ+BO/C
BZ2sZpBJ59mggMFCX/CvIDY7r6sTTtK/6G+W3+egprma9dcf3t6B9DwKWW/xKCtB
ZIvI3kbj1RxtA3ZXLQep8VIxLlH6aKk6MxwOe/VRp3/Timroe7o=
=e9lL
-----END PGP SIGNATURE-----

--ZgGN478A9hzzvyZc--