diff --git a/README.rst b/README.rst index df51e1e9..00521ccf 100644 --- a/README.rst +++ b/README.rst @@ -74,16 +74,20 @@ Linux ----- Most Linux distributions provide a package that can be installed using the -system package manager, e.g.: +system package manager, for example: .. code-block:: bash - # Debian-based distributions such as Ubuntu: + # Debian, Ubuntu, etc. $ apt-get install httpie - # RPM-based distributions: +.. code-block:: bash + + # Fedora, CentOS, RHEL, … $ yum install httpie +.. code-block:: bash + # Arch Linux $ pacman -S httpie @@ -107,20 +111,6 @@ and always provides the latest version) is to use `pip`_: ``easy_install httpie`` as a fallback.) -Development version -------------------- - -The latest development version can be installed directly from GitHub: - -.. code-block:: bash - - # Mac OS X via Homebrew - $ brew install httpie --HEAD - - # Universal - $ pip install --upgrade https://github.com/jkbrzt/httpie/archive/master.tar.gz - - Python version -------------- @@ -132,6 +122,41 @@ Python 3 is the default for Homebrew installations starting with version 0.9.4. To see which version HTTPie uses, run ``http --debug``. +Unstable version +---------------- + +You can also instead of the latest the latest unreleased development version +directly from the ``master`` branch on GitHub. +It is a work-in-progress of a future stable release so the experience +might be not as smooth. + +|unix_build| |windows_build| + + +On macOS you can install it with Homebrew: + +.. code-block:: bash + + $ brew install httpie --HEAD + + +Otherwise with ``pip``: + +.. code-block:: bash + + $ pip install --upgrade https://github.com/jkbrzt/httpie/archive/master.tar.gz + + +Verify that now we have the +`current development version identifier `_ +with the ``-dev`` suffix, for example: + +.. code-block:: bash + + $ http --version + 1.0.0-dev + + Usage ===== @@ -258,7 +283,7 @@ and can be omitted from the argument – ``http example.org`` works just fine. Querystring parameters ---------------------- -If you find yourself manually constructing URLs with +If you find yourself manually constructing URLs with querystring parameters on the terminal, you may appreciate the ``param==value`` syntax for appending URL parameters. With that, you don't have to worry about escaping the ``&`` separators for your shell. Also, special characters in parameter values,