Improve formatting of build commands

dev/building.rst

@@ -94,41 +94,48 @@ Subcommands and Options
 
 The following ``build.go`` subcommands and options exist.
 
--  ``go run build.go install`` -- installs binaries in ``./bin``
+``go run build.go install``
-   (default command, this is what happens when build.go is run without
+  Installs binaries in ``./bin`` (default command, this is what happens when
-   any commands or parameters).
+  build.go is run without any commands or parameters).
 
--  ``go run build.go build`` -- forces a rebuild of the binary to the
+``go run build.go build``
-   current directory; similar to ``install`` but slower.
+  Forces a rebuild of the binary to the current directory; similar to
+  ``install`` but slower.
 
--  ``go run build.go clean`` -- remove build artefacts, guaranteeing a
+``go run build.go clean``
-   complete rebuild. Use this when switching between normal builds and
+  Removes build artefacts, guaranteeing a complete rebuild. Use this when
-   noupgrade builds.
+  switching between normal builds and noupgrade builds.
 
--  ``go run build.go test`` -- run the tests.
+``go run build.go test``
+  Runs the tests.
 
--  ``go run build.go tar`` -- create a Syncthing tar.gz dist file in the
+``go run build.go tar``
-   current directory. Assumes a Unixy build.
+  Creates a Syncthing tar.gz dist file in the current directory. Assumes a
+  Unixy build.
 
--  ``go run build.go zip`` -- create a Syncthing zip dist file in the
+``go run build.go zip``
-   current directory. Assumes a Windows build.
+  Creates a Syncthing zip dist file in the current directory. Assumes a
+  Windows build.
 
--  ``go run build.go  assets`` -- rebuild the compiled-in GUI assets.
+``go run build.go assets``
+  Rebuilds the compiled-in GUI assets.
 
--  ``go run build.go  deps`` -- update the in-repo dependencies.
+``go run build.go deps``
+  Updates the in-repo dependencies.
 
--  ``go run build.go  xdr`` -- regenerate the XDR en/decoders. Only
+``go run build.go xdr``
-   necessary when the protocol has changed.
+  Regenerates the XDR en/decoders. Only necessary when the protocol has
+  changed.
 
 The options ``-no-upgrade``, ``-goos`` and ``-goarch`` can be given to
 influence ``install``, ``build``, ``tar`` and ``zip``. Examples:
 
--  ``go run build.go -goos linux -goarch 386 tar`` -- build a tar.gz
+``go run build.go -goos linux -goarch 386 tar``
-   distribution of Syncthing for linux-386.
+  Builds a tar.gz distribution of Syncthing for linux-386.
 
--  ``go run build.go -goos windows -no-upgrade zip`` -- build a zip
+``go run build.go -goos windows -no-upgrade zip``
-   distribution of Syncthing for Windows (current architecture) with
+  Builds a zip distribution of Syncthing for Windows (current architecture) with
-   upgrading disabled.
+  upgrading disabled.
 
 .. note:: Building for a different operating system or architecture than your native one requires Go having been set up for cross compilation. The easiest way to get this right is to use the official Docker image, described below.
 
@@ -146,9 +153,9 @@ If you are building something that will be installed as a package
 (Debian, RPM, ...) you almost certainly want to use ``-no-upgrade`` as
 well to prevent the built in upgrade system from being activated.
 
--  ``go run build.go -version v0.10.26 -no-upgrade tar`` -- build a
+``go run build.go -version v0.10.26 -no-upgrade tar``
-   tar.gz distribution of syncthing for the current OS/arch, tagged as
+  Builds a tar.gz distribution of syncthing for the current OS/arch, tagged as
-   ``v0.10.26``, with upgrades disabled.
+  ``v0.10.26``, with upgrades disabled.
 
 .. _building-with-docker: