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-review.txt b/Documentation/cmd-review.txt
index a37efb0..510edce 100644
--- a/Documentation/cmd-review.txt
+++ b/Documentation/cmd-review.txt
@@ -1,12 +1,10 @@
gerrit review
==============
-NAME
-----
+== NAME
gerrit review - Verify, approve and/or submit one or more patch sets
-SYNOPSIS
---------
+== SYNOPSIS
--
'ssh' -p <port> <host> 'gerrit review'
[--project <PROJECT> | -p <PROJECT>]
@@ -22,8 +20,7 @@
{COMMIT | CHANGEID,PATCHSET}...
--
-DESCRIPTION
------------
+== DESCRIPTION
Updates the current user's approval status of the specified patch
sets and/or submits them for merging, sending out email
notifications and updating the database.
@@ -40,8 +37,7 @@
branch.
-OPTIONS
--------
+== OPTIONS
--project::
-p::
@@ -113,16 +109,13 @@
or invalid value) and votes that are not permitted for the user are
silently ignored.
-ACCESS
-------
+== ACCESS
Any user who has configured an SSH key.
-SCRIPTING
----------
+== SCRIPTING
This command is intended to be used in scripts.
-EXAMPLES
---------
+== EXAMPLES
Approve the change with commit c0ff33 as "Verified +1"
=====
@@ -157,8 +150,7 @@
$ ssh -p 29418 review.example.com gerrit review --abandon c0ff33
====
-SEE ALSO
---------
+== SEE ALSO
* link:access-control.html[Access Controls]
