update installation notes in docs

Signed-off-by: oleg.hoefling <oleg.hoefling@gmail.com>

Author: hoefling

README.rst

@@ -41,8 +41,8 @@ Install
 
    pip install xmlsec
 
-Prerequisites
--------------
+Depending on your OS, you may need to install the required native
+libraries first:
 
 Linux (Debian)
 ^^^^^^^^^^^^^^
@@ -71,6 +71,14 @@ Linux (CentOS)
    yum install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
 
 
+Linux (Fedora)
+^^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   dnf install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
+
+
 Mac
 ^^^
 
@@ -86,8 +94,9 @@ Alpine
 
    apk add build-base libressl libffi-dev libressl-dev libxslt-dev libxml2-dev xmlsec-dev xmlsec
 
+
 Troubleshooting
----------------
+***************
 
 Mac
 ^^^
@@ -114,9 +123,9 @@ to build from source:
 
 
 Building from source
---------------------
+********************
 
-#. Clone the ``xmlsec`` repository to your local computer.
+#. Clone the ``xmlsec`` source code repository to your local computer.
 
    .. code-block:: bash
 
@@ -140,9 +149,9 @@ Contributing
 ************
 
 Setting up your environment
----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-#. Follow steps 1 and 2 of the `manual installation instructions <#manual>`_.
+#. Follow steps 1 and 2 of the `manual installation instructions <#building-from-source>`_.
 
 
 #. Initialize a virtual environment to develop in.
@@ -171,7 +180,7 @@ Setting up your environment
 
 
 Running the test suite
-----------------------
+^^^^^^^^^^^^^^^^^^^^^^
 
 #. `Set up your environment <#setting-up-your-environment>`_.
 
@@ -187,7 +196,7 @@ Running the test suite
    test iterations to detect memory leaks.
 
 Reporting an issue
-------------------
+^^^^^^^^^^^^^^^^^^
 
 Please attach the output of following information:
 

doc/source/install.rst

@@ -1,67 +1,89 @@
-Install
------------
+Installation
+============
 
-Linux (Debian)
-^^^^^^^^^^^^^^
+``xmlsec`` is available on PyPI:
 
 .. code-block:: bash
 
-    apt-get install libxml2-dev libxmlsec1-dev libxmlsec1-openssl
-    pip install xmlsec
+   pip install xmlsec
 
+Depending on your OS, you may need to install the required native
+libraries first:
 
-Note: There is no required version of libxml2 for ubuntu precise,
-so need to download and install it manually.
+Linux (Debian)
+--------------
 
 .. code-block:: bash
 
-    wget http://xmlsoft.org/sources/libxml2-2.9.1.tar.gz
-    tar -xvf libxml2-2.9.1.tar.gz
-    cd libxml2-2.9.1
-    ./configure && make && make install
+   apt-get install libxml2-dev libxmlsec1-dev libxmlsec1-openssl
+
+.. note:: There is no required version of LibXML2 for Ubuntu Precise,
+   so you need to download and install it manually:
+
+   .. code-block:: bash
+
+      wget http://xmlsoft.org/sources/libxml2-2.9.1.tar.gz
+      tar -xvf libxml2-2.9.1.tar.gz
+      cd libxml2-2.9.1
+      ./configure && make && make install
 
 
 Linux (CentOS)
-^^^^^^^^^^^^^^
+--------------
 
 .. code-block:: bash
 
-    yum install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
-    pip install xmlsec
+   yum install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
+
+
+Linux (Fedora)
+--------------
+
+.. code-block:: bash
+
+   dnf install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
 
 
 Mac
-^^^
+---
 
 .. code-block:: bash
 
-    xcode-select --install
-    brew upgrade
-    brew install libxml2 libxmlsec1 pkg-config
-    pip install xmlsec
+   xcode-select --install
+   brew upgrade
+   brew install libxml2 libxmlsec1 pkg-config
 
 
+Alpine
+------
 
-Windows (Wheel)
-^^^^^^^^^^^^^^^
+.. code-block:: bash
 
-#. Download appropriate binary wheels from `appveyor <https://ci.appveyor.com/project/bgaifullin/python-xmlsec>`_ (see build`s artifacts).
+   apk add build-base libressl libffi-dev libressl-dev libxslt-dev libxml2-dev xmlsec-dev xmlsec
 
-#. Install downloaded wheel
 
-    .. code-block:: bash
+Troubleshooting
+***************
 
-        pip install <downloaded wheel filename>
+Mac
+---
 
+If you get any fatal errors about missing ``.h`` files, update your
+``C_INCLUDE_PATH`` environment variable to include the appropriate
+files from the ``libxml2`` and ``libxmlsec1`` libraries.
 
-Windows (pip)
-^^^^^^^^^^^^^
 
-#. Configure build environment, see `wiki.python.org <https://wiki.python.org/moin/WindowsCompilers>`_ for more details.
+Windows
+-------
+
+Starting with 1.3.7, prebuilt wheels are available for Windows,
+so running ``pip install xmlsec`` should suffice. If you want
+to build from source:
 
-#. Install from pip
+#. Configure build environment, see `wiki.python.org <https://wiki.python.org/moin/WindowsCompilers>`_ for more details.
 
-    .. code-block:: bash
+#. Install from source dist:
 
-        pip install xmlsec
+   .. code-block:: bash
 
+      pip install xmlsec --no-binary=xmlsec