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/config-project-config.txt b/Documentation/config-project-config.txt
index 3267c45..e86cdae 100644
--- a/Documentation/config-project-config.txt
+++ b/Documentation/config-project-config.txt
@@ -1,5 +1,4 @@
-Gerrit Code Review - Project Configuration File Format
-======================================================
+= Gerrit Code Review - Project Configuration File Format
This page explains the storage format of Gerrit's project configuration
and access control models.
@@ -10,8 +9,7 @@
relevant in an automation scenario of the access controls.
-The +refs/meta/config+ namespace
---------------------------------
+== The +refs/meta/config+ namespace
The namespace contains three different files that play different
roles in the permission model. With read permission to that reference,
@@ -24,8 +22,7 @@
[[file-project_config]]
-The file +project.config+
--------------------------
+== The file +project.config+
The +project.config+ file contains the link between groups and their
permitted actions on reference patterns in this project and any projects
@@ -75,8 +72,7 @@
[[project-section]]
-Project section
-~~~~~~~~~~~~~~~
+=== Project section
The project section includes configuration of project settings.
@@ -86,8 +82,7 @@
[[receive-section]]
-Receive section
-~~~~~~~~~~~~~~~
+=== Receive section
The receive section includes configuration of project-specific
receive settings:
@@ -135,8 +130,7 @@
Common unit suffixes of k, m, or g are supported.
[[submit-section]]
-Submit section
-~~~~~~~~~~~~~~
+=== Submit section
The submit section includes configuration of project-specific
submit settings:
@@ -152,8 +146,7 @@
[[access-section]]
-Access section
-~~~~~~~~~~~~~~
+=== Access section
Each +access+ section includes a reference and access rights connected
to groups. Each group listed must exist in the link:#file-groups[+groups+ file].
@@ -164,8 +157,7 @@
[[capability-section]]
-Capability section
-~~~~~~~~~~~~~~~~~~
+=== Capability section
The +capability+ section only appears once, and only in the +All-Projects+
repository. It controls Gerrit administration capabilities that are configured
@@ -177,8 +169,7 @@
[[file-groups]]
-The file +groups+
------------------
+== The file +groups+
Each group in this list is linked with its UUID so that renaming of
groups is possible without having to rewrite every +groups+ file
@@ -209,8 +200,7 @@
[[file-rules_pl]]
-The file +rules.pl+
--------------------
+== The file +rules.pl+
The +rules.pl+ files allows you to replace or amend the default Prolog
rules that control e.g. what conditions need to be fulfilled for a
