Fix typos and improve readability of commands

documentation/src/install.rst

@@ -2,8 +2,8 @@ Installation
 ============
 
 Boxes.py is a pure Python project that does support the regular setuptools
-method of shipping with *setup.py*. *setup.py --help-commands* and
+method of shipping with :code:`setup.py`. :code:`setup.py --help-commands` and
-*setup.py CMD --help* provide the necessary documentation for building,
+:code:`setup.py CMD --help` provide the necessary documentation for building,
 installing or building binary formats.
 
 Requirements
@@ -12,74 +12,72 @@ Requirements
 Cairo
 .....
 Boxes.py is based on the cairo graphics library. It supports both the PyPi
-version *cairocffi* and python-cairo that might be shipped with your
+version :code:`cairocffi` and :code:`python-cairo` that might be shipped with
-distribution.
+your distribution.
 
 Markdown
 ........
-Markdown (package name may be python-markdown or python3-markdown) is
+:code:`Markdown` (package name may be :code:`python-markdown` or
-used to format the description texts.
+:code:`python3-markdown`) is used to format the description texts.
 
 LXML
 ....
 
-lxml (package name may be python-lxml or python3-lxml) is needed for
+:code:`lxml` (package name may be :code:`python-lxml` or :code:`python3-lxml`)
-the Inkscape plugin.
+is needed for the Inkscape plugin.
 
 setuptools
 ..........
 
-Setup.py uses the setuptools library (package name may be
+Setup.py uses the :code:`setuptools` library (package name may be
-python*-setuptools). You only need it if you want to build the
+:code:`python*-setuptools`). You only need it if you want to build the
 package.
 
-
-
 ps2edit
 .......
 
-While not a hard requirement Boxes.py uses ps2edit to offer formats that are
+While not a hard requirement Boxes.py uses :code:`ps2edit` to offer formats
-not supported by Cairo: DXF, gcode, PLT. Currently the location Boxes.py looks
+that are not supported by Cairo: DXF, gcode, PLT. Currently the location
-for *ps2edit* is hard coded to */usr/bin/pstoedit* in the
+Boxes.py looks for :code:`ps2edit` is hard coded to :code:`/usr/bin/pstoedit`
-*boxes.formats.Formats* class.
+in the :code:`boxes.formats.Formats` class.
 
 Python
 ......
 
-Boxes.py - while defaulting to Python3 - can also run on Python
+Boxes.py - while defaulting to Python 3 - can also run on Python 2.7.
-2.7. If you encounter any compatibility issues please report them at the
+If you encounter any compatibility issues please report them at the
 `GitHub project <https://github.com/florianfesti/boxes>`__.
 
 Running from working dir
 ------------------------
 
-Due to lazy developer(s) Boxes.py can also run from the git check
+Due to lazy developer(s) Boxes.py can also run from the Git checkout.
-out. The scripts in *scripts/* are all suppossed to just work right
+The scripts in :code:`scripts/` are all suppossed to just work right
-after *git clone*. The Inkscape needs a bit manual work to get
+after :code:`git clone`. The Inkscape needs a bit manual work to get
 running. See below.
 
 Inkscape
 --------
 
 Boxes.py can be used as a set of Inkscape plugins. The package does
-install the necessary .inx files to */usr/share/inkscape/extensions*
+install the necessary .inx files to :code:`/usr/share/inkscape/extensions`
-on unix operating systems. The .inx files assume that the *boxes*
+on unix operating systems. The .inx files assume that the :code:`boxes`
-executable is available in the path (which it is when installing the
+executable is available in the :code:`PATH` (which it is when installing the
-binary package)
+binary package).
 
-On non unix operating systems or when running Boxes.py from git
+On non-Unix operating systems or when running Boxes.py from Git
-checkout the .inx files need to be copied by hand. *setup.py build*
+checkout the .inx files need to be copied by hand. :code:`setup.py build`
-creares them in the *inkex/* directory. They then have to be copied in
+creates them in the :code:`inkex/` directory. They then have to be copied in
 either the global or the per user extension directory of
-Inkscape. These are */usr/share/inkscape/extensions/* and
+Inkscape. These are :code:`/usr/share/inkscape/extensions/` and
-*~/.config/inkscape/extensions/* on Unix. On other Operating systems
+:code:`~/.config/inkscape/extensions/` on Unix. On other operating systems
 you can look up *Edit -> Preferences... -> System* in the Inkscape
 menu to look up *User extensions* and *Inkscape extensions*. It may be
 more convenient to generate the .inx files right in place by executing
-*scripts/boxes2inkscape* with the taget path as only parameter.
+:code:`scripts/boxes2inkscape` with the target path as only parameter.
 
-After placing the .inx files you need to make the *boxes* script
+After placing the .inx files you need to make the :code:`boxes` script
-available in the path. One way is to create a symlink from a location
+available in the :code:`PATH`. One way is to create a symlink from a location
 that is in the path or installing the package on the system.
 
 Platform specific instructions