[Buildroot] [PATCH] manual: use one-line titles instead of two-line titles (trivial)

Yann E. MORIN yann.morin.1998 at free.fr
Fri May 2 10:43:51 UTC 2014


Thomas, All,

On 2014-05-02 07:47 +0200, Thomas De Schampheleire spake thusly:
> Asciidoc supports two syntaxes for section titles: two-line titles (title
> plus underline consisting of a particular symbol), and one-line titles
> (title prefixed with a specific number of = signs).
[--SNIP--]
> and the one-line title prefixes:
> = Document Title (level 0) =
> == Section title (level 1) ==
> === Section title (level 2) ===
> ==== Section title (level 3) ====
> ===== Section title (level 4) =====

Here you use both a prefix and a suffix...

> diff --git a/docs/manual/adding-packages-autotools.txt b/docs/manual/adding-packages-autotools.txt
> --- a/docs/manual/adding-packages-autotools.txt
> +++ b/docs/manual/adding-packages-autotools.txt
> @@ -1,13 +1,11 @@
>  // -*- mode:doc; -*-
>  // vim: set syntax=asciidoc:
>  
> -Infrastructure for autotools-based packages
> -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +=== Infrastructure for autotools-based packages

... but your script only added the prefix.

I just checked, and asciidoc does the right thing. The asciidoc site
itself is written with only the prefixes, and the doc says the suffix is
optional.

Yet, I found it weird that the commit log says one thing, but the patch
does it differently. I don't care either way, but it should have been
coherent.

Regards,
Yann E. MORIN.

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'



More information about the buildroot mailing list