Use the new section title style in Asciidoctor.
We previous use the section title style like:
Section level 1
===============
Section level 2
---------------
Which have a problem in Asciidoctor that the number of "="s or "-"s must match
the number of characters in the header exactly, as a result it's easy to make
mistakes while changing the titles. Asciidoctor provides a better style like:
= Section level 1
== Section level 2
So we switched to this style.
Also fixed a bug in replace_macros.py, which will not cause any problem in the
old style.
Change-Id: I811dd7238735d98f662767c17086152cd69aea02
diff --git a/Documentation/cmd-show-queue.txt b/Documentation/cmd-show-queue.txt
index bba82c3..e3f44ab 100644
--- a/Documentation/cmd-show-queue.txt
+++ b/Documentation/cmd-show-queue.txt
@@ -1,19 +1,15 @@
-gerrit show-queue
-=================
+= gerrit show-queue
-NAME
-----
+== NAME
gerrit show-queue - Display the background work queues, including replication
-SYNOPSIS
---------
+== SYNOPSIS
--
'ssh' -p <port> <host> 'gerrit show-queue'
'ssh' -p <port> <host> 'ps'
--
-DESCRIPTION
------------
+== DESCRIPTION
Presents a table of the pending activity the Gerrit daemon
is currently performing, or will perform in the near future.
Gerrit contains an internal scheduler, similar to cron, that it
@@ -23,8 +19,7 @@
once they enter this state, but it can be possible to observe tasks
in these states.
-ACCESS
-------
+== ACCESS
End-users may see a task in the queue only if they can also see
the project the task is associated with. Tasks operating on other
projects, or that do not have a specific project are hidden.
@@ -34,19 +29,16 @@
link:access-control.html#capability_viewQueue[the 'View Queue' capability]
can see all queue entries.
-SCRIPTING
----------
+== SCRIPTING
Intended for interactive use only.
-OPTIONS
--------
+== OPTIONS
--wide::
-w::
Do not format the output to the terminal width (default of
80 columns).
-DISPLAY
--------
+== DISPLAY
Task::
Unique task identifier on this server. May be passed into
@@ -71,8 +63,7 @@
Short text description of the task that will be performed
at the given time.
-EXAMPLES
---------
+== EXAMPLES
The following queue contains two tasks scheduled to replicate the
`tools/gerrit.git` project to two different remote systems, `dst1`