ChordPro

============================================================
CHORDPRO SONG FILE FORMAT
============================================================

    Description: ChordPro songs contain lyrics, chords, and
                 directives, which are interleaved in the
                 same file. This format does not require
                 fancy space counting to get the chords and
                 lyrics to line up. That is done by the
                 display software doing what computers do
                 best: count.

                 Chords are designated with square brackets,
                 like this: [C], [C7dim], [C6sus], etc...

                 Directives are designated with curly braces,
                 like this: {comment:this is a comment},
                 {start_of_chorus}, {end_of_chorus}, etc...
                 All directives must be on their own line
                 and start in the first column.

                 HTML markup is allowed by ChordSheet, but
                 this is a non-standard extension to the
                 ChordPro format and may not work in other
                 programs.

                 ChordSheet supports multiline lyrics with a
                 non-standard HTML-like markup: <1>, <2>...

                 Lines that start with "#" will be ignored.

    Example:     {title:AMAZING GRACE}
                 {subtitle:John Newton (1715-1807)}
                 {comment:Verse 1}
                 [D]Amazing grace! [G]How sweet the [D]sound
                 That [D]saved a wretch like [A]me!
                 I [D]once was lost but [G]now I'm [D]found;
                 Was [Bm]blind, but [D]now [A]I [D]see.
                 {footer:Public Domain}

    --------------------------------------------------------
    {t:title string} or {title:title string}
    --------------------------------------------------------

    Description: Song title.

    Example:     {t:Amazing Grace}

    --------------------------------------------------------
    {su:subtitle string} or {subtitle:subtitle string}
    --------------------------------------------------------

    Description: Subtitle, often used for name of songwriter.

    Example:     {su:John Newton (1715-1807)}

    --------------------------------------------------------
    {soc} or {start_of_chorus}
    {eoc} or {end_of_chorus}
    --------------------------------------------------------

    Description: A chorus is bracketed with {soc} and {eoc}
                 directives

    Example:     {soc}
                 [G]This is a [C]one-line chorus
                 {eoc}

    --------------------------------------------------------                
    {c:comment string} or {comment:comment string}
    --------------------------------------------------------

    Description: Comment that is displayed with the song.
                 Often used for verse and vocal directions.

    Example:     {c:Verse 1}
                 [C]This is the first line of the first verse

    --------------------------------------------------------
    {sot} or {start_of_tab}
    {eot} or {end_of_tab}
    --------------------------------------------------------

    Description: Guitar tablature is bracketed with {sot}
                 and {eot} directives. The guitar tabs
                 are optional and can be hidden with an
                 option menu setting.

    Example:     {sot}
                 e||--------------------------------
                 B||-------------------0---0--------
                 G||------0-0--------0---0---2-0----
                 D||--0-2-----2-0--0----------------
                 A||--------------------------------
                 E||--------------------------------
                 {eot}

    --------------------------------------------------------
    {gc:guitar comment} or {guitar_comment:guitar comment}
    --------------------------------------------------------

    Description: Guitar comment that is displayed with guitar
                 tablature. These comments will be hidden if
                 guitar tabs are hidden.

    Example:     {gc: Play in key of E with capo on 1st fret}

    --------------------------------------------------------
    {k:key} or {key:key}
    --------------------------------------------------------

    Description: This defines what key the song is written in.

    Example:     {k:C}

    --------------------------------------------------------
    {f:footer string} or {footer:footer string}
    --------------------------------------------------------

    Description: This footer is displayed at the bottom of
                 the page. It can be used for copyright or
                 other information.

    Example:     {f:Copyright 1970}

    --------------------------------------------------------
    <i>italic</i> <b>bold</b> <u>underline</u>
    --------------------------------------------------------

    Description: Character formatting HTML markup syntax
                 is supported, but this is a non-standard
                 enhancement to the ChordPro format and may

    Example:     <i>italic</i> <b>bold</b> <u>underline</u>

    --------------------------------------------------------
    <1>, <2>, <3>, ...
    --------------------------------------------------------

    Description: Multiline lyrics are supported through a
                 non-standard enhancement to the ChordPro
                 format with the following HTML-like syntax,
                 but this may not work in other programs.

    Example:     [C]First<2>Second [G]<1>line.<2>verse.

    Display:     C      G
                 First  line
                 Second verse