.noflags accept
.lm 1
.rm 75
.i-1;1 Chord
.br
chord - format lyrics and chord file
.br
.i-1;2 Usage
.br
To make the Chord utility available to your login session, you must first
either issue the command:
.bl
.i+5;SETUP CHORD
.bl
at the VMS $ prompt, or add the following line to your LOGIN.COM file:
.bl
.i+5;$ SETUP CHORD /QUIET
.br
.i-1;2 Synopsis
.br
chord [-option ...] [ filename... ]
.br
.i-1;2 Description
.br
chord produces a postscript document from a lyrics file containing chord
indications and chorus delimiters. If no file name is supplied, 
chordreads from the standard input.
The document produced contains the lyrics of a song, with the guitar chords
appearing above the right words. A representation of all chords used in the
song is printed at the bottom of the last page.
.br
.i-1;2 Options
.br
-c chord_font size
.bl
Sets the size, in points, of the font used to display chords to the specified
integer value.
.bl
-C Chord_font
.bl
Sets the font used to print chords to the specified name. That name must be
known to your PostScript Interpreter.
.bl
-d
.bl
Dumps the list and description of all internally known chords.
.bl
-D
.bl
Prints debugging information. For programmers only.
.bl
-h
.bl
Prints a short options summary.
.bl
-l
.bl
Prints only the lyrics of the song.
.bl
.bl
-t text_font size
.bl
Sets the size, in points, of the font used to display the lyrics to the
specified integer value. The title
line is displayed using that point size + 5. The sub-tiltle is displayed
using that point size -2.
.bl
-T Text_font
.bl
Sets the font used to print text to the specified name. That name must be
known to your PostScript Interpreter.
.bl
-2
.bl
Prints two logical pages per physical page.
.bl
-4
.bl
Prints four logical pages per physical page.
.br
.i-1;2 Keywords
.br
A line starting with a '#' is interpreted as a comment, and generates no output.
(although all your comments are automatically mailed to the authors, and we read them
at parties...)
.bl
Directives that  appear between french brackets ('{' and '}') have a
special meaning. They must be alone on a line. Blanks before the
opening bracket and after the closing bracket are not significant.
.bl
Blanks inside a directive are significant.
.bl
Known directives are:
.bl
start_of_chorus or soc
.bl
which indicates the start of a chorus (yep). The complete chorus will
be highlighted by a change bar, to be easily located by the player.
.bl
end_of_chorus or eoc
.bl
marks the end of the chorus
.bl
comment: or c:
.bl
will call the printing of the rest of the line, highlighted by a grey box
(Useful to call a chorus, for example)
.bl
new_song or ns
.bl
marks the beginning of a new song. It enables you to put multiple songs
in one file. It is not required at the beginning of the file.
.bl
title: or t:
.bl
specifies the title of the song. It will appear centered at the top of the first
page, and at the bottom of every other page, accompanied there by the
page number, within the current song.
.bl
subtitle: or t:
.bl
specifies a string to be printed right below the title. Many subtitles can be
specified
.bl
define: name offset str1 ... str6
.bl
defines a new chord called "name", starting at fret "offset".
The following numbers
are the fret number [ 1 to n ] for each string [str1 to str6]
and are RELATIVE to the offset.  A value of -1 as 
the fret number on string X means that string X is to be buffed,
or silenced. This will be reprensented by
and "x" appearing on the corresponding string.
The strings are numbered in ascending order of tonality, starting on the
low E (the top string).
.bl
At the beginning of every song, the default chords are loaded and the ~/.chordrc
file is re-read. Definition of new chords are preserved for the remainder of the
execution, or until redefined by the user.
.bl
textfont: postscript_font
same as -T command option
.bl
textsize: n
same as -t command option
.bl
chordfont: postscript_font
same as -C command option
.bl
chordsize: n
same as -c command option
.br
.i-1;2 Copyright
.br
Copyright 1992 by Martin Leclerc and Mario Dorion
.br
.i-1;2 Authors
.br
Martin Leclerc
.br
(martin.lecl...@canada.sun.com)
.bl
Mario Dorion
.br
(mario.dor...@canada.sun.com)
.bl
Jim Gerland (VMS port)
.br
(gerl...@ubvms.cc.buffalo.edu)
.br

