Fix broken synopsis formatting in documentation
Most of the cmd-xxxx.txt pages were still using the legacy 'italics'
asciidoc [1], which caused the synopsis sections to render like this:
'ssh' -p <port> 'gerrit some-command'
Furthermore, the line breaks and indentations were not rendered.
Replaced the legacy 'italics" with _italics_ in all synopsis sections
and changed the block type to [verse]. Verse blocks preserve indents
and line breaks (like <pre> in HTML), but still allow text formatting.
Fixed also some other minor mistakes and formatting errors.
[1] http://asciidoctor.org/docs/migration/#migration-cheatsheet
Change-Id: I457c5e42e3758789f29541d38d6f6c2e25532897
Signed-off-by: Michael Ochmann <michael.ochmann@sap.com>
diff --git a/Documentation/cmd-apropos.txt b/Documentation/cmd-apropos.txt
index 8882af18..d03e63f 100644
--- a/Documentation/cmd-apropos.txt
+++ b/Documentation/cmd-apropos.txt
@@ -4,8 +4,9 @@
gerrit apropos - Search Gerrit documentation index
== SYNOPSIS
+[verse]
--
-'ssh' -p <port> <host> 'gerrit apropos'
+_ssh_ -p <port> <host> _gerrit apropos_
<query>
--
@@ -23,8 +24,9 @@
== EXAMPLES
-=====
+----
$ ssh -p 29418 review.example.com gerrit apropos capabilities
+
Gerrit Code Review - /config/ REST API:
http://localhost:8080/Documentation/rest-api-config.html
@@ -45,7 +47,7 @@
Gerrit Code Review - /access/ REST API:
http://localhost:8080/Documentation/rest-api-access.html
-=====
+----
== SEE ALSO
