.\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CHORD2HTML 1"
.TH CHORD2HTML 1 "2002-07-24" "Version 1.3" " "
.UC
.SH "NAME"
chord2html \- Convert \s-1CHORD\s0 files to \s-1HTML\s0
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
chord2html
[\fB\-d\fR \fIdirname\fR]
[\fB\-h\fR]
[\fB\-l\fR]
[\fB\-n\fR]
[\fB\-o\fR \fIfilename\fR]
[\fB\-q\fR]
[\fB\-s\fR \fIfilename\fR]
[\fB\-T\fR \fIformat\fR]
[\fB\-t\fR]
[\fB\-V\fR]
[\fB\-v\fR]
\&\fIinput_file\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBchord2html\fR converts \s-1CHORD\s0 input files (the .chopro files in \s-1OLGA\s0)
to \s-1HTML\s0 formatted files. The \s-1HTML\s0 files are similar to the PostScript
documents produced by \s-1CHORD\s0; chord2html reads a text file containing
the lyrics and chords of a song to produce a page with chord names above
the words and a graphical representation of the chords at the end of
the song.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-d\fR \fIdirname\fR" 4
.IX Item "-d dirname"
Set the directory where chord images will be stored. If the directory
doesn't exist, it will be created. The default is the current directory.
.IP "\fB\-h\fR" 4
.IX Item "-h"
Show a brief description of the available command line options.
.IP "\fB\-l\fR" 4
.IX Item "-l"
Print lyrics only.
.IP "\fB\-n\fR" 4
.IX Item "-n"
Don't overwrite chord image files that already exist.
.IP "\fB\-o\fR \fIfilename\fR" 4
.IX Item "-o filename"
Set the output filename. If not specified, the output will be written
in stdout.
.IP "\fB\-q\fR" 4
.IX Item "-q"
Quiet mode (don't print warnings).
.IP "\fB\-s\fR \fIfilename\fR" 4
.IX Item "-s filename"
Set a cascading style sheet file name. If not specified, \f(CW\*(C`chord2html.css\*(C'\fR
will be used.
.IP "\fB\-T\fR \fIformat\fR" 4
.IX Item "-T format"
Set the image format for the generated chord grids. Valid formats are
\&\fBgif\fR for Graphic Interchange Format (\s-1GIF\s0) images and \fBpng\fR for
Portable Network Graphics (\s-1PNG\s0) images. If not specified, \s-1PNG\s0 images
will be generated.
.IP "\fB\-t\fR" 4
.IX Item "-t"
Add a timestamp line at the end of the generated page.
.IP "\fB\-V\fR" 4
.IX Item "-V"
Print the version number and exit.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Run in verbose mode.
.SH "BUGS"
.IX Header "BUGS"
Multi-song chopro files are not correctly parsed.
.SH "NOTES"
.IX Header "NOTES"
The \s-1HTML\s0 file generated by chord2html uses tables to align chord names
and words using proportional fonts, so it will not work with text
browsers that don't handle tables (it works fine with recent versions
of lynx).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\s-1CHORD\s0 3.5 documentation. \s-1CHORD\s0 is available at
\&\f(CW\*(C`http://www.harmony\-central.com/Software/Unix/chord.tar.Z\*(C'\fR
.SH "AUTHOR"
.IX Header "AUTHOR"
Claudio Matsuoka <claudio@helllabs.org>, improved by
Per Egil Kummervold <peregil@abex.no> and
Erwin Burgstaller <i@wuell.net>.