a2crd

Langue: en

Version: 330959 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

a2crd - attempts the conversion of lyrics file into chordii input

SYNOPSIS

a2crd [ options...] [ filename... ]

DESCRIPTION

a2crd reads the lyrics of one songs from a file, and attempts to produce a output suitable for chordii. Chord names can appear above or below the lyrics. a2crd will embed those names into the lyrics.

The FAQ list of alt.guitar documents the way a ascii file should look, but this format is not recognized by everyone, or fully enforced. Thus, it is impossible to modify chordii itself to read *any* type of ascii input and produce good result. a2crd tries its best to to do the tedious conversion job.

a2crd attempts to recognize mail/news headers, and comments them out. It preserves as is any line starting with a '{', which would indicates a chordii command. It also preserves any lines starting with a '#'.

a2crd prepends to the output the content of a file called $HOME/.a2crdsig, if it exists.

The first line that is not a comment is assumed to be the title of the song. The nest lines until a blank one are assumed to be sub-titles.

OPTIONS

-r ratio
Sets the threshold for chordii line recognition. a2crd looks at every line. If the ratio ( space_characters / (non-space_characters) is greater than ratio, the line will be recognized as a chordii line, and its content will be merge with the next available text line. The ratio has a initial value of 1. It is defined as a floating precision value.
-D
Prints debugging information. For programmers only.
-o filename
Sends output to filename
 

See Also

chordii(l)
Copyright 2008 The Chordii Project
Copyright 1992 by Martin Leclerc and Mario Dorion

AUTHORS

Martin Leclerc (martin.leclerc@canada.sun.com *** DEFUNCT ***)