diff --git a/doc/setup.rst b/doc/setup.rst index ad4fca269c..808631e661 100644 --- a/doc/setup.rst +++ b/doc/setup.rst @@ -96,7 +96,7 @@ Quick Install Downloads page. Some kits contain only the English messages, others contain all languages. We'll assume you chose a kit whose name looks like ``phpMyAdmin-x.x.x -all-languages.tar.gz``. -#. Ensure you have downloaded genuine archive, see :ref:`verify`. +#. Ensure you have downloaded a genuine archive, see :ref:`verify`. #. Untar or unzip the distribution (be sure to unzip the subdirectories): ``tar -xzvf phpMyAdmin_x.x.x-all-languages.tar.gz`` in your webserver's document root. If you don't have direct access to your @@ -254,11 +254,11 @@ Verifying phpMyAdmin releases Since July 2015 all phpMyAdmin releases are cryptographically signed by the releasing developer. You should verify that the signature matches the archive -you have downloaded. This way you can be sure that you are using exactly same -code as has been released. +you have downloaded. This way you can be sure that you are using the same code +that was released. -Each archive is accompanied with ``.asc`` files which contains PGP signature -for it. Once you have both of them in a same folder, you can verify the signature: +Each archive is accompanied with ``.asc`` files which contains the PGP signature +for it. Once you have both of them in the same folder, you can verify the signature: .. code-block:: console @@ -278,8 +278,8 @@ download the key from our download server or from one of the key servers: gpg: Total number processed: 1 gpg: imported: 1 (RSA: 1) -This will improve the situation a bit - at this point you can verify that -signature from given key is correct but you still can not trust the name used +This will improve the situation a bit - at this point you can verify that the +signature from the given key is correct but you still can not trust the name used in the key: .. code-block:: console @@ -291,11 +291,11 @@ in the key: gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: 436F F188 4B1A 0C3F DCBF 0D79 FEFC 65D1 81AF 644A -The problem here is that anybody could issue the key with this name. You need -ensure that the key is actually owned by mentioned person. The GNU Privacy +The problem here is that anybody could issue the key with this name. You need to +ensure that the key is actually owned by the mentioned person. The GNU Privacy Handbook covers this topic in the chapter `Validating other keys on your public -keyring`_. The most reliable method is to meed the developer in person and -exchange key fingerprints, however you can also rely on web of trust. This way +keyring`_. The most reliable method is to meet the developer in person and +exchange key fingerprints, however you can also rely on the web of trust. This way you can trust the key transitively though signatures of others, who have met the developer in person. For example you can see how `Marc's key links to Linus one`_. @@ -308,8 +308,8 @@ Once the key is trusted, you should get rid of that warning: gpg: Signature made Fri Jun 12 13:09:58 2015 CEST using RSA key ID 81AF644A gpg: Good signature from "Marc Delisle " [full] -Should the signature be invalid (the archive has been changed), you would get -clear error regardless the keys is trusted or not: +Should the signature be invalid (the archive has been changed), you would get a +clear error regardless of the fact that the key is trusted or not: .. code-block:: console