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
This commit is contained in:
Yuxuan 'fishy' Wang
2013-12-20 12:55:51 -08:00
parent 9dc9639d30
commit 61698b14e0
131 changed files with 1330 additions and 2659 deletions

View File

@@ -1,5 +1,4 @@
not valid ref
=============
= not valid ref
With this error message Gerrit rejects to push a commit if the target
ref in the push specification has an incorrect format (for example:
@@ -10,8 +9,7 @@ specification. Depending on whether you want to push your commit with
or without code review the ref format is different:
ref format for pushing a commit for code review:
------------------------------------------------
== ref format for pushing a commit for code review:
If it was the intention to push a commit for code review the target
ref in the push specification must be the project's magical ref
@@ -26,8 +24,7 @@ $ git push ssh://JohnDoe@host:29418/myProject HEAD:refs/for/master
----
ref format for directly pushing a commit (without code review):
---------------------------------------------------------------
== ref format for directly pushing a commit (without code review):
If it was the intention to bypass code review and to push directly to
a branch the target ref in the push specification must be the name of