From 82d679cdb33e83ea52522618616d502d06707347 Mon Sep 17 00:00:00 2001 From: Daniele Varrazzo Date: Mon, 24 Aug 2020 01:44:45 +0100 Subject: [PATCH] A few corrections to the install page Spacing, lines length, a spurious link targed, reST formatting. --- doc/src/install.rst | 22 +++++++++------------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/doc/src/install.rst b/doc/src/install.rst index 53798d7c..ee845f7f 100644 --- a/doc/src/install.rst +++ b/doc/src/install.rst @@ -22,14 +22,17 @@ wrapper for the libpq_, the official PostgreSQL client library. Quick Install ------------- -For most operating systems, the quickest way to install psycopg is using the wheel_ package available on PyPI_: +For most operating systems, the quickest way to install Psycopg is using the +wheel_ package available on PyPI_: .. code-block:: console $ pip install psycopg2-binary -This will install a pre-compiled binary version of the module which does not require the build or runtime prerequisites described below. Make sure to use an up-date-date version of :program:`pip` (you can upgrade it -using something like ``pip install -U pip``). +This will install a pre-compiled binary version of the module which does not +require the build or runtime prerequisites described below. Make sure to use +an up-date-date version of :program:`pip` (you can upgrade it using something +like ``pip install -U pip``). You may then import the ``psycopg`` package, as usual: @@ -49,10 +52,10 @@ You may then import the ``psycopg`` package, as usual: # Retrieve query results records = cur.fetchall() -.. __: PyPI-binary_ .. _PyPI: https://pypi.org/project/psycopg2-binary/ .. _wheel: https://pythonwheels.com/ + psycopg vs psycopg-binary ^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -61,10 +64,9 @@ with Python and PostgreSQL without the need to meet the build requirements. If you are the maintainer of a published package depending on `!psycopg2` -you shouldn't use 'psycopg2-binary' as a module dependency. **For +you shouldn't use ``psycopg2-binary`` as a module dependency. **For production use you are advised to use the source distribution.** - The binary packages come with their own versions of a few C libraries, among which ``libpq`` and ``libssl``, which will be used regardless of other libraries available on the client: upgrading the system libraries will not @@ -81,7 +83,6 @@ source if you want to maintain binary upgradeability. advised to use a package built from source. - .. index:: single: Install; disable wheel single: Wheel; disable @@ -219,10 +220,6 @@ which is OS-dependent (for instance setting a suitable to connect to. - - - - .. index:: single: setup.py single: setup.cfg @@ -335,7 +332,6 @@ setting the environment variables: The database should already exist before running the tests. - .. _other-problems: If you still have problems @@ -360,4 +356,4 @@ Try the following. *In order:* :envvar:`ARCHFLAGS`. Especially useful from the Starbucks near you. .. _mailing list: https://www.postgresql.org/list/psycopg/ -.. _bug tracker: https://github.com/psycopg/psycopg2/issues \ No newline at end of file +.. _bug tracker: https://github.com/psycopg/psycopg2/issues