%%%%% rcsid = @(#)$Id: sb-manpg.tex,v 1.10 1999/11/14 21:27:09 crath Exp $
%%%%%
%%
%%      sb-manpg.tex - SongBook docs in UNIX man page form.
%%
%%      Version 3.1, 13 November, 1999
%%
%%      Copyright 1992--99 Christopher Rath <crath@cyberus.ca>
%%
%%      You may distribute under the terms of the Artistic License,
%%      as specified in the relnotes.txt file.
%%
%%      In order to format this file you need the ``Unix `man' macros
%%      for LaTeX'' written by Paul Barton-Davis <pauld@cs.washington.edu>.
%%      Version 1.2, June 1991, of unixman.sty was used to produce
%%      this version of sb-manpg.tex.
%%
%%%%%
%%%%%

\documentstyle[11pt]{unixman}

\setlength{\descriptionwidth}{.5 true in}
\setlength{\headheight}{3ex}
\def\met#1{\emph{#1}}
\def\meta#1{{$<$\emph{#1}$>$}}
\def\URL#1{\texttt{#1}}
\gdef\[{\char'133}
\gdef\]{\char'135}

\begin{document}

%\version{3.0}{1 January, 1998}
\version{3.1}{13 November, 1999}
\header{songbook}{1L}[\LaTeX\ styles]

\section{NAME}

songbook (chordbk, wordbk, overhead) -- \LaTeX\ document style to produce songbooks

\section{SYNOPSIS}

{\tt
\bs documentstyle[12pt]\{book\}\\
\bs usepackage\{`chordbk'\pipe `wordbk'\pipe `overhead'\}

\bs begin\{document\}\\
\bs begin\{song\}\{\met{title}\}\ldots\met{other options}\ldots

\hbox to 2cm{\hfil \vdots \hfil}
\bs end\{song\}\\
\bs end\{document\}
}

\section{DESCRIPTION}
The \this\ document style provides a core set of functions for the
production of songbooks.  Three pre-defined songbook formats are
provided (and they are invoked via the \B\bs usepackage\{\} command):
\begin{description}
 \item[\file{chordbk.sty}\ ] a songbook suitable for guitarists which
  gives both lyrics and words (this is the default mode of the \this\ 
  document style);

 \item[\file{wordbk.sty}\ ] a words only songbook suitable for mass
  distribution to those singing along;

 \item[\file{overhead.sty}\ ] to produce overhead transparencies from
  songbook source files.
\end{description}

The \this\ document style is based upon \LaTeX's familiar \B book
document style.  Unsurprisingly, the \this\ document style produces
familiar looking output.  This is one of the \this\ style's strengths.

\section{WHAT'S NEW}
What's new in version~3.1:
\begin{itemize}
 \item removed dependance upon twocolumn.sty; this isn't required in
  \LaTeX2e

 \item added an optional first parameter to \textbf{\bs SBEnd} and
  \textbf{\bs SBIntro} which causes the introduction or the ending to
  be printed in words only mode as well as in chord mode

 \item added the three environments that had been documented on the
  man page didn't appear in the \file{songbook.sty} file (I ran out of
  time when implementing the changes for version~3.0, and then forgot
  to remove the descriptions from the man page): \textbf{SBSection*},
  \textbf{SBVerse*} and \textbf{SBChorus*}.  The definition for the
  \textbf{SBVerse*} environment was supplied by Herbert Martin Dietze
  $<$herbert@fh-wedel.de$>$; and this formed a model for the other two

 \item corrected definition of \textbf{\bs SBBracketTagFont} in
  \file{overhead.sty}
\end{itemize}

What's new in version~3.0 (this list is probably not a complete list
of changes):
\begin{itemize}
 \item The \B song, \B SBVerse, \B SBChorus, and \B SBSection
  environments, and the \B \bs STitle macro, all set either \B\bs
  leftmark or \B\bs rightmark.  I've also added a macro to make it
  easy to place a ``\emph{Some title} cont...'' string in the page
  header.
  
 \item The \B song environment now handles empty copyright and W\&M
  parameters in a special fashion: if either of these parameters is
  left empty, then the string ``Unknown'' is put in place.  Also, if
  \B\bs SBPubDom is passed to the copyright paramter, then the
  copyright mark (i.e., $\copyright$) is omitted.

 \item The \B\bs Ch macro has been completely re-written.  The
  significant change is that a new command automatically draws a rule
  when the chord is bigger than the syllable.  What would previously
  have been written as ``\bs Ch\{A\}\{one\bs SBen\}\bs
  Ch\{D\}\{two\}'' is now written as ``\bs Chr\{A\}\{one\}\bs
  Ch\{D\}\{two\}''.  The old deprecated macros, \B\bs Ch and \B\bs
  ChX, are available as \B\bs oCh and \B\bs oChX, respectively.

 \item The new \B\bs Ch maros now raise the chord a specified height
  above the text; rather than relying upon a \B\bs strut to determine
  the height.  The new default raise amount is less than before.  See
  the \B\bs Ch entry, below for instructions on setting the raise
  height to match version 1.x and 2.x releases of the \this\ macros.

 \item All the \B\bs if constructs that had been defined (and used)
  within the \this\ style are now superceded with properly defined
  elements (created using \textbf{\bs newif}).  All the old \B\bs if
  stuff works as it used to\ldots this is a pure enhancement only.
  However, the \this\ style itself makes exclusive use of the new
  elements.

 \item The font used for chords (as defined by \textbf{\bs ChFont})
  has been changed to a bold, compressed, sans serif font, cmssbc12.
  Hence, although the chords themselves take up a slightly smaller bit
  of space on the page, they are much more readable.  As well, square
  brackets are now typeset using the \B\bs ChBkFont macro.
\end{itemize}


\section{COMMANDS}
This section is broken into several subsections.  Hopefully this makes
the individual commands easier to understand by placing them in a
meaningful context.  Since some forward references exist, it may be
necessary to read through the entire \emph{COMMANDS\/} section a
couple of times before it makes complete sense.


\subsection{Environments}
The \this\ style defines several new environments to make the
formatting of songbooks easier and more consistent (and most of them
have parameters).  Unless otherwise noted, all of the environments are
\textbf{verse}-like: wrapped lines are indented more than the first
line.

\begin{description}
 \item[\bs begin\{SBBracket\}\{\met{bracket tag\/}\}\met{\ldots stuff
    to bracket\ldots}\bs end\{SBBracket\}\ ] is the environment used
  to mark a given line of the song with a tag and bracket.  An example
  usage is to mark the line of the song played to end the piece, if it
  is somehow different than the chords played if one were to repeat
  the song.  For example:
  \begin{example}
   \begin{verbatim}
         Be\Ch{Am}{cause} of \Ch{Dm7}{what} the...
      \end{SBChorus}

      \begin{SBBracket}{Ending}
         Give \Ch{F}{thanks,}\Ch{C/F}{} \Ch{Bb/F}{}...
      \end{SBBracket}
   \end{verbatim}
  \end{example}
  This is very similar to the \B SBOccurs environment, the difference
  being how the section of the song is marked.

  There are two versions of this environment: \B SBBracket and
  \textbf{SBBracket*}.  They operate identically, except that the
  \textbf{*}'ed version doesn't print its tag and bracket in words
  only modes.  Note: as of version 3.1, \textbf{SBBracket*} is still
  missing from the style (a placeholder exists which doesn't function
  as intended).

  At present, \B\bs SBBracket is fragile and is not compatible with
  \textbf{SBVerse}, \textbf{SBChorus}, or any other environment; with
  the exception of the \B song environment.

 \item[\bs begin\{SBChorus\}\met{\ldots the chorus\ldots}\bs
  end\{SBChorus\}\ ] is the environment to wrap around a chorus that
  you wish to be indented and given a chorus tag (``Ch:'').  A song
  with one verse and one chorus, where the chorus is sung after the
  verse would probably use the \B SBChorus environment.  Whereas, if
  the chorus was sung first, an \B SBVerse environment would probably
  be used.  The indent amount for lines that are too long is set with
  the \B\bs HangAmt command.

  The \B SBChorus* version of this command indents but does not place
  a \B\bs SBChorusTag before the chorus.

 \item[\bs begin\{SBExtraKeys\}\{\met{song content}\}\bs
  end\{SBExtraKeys\}\ ] is the environment used when you wish to list
  the song again in another key.  Typically, this environment is used
  along with an \B\bs STitle command.  For example:
  \begin{example}
   \begin{verbatim}
      \begin{SBExtraKeys}{
         \STitle{You Alone}{D}

         \begin{SBVerse}
            \Ch{D}{Ho}\Ch{F#m}{ly,} \Ch{G}{Ho}\Ch{D}{ly,}
            ...
         \end{SBVerse}
      }\end{SBExtraKeys}
   \end{verbatim}
  \end{example}

 \item[\bs begin\{SBOccurs\}\{\met{the occurrence\/}\}\met{\ldots
    stuff to group\ldots}\bs end\{SBOccurs\}\ ] is the environment
  used to mark a given line of the song with a tag and brackets.  For
  example "1,3" would designate that this passage applies to the 1st
  and 3rd occurances.  For example:
  \begin{example}
    \begin{verbatim}
         Be\Ch{Am}{cause} of \Ch{Dm7}{what} the...
      \end{SBChorus}

      \begin{SBOccurs}{1,3}
         Give \Ch{F}{thanks,}\Ch{C/F}{} \Ch{Bb/F}{}...
      \end{SBOccurs}
    \end{verbatim}
  \end{example}

 \item[\bs begin\{SBSection\}\emph{\ldots the section\ldots}\bs
  end\{SBSection\}\ ] very much like LaTeX's verse environment, except
  that here the sections are numbered.  The indent amount for lines
  that are too long is set with the \B\bs HangAmt command.  This
  environment would be used in place of the \B\bs SBVerse environment
  for songs which are broken into pieces/sections, in place of, or in
  addition to, verses.  The indent amount for lines that are too long
  is set with the \B\bs HangAmt command

  The \B SBSection* version of this command indents but doesn't place
  an \textbf{\bs SBSectionCnt} before the chorus.  Similar to \LaTeX's
  \textbf{\bs section*} command, the section counter is not
  incremented either.

 \item[\bs begin\{SBVerse\}\emph{\ldots the chorus\ldots}\bs
  end\{SBVerse\}\ ] is the environment to wrap around a verse that you
  wish to be indented and given a verse number (\textbf{\bs
    SBVerseCnt}).  A song with one chorus and one verse, where the
  verse is sung after the verse would probably use the \B SBChorus
  environment.  Whereas, if the chorus was sung first, an \B SBVerse
  environment would probably be used.  The indent amount for lines
  that are too long is set with the \B\bs HangAmt command.

  The \textbf{SBVerse*} version of this environment indents but down
  not place an \B\bs SBVerseCnt before the chorus; similar to \LaTeX's
  \B\bs section* command, the verse counter is not incremented either.

 \item[\bs begin\{song\}\{\meta{1}\}\ldots\{\meta{6}\}\emph{\ldots the
    song\ldots}\bs end\{song\}\ ] is the environment which each song
  resides within.  The parameter list is quite long, and is defined
  as:
  \begin{enumerate}
   \item \ Song title;
   \item \ Key song is written in;
   \item \ Copyright information;
   \item \ Name(s) of composer and lyricist;
   \item \ Scripture reference for the song;
   \item \ Copyright licensing information.
  \end{enumerate}
  The \B song environment takes care of making index entries,
  incrementing \B\bs SBSong\-Cnt and page generation (if necessary).
  Note, this environment makes use of \textbf{\bs every\-par}.  See
  the \emph{EXAMPLE\/} section, below, for a sample one-song songbook
  document.

  When the ``copyright information'' or ``composer \& lyricist''
  parameters are left empty then the string defined by the \B\bs
  SBUnknownTag macro used (instead of leaving whitespace in the song
  header.

 \item[\bs begin\{xlatn\}\{\meta{1}\}\ldots\{\meta{3}\}\met{\ldots the
    translation\ldots}\bs end\{xlatn\}\ ] is the song translation
  environment.  The parameter list is defined as:
  \begin{enumerate}
   \item \ Translated song title (in the foreign language);
   \item \ Translation permission;
   \item \ Who performed the translation.
  \end{enumerate}
  The \B xlatn environment always occurs within a \B song environment;
  it resets the verse counter, causes the title and other parameter
  information to be displayed, and makes the appropriate index and
  table of contents entries.  It is important for the \B xlatn
  environment to occur within a song environment, because the \B xlatn
  environment inherits the song environment's \B\bs everypar
  definition.
\end{description}


\subsection{Primary \this\ Macros}
Along with the \this\ environments, these are the macros you will most
often use when constructing a songbook (of any style).

\begin{description}
 \item[\bs CBPageBrk\ ] forces a new page if \B\bs ifChordBk is true.

 \item[\bs Ch\{\met{chord\}}\{\met{syllable}\}\ ] the chord over
  lyrics command definition.  This is the most commonly used command
  in the \this\ style.  The words-only sub-style turns off the chord
  generation and just prints the second parameter.  The \I chord
  parameter is left-justified over the \I syllable parameter.  Any
  `\#' or `b' characters in the \I chord parameter are replaced with
  `$\sharp$' and '$\flat$' characters, respectively.  Also, if a bass
  note is specified in a chord (by way of a `/' character followed by
  the note) then it will appear in a smaller font than the rest of the
  \I chord.

  It is often desireable to typeset a chord---or set of
  chords---inside square brackets, to indicate that they are optional.
  A lighter weight font is probably desired, so that the brackets do
  not detract from the chord name, so any `[' and `]' characters are
  typeset with the font specified by the \B\bs ChBkFont macro.

  To set the chord raise amount to a value that matches version~1.x
  and~2.x releases of the \this\ style, insert the following command
  into the preamble of your document:
  \begin{example}
   \begin{verbatim}
     \renewcommand{\SBChordRaise}{\SBOldChordRaise}
   \end{verbatim}
  \end{example}

 \item[\bs Chr\{\met{chord\}}\{\met{syllable}\}\ ] this command
  performs the same function as the \B\bs Ch command with one
  exception: the \B\bs Chr command inserts a rule, at the height
  specified by the \B\bs SBRule\-Raise\-Amount macro, when the chord
  is wider than the syllable.  The default value creates an extended
  em-dash-like rule; a value of 0pt creates an underbar-like rule.
  See the \emph{USAGE GUIDELINES} section of this man page, below, for
  a more detailed explanation.

 \item[\bs ChX\{\met{chord\}}\{\met{syllable}\}\ ] this command
  performs the same function as the \B\bs Ch command with one
  exception: the \B\bs ChX command causes spaces trailing the command
  to be ignored.  See the \emph{USAGE GUIDELINES} section of this man
  page, below, for a more detailed explanation.

 \item[\bs makeKeyIndex\ ] start creation of an index of songs by key.

 \item[\bs makeTitleContents\ ] start creation of a table of contents.

 \item[\bs makeTitleIndex\ ] start creation of a title and first line
  index.

 \item[\bs NotWOPageBrk\ ] forces a new page if \B\bs ifWordsOnly is
  false.

 \item[\bs OHContPgHdr\ ] prints a page heading continuation header on
  overheads; this macro must be manually inserted where needed.  It is
  generally used in conjunction with the \B\bs OHPage\-Brk macro.
  \B\bs OHContPgHdr is a no-op, except when \B\bs ifOverhead is true.

\item[\bs OHPageBrk\ ] forces a new page if \B\bs ifOverhead is true.

 \item[\bs RchBk\ ] right square bracket (to place around an optional
  chord).  See the \B\bs LchBk macro description, above, for more
  detail.

 \item[\bs SBBridge\{\met{the bridge}\}\ ] is used to encapsulate a
  bridge: it causes \met{the bridge\/} to be set with \B\bs
  SBBridge\-Tag, using in the \B\bs SBBridge\-Tag\-Font font.  In
  words only mode this command is a no-op.

 \item[\bs SBEnd\[\met{use in words only}\]\{\met{the ending}\}\ ] is
  used to encapsulate a song ending: it causes \met{the ending\/} to
  be set with the \B\bs SBEndTag, using in the \B\bs SBEndTagFont
  font.  The first parameter is optional and if used is put in square
  brackets; specifying any value except `N' will cause the ending to
  be used in words only mode.  Some examples of its intended use are:
  \begin{example}
    \met{This will cause the ending to be printed in words only mode.  Note
    how the parameter is specified in square brackets!}
   \begin{verbatim}
      \SBEnd[Y]{Give \Ch{F}{thanks,} \ldots}
   \end{verbatim}

   \met{In this case the ending is a no-op in words only mode.}
   \begin{verbatim}
      \SBEnd{\Ch{A}{} \Ch{B/A}{} \Ch{D}{}}
   \end{verbatim}
  \end{example}

 \item[\bs SBIntro\[\met{use in words only}\]\{\met{the
    introduction}\}\ ] is used to encapsulate any introduction to a
  song: it causes \met{the introduction\/} to be set with an intro tag
  of ``Intro:'', using in the \B\bs SBIntroTagFont font.  The first
  parameter is optional and if used is put in square brackets;
  specifying any value except `N' will cause the ending to be used in
  words only mode.  Some examples of its intended use are:
  \begin{example}
    \met{This will cause the ending to be printed in words only mode.  Note
    how the parameter is specified in square brackets!}
   \begin{verbatim}
     \SBIntro[Y]{\Ch{D}{} \Ch{C}{} Ooooh}
   \end{verbatim}

   \met{In this case the ending is a no-op in words only mode.}
   \begin{verbatim}
     \SBIntro{{\SBLyricNoteFont Guitar and drums}}
   \end{verbatim}
  \end{example}

 \item[\bs SBMargNote\{\met{marginal note}\}\ ] is used to place a
  note of some kind in the margin of a songbook.  In words only mode
  this macro is a no-op.

 \item[\bs SBRef\{\met{book title\/}\}\{\met{page or song number}\}\ ]
  creates a reference in the margin to another music book, or tape.
  This provides a method for directing people to resources they may
  use to learn the song.  The marginal reference only prints when
  \B\bs WordsOnly is \B\bs False.

 \item[\bs SBem\ ] prints an \I em-space\footnote{I.e., an ``---''
    character.} when \B\bs WordsOnly is \B\bs False.  See \textbf{\bs
    SBen}.

 \item[\bs SBen\ ] prints an \I en-space\footnote{I.e., an ``--''
    character.} when \B\bs WordsOnly is \B\bs False.  This allows us
  to place a short rule within text in order place a chord earlier
  than a syllable; yet, that rule will not appear in the words-only
  book.  The words-only version of this macro is a no-op.  An example
  of its intended use is:
  \begin{example}
   \begin{verbatim}
      ...flows like a ri\Ch{B/A}{\SBen ver,} flows...
   \end{verbatim}
  \end{example}

 \item[\bs STitle\{\met{song title\/}\}\{\met{key\/}\}\ ] prints the
  \met{song title,} preceded by the current \B\bs SBSongCnt value and
  followed by the \met{key\/} the song is given in.  \B\bs STitle is
  most often used along with the \B SBExtraKeys environment.  This
  command resets the \B\bs SBVerse\-Cnt and \B\bs SBSection\-Cnt
  counters.

 \item[\bs WBPageBrk\ ] forces a new page if \B\bs ifWordBk is
  true.

 \item[\bs WOPageBrk\ ] forces a new page if \B\bs ifWordsOnly is
  true.
\end{description}


\subsection{Miscellaneous Commands}
Not all of the commands listed here are commonly used in songbooks
written using one of the \this\ styles.  The commands are listed
alphabetically.

\begin{description}
 \item[\bs CpyRt\{\met{copyright info.}\}\ ] prints the copyright
  information line.  This command is not usually explicitly used in a
  songbook.  It is called by the \B song environment and will normally
  only be used there.

 \item[\bs FLineIdx\{\met{first line\/}\}\ ] make an entry in the
  \emph{Title \& First Line Index\/} file, ``\file{\bs
    \emph{jobname}.tIdx}.''

 \item[\bs HangAmt\ ] is the amount to indent when a line wraps.  This
  has been defined using \B\bs newcom\-mand instead of \B\bs newlength
  so that any unit definitions are evaluated at the time the \B\bs
  HangAmt command is used.

 \item[\bs SBChorusMarkright\ ] hook to allow \textbf{\bs SBSection}'s
  \B\bs markright to be overridden.

 \item[\bs SBContinueMark\ ] conditionally produce a continuation
  symbol.  If the contents of \B\bs rightmark will result in nothing
  being typeset, then don't output the continuation mark; otherwise,
  output a continuation mark using the \B\bs SBContinueTag command.

 \item[\bs SBSectionMarkright\ ] hook to allow \textbf{\bs
    SBSection}'s \B\bs markright to be overridden.

 \item[\bs SBVerseMarkright\ ] hook to allow \textbf{\bs SBVerse}'s
  \B\bs markright to be overridden.

 \item[\bs SongMarkboth\ ] hook to allow the song environment's \B\bs
  markboth to be overridden.

 \item[\bs STitleMarkboth\ ] hook to allow \textbf{\bs STitle}'s \B\bs
  markboth to be overridden.

 \item[\bs ScriptRef\{\met{scripture address\/}\}\ ] is a scripture
  reference for the song.  This command has its name because the
  \this\ style was written to produce songbooks for the church I am
  part of.  This command is not usually explicitly used in a songbook.
  It is called by the \B song environment and will normally only be
  used there.

 \item[\bs WAndM\{\met{lyricist \& composer\/}\}\ ] prints a line
  telling who wrote the words and music for this song.  The string
  ``W\&M:'' precedes the listing of the \met{lyricist \& composer\/}
  when it is printed.  This command is not usually explicitly used in
  a songbook.  It is called by the \B song environment and will
  normally only be used there.
\end{description}


\subsection{Ifthen Commands}
These if tests are used to perform formatting that is dependent upon
the type of songbook you are creating.  It is these if tests which
allow a single source file to output the three songbook styles.
\begin{description}
 \item[\bs ifChordBk\ ] are we processing a \file{chordbk.sty}
  document?
 \item[\bs ifNotWordsOnly\ ] are we processing a document that
  displays chords?
 \item[\bs ifOverhead\ ] are we processing an \file{overhead.sty}
  document?
 \item[\bs ifSBinSongEnv\ ] are we inside of a song environment?  This
  is re-defined as we enter and exit the song environment.
 \item[\bs ifSamepageMode\ ] flag that indicates we want the \this\ 
  style to try and keep each song together on the same page.  Set this
  true or false using the \B\bs SamepageModetrue and \B\bs
  SamepageModefalse commands, respectively.
 \item[\bs ifSongEject\ ] do we want to end the current page at the
  end of every \B song environment?  A value of true means eject after
  every \B song environment (default value is true).  Set this true or
  false using the \B\bs SongEjecttrue and \B\bs SongEjectfalse commands,
  respectively.
 \item[\bs ifWordBk\ ] are we processing a \file{wordbk.sty} document?
 \item[\bs ifWordsOnly\ ] is true when we are in words only mode.  The
  default value will be false, as that is how all of the commands in
  this file will act.
\end{description}
       

\subsection{Counters}
These are the counters used in the various environments.  Although you
will generally not need to use them, they do sometimes come in handy;
hence, they have been documented here.
\begin{description}
 \item[\bs theSBSongCnt\ ] this counter is used for numbering the
  songs.  When a song is listed multiple times (for multiple keys) the
  songs number must remain the same each time.
 \item[\bs theSBSectionCnt\ ] the section counter is used for
  numbering sections as they occur within a song.
 \item[\bs theSBVerseCnt\ ] the verse counter is used for numbering
  verses as they occur within a song.
\end{description}
       

\subsection{Spacing Commands}
These commands define the amount of space to leave in various
situations.  Change their values via \LaTeX's \B\bs renewcommand
command.

All of these spaces are defined as \LaTeX\ commands to overcome
limitations in length evaluation.  For example, if \B\bs
LeftMarginSBVerse were to be defined as a length (i.e., using
\textbf{\bs newlength}) and then immediately set to \textbf{4em}'s,
the specific length would be evaluated with respect to the current
font.  This may not be what is desired; instead a length evaluated
with respect to the font in place at the start of an \B SBVerse is
probably what is desired.  This can only be done by making these
lengths \LaTeX\ commands.

\begin{description}
 \item[\bs HangAmt\ ] amount to indent when a line wraps.
 \item[\bs LeftMarginSBChorus\ ] is the amount of left margin to leave
  when the \B\bs SBChorus environment is in effect.
 \item[\bs LeftMarginSBSection\ ] is the amount of left margin to
  leave when the \B\bs SBSection environment is in effect.
 \item[\bs LeftMarginSBVerse\ ] is the amount of left margin to leave
  when the \B\bs SBVerse environment is in effect.
 \item[\bs SBChordRaise\ ] the distance to raise the chords above the
  baseline of the text they sit over.
 \item[\bs SBRuleRaiseAmount\ ] the distance to raise the rule (as
  specified by \textbf{\bs SBIntersyllableRule}) which fills the space
  between adjoining syllables.
 \item[\bs SpaceAboveSTitle\ ] is the amount of vertical space left by
  the \B\bs STitle command before it prints the song title line.
 \item[\bs SpaceAfterChorus\ ] is the vertical space to leave after an
  SBChorus.
 \item[\bs SpaceAfterSection\ ] is the vertical space to leave after
  an SBSection.
 \item[\bs SpaceAfterSong\ ] is the vertical space to leave after a
  song.
 \item[\bs SpaceAfterVerse\ ] is the vertical space to leave after an
  SBVerse.
\end{description}

It is worth noting that the \textbf{\bs SpaceAfterChorus}, \textbf{\bs
  SpaceAfterSection}, and \textbf{\bs Space\-After\-Verse} macros all
allow negative glue to be inserted; that is, the space may be shrunk
as well as expanded.  If this proves problematic (due to sections
being visibly pushed into each other, the old spacing (as in
versions~1.x and~2.x) can be restored by resetting these macros 
to 0ex.  For example:
\begin{example}
  \begin{verbatim}
    \renewcommand{\SpaceAfterChorus} {0ex\relax}
    \renewcommand{\SpaceAfterSection}{0ex\relax}
    \renewcommand{\SpaceAfterSong}   {0ex\relax}
    \renewcommand{\SpaceAfterVerse}  {0ex\relax}
  \end{verbatim}
\end{example}


\subsection{String Constants}
These constants are provided so that users may easily customize the
appearance of formatted songs and songbooks.  Use the \B\bs
renewcommand command to change the value of these constants.
\begin{description}
 \item[\bs SBBridgeTag\ ] the Bridge Tag to insert before the start of
  a bridge.  The default value for this is ``Bridge:''.
 \item[\bs SBChorusTag\ ] the Chorus Tag to insert before the first
  line of a chorus.  The default value for this is ``Ch:''.
 \item[\bs SBContinueTag\ ] the Continue Tag to insert in an
  \textbf{\bs SBContinueMark}.  The default value for this is
  ``cont\bs ldots''.
 \item[\bs SBEndTag\ ] the End Tag to insert before the start of an
  ending (in an \B\bs SBEnd command).  The default value for this is
  ``End:''.
 \item[\bs SBIntersyllableRule\ ] the command(s) to draw the rule
  between adjoining syllables.
 \item[\bs SBIntroTag\ ] the Intro Tag to insert before the start of
  an introduction (in an \B\bs SBIntro command).  The default value
  for this is ``Intro:''.
 \item[\bs SBPubDom\ ] the string to insert which indicates song is in
  the public domain.  The default value for this is ``Public Domain''.
 \item[\bs SBUnknownTag\ ] the WAndM string to insert when either the
  author/artist or the copyright holder is unknown.  The default value
  for this is ``Unknown''.
 \item[\bs SBWAndMTag\ ] the tag to insert before the words and music
  entry printed in the song header.  The default value for this is
  ``W\bs \&M:''.
\end{description}


\subsection{Font Handling}
Fonts are handled by way of \LaTeX\ commands.  This was done
specifically so that traditional \LaTeX\ font selection occurs; i.e.,
so that the font commands (like \textbf{\bs bf}, \textbf{\bs textbf},
and their friends) are interpreted within the context they are used,
rather than the context their are declared within.  Change these font
specifiers via \LaTeX's \B\bs renewcommand.

Of all the font selection \this\ macros, only one is commonly used by
someone writing a songbook: \textbf{\bs SBLyricNoteFont}.  All the
other font macros are only used by an author to over-ride default
behaviour, via the \B\bs renewcommand command.

\begin{description}
 \item[\bs ChBassFont\ ] sets the font for the bass note in chords as
  printed by the \textbf{\bs Ch}, \B\bs Chr and \B\bs ChX commands.

 \item[\bs ChFont\ ] sets the font for chords as printed by the
  \textbf{\bs Ch}, \textbf{\bs Chr}, and \B\bs ChX commands.

 \item[\bs ChBkFont\ ] sets the font for square brackets typeset
  inside \B\bs Ch commands (and its variants).

 \item[\bs CpyRtFont\ ] sets the font used to print the copyright line
  produced by the \B\bs CpyRt command.

 \item[\bs CpyRtInfoFont\ ] sets the font used to print the
  \emph{copyright licensing information\/} parameter of the \B song
  environment; which appears after the \met{copyright information}
  parameter under the \met{song title.}

 \item[\bs SBBracketTagFont\ ] sets the font used to create the tag
  for an \B SBBracket environment.

 \item[\bs SBChorusTagFont\ ] sets the font used to print the chorus
  tag, \textbf{\bs SBChorusTag}.
    
 \item[\bs SBDefaultFont\ ] sets the default font for the songbook.
  For this command to be effective it should appear within the
  songbook itself, directly following \B\bs begin\{document\}.

 \item[\bs SBIntroTagFont\ ] sets the font used to print the
  introduction tag, \textbf{\bs SBIntroTag}.
    
 \item[\bs SBLyricNoteFont\ ] sets the font used in comments placed
  within the lyrics giving musical direction.  This is the only font
  command commonly used by the writer of a songbook.  For example, to
  tag a line to be sung only by the Cantor and another by everyone,
  one would write:
  \begin{example}
    \begin{verbatim}
      {\SBLyricNoteFont (Cantor)} Give thanks to the Lord.

      {\SBLyricNoteFont (All)} His love endures forever.
    \end{verbatim}
  \end{example}

 \item[\bs SBOccursBrktFont\ ] sets the font used to create the large
  left and right square brackets which delimit an \B SBOccurs
  environment.

 \item[\bs SBOccursTagFont\ ] sets the font used to create the \B
  SBOccurs tag, \textbf{\bs SBOccursTag}.
  
 \item[\bs SBRefFont\ ] sets the font used in the marginal reference
  printed by the \B\bs SBRef command.

 \item[\bs SBVerseNumberFont\ ] sets the font used to print the \B\bs
  SBVerseCnt in front of verses in an \B SBVerse environment.

 \item[\bs SBSectionNumberFont\ ] sets the font used to print the
  \B\bs SBSectionCnt in front of sections in an \B SBSection
  environment.

 \item[\bs STitleFont\ ] sets the font used to print the song title,
  as generated by the \B\bs STitle command.

 \item[\bs STitleKeyFont\ ] sets the font used to print the key a song
  is written in, as generated by the \B\bs STitle command.

 \item[\bs STitleNumberFont\ ] sets the font used to print the \B\bs
  SBSongCnt in front of the song title, as generated by the \B\bs
  STitle command.

 \item[\bs ScriptRefFont\ ] sets the font used to print the scripture
  reference generated by the \B\bs ScriptRef command.

 \item[\bs WandMFont\ ] sets the font used to print the lyricist and
  composer line generated by the \B\bs WandM command.
\end{description}


\subsection{Deprecated Commands}
The following commands will be discontinued in some future release of
the \this\ style:
\begin{description}
 \item[\bs ChordBk\ ] is set to \B\bs True if we're producing words
  and chord books.  Set to \B\bs False, otherwise.  Superceded by the
  \B\bs ifChordBk if.

 \item[\bs False\ ] is a constant used in \TeX\ \B\bs if expressions.
  This command is now unnecessary.

 \item[\bs lyricNoteFont\ ] the old command to set the font for a
  note.  This is now an alias for the \B\bs SB\-Lyric\-Note\-Font
  command.

 \item[\bs oCh\{\met{chord\}}\{\met{syllable}\}\ ] the \B\bs Ch
  command as defined in versions of the \this\ style prior to~v3.0.
  Replaced with a new \B\bs Ch command.

 \item[\bs oChX\{\met{chord\}}\{\met{syllable}\}\ ] the \B\bs ChX
  command as defined in versions of the \this\ style prior to~v3.0.
  Replaced with a new \B\bs ChX command.

 \item[\bs Overhead\ ] is set to \B\bs True if we're producing
  overhead transparencies.  Set to \B\bs False, otherwise.  Superceded
  by the \B\bs ifOverhead if.

 \item[\bs SBinSongEnv\ ] is a flag indicating whether or not we are
  inside a song environment.  It is re-defined as we enter and exit
  the \B song environment.  Superceded by the \B\bs ifSBinSongEnv if.

 \item[\bs SongEject\ ] is a flag indicating whether or not the \B\bs
  song environment should end the current page when the environment
  ends: \B\bs True means end the page when the \B\bs song environment
  ends; \B\bs False means don't end the page.  Superceded by the \B\bs
  ifSongEject if.

 \item[\bs True\ ] is a constant used in \TeX\ \B\bs if expressions.
  This command is now unnecessary.

 \item[\bs WordBk\ ] is the flag which tells us whether we're
  producing a songbook with just words that is not a set of overhead
  masters.  Superceded by the \B\bs ifWordBk if.

 \item[\bs WordsOnly\ ] is the flag which tells us whether we're
  producing a songbook with just words, or set of overhead masters.
  Superceded by the \B\bs ifWordsOnly if.
\end{description}


\section{USAGE GUIDELINES}
This section gives some guidelines for use of the commands and
environments offered by the \this\ style.  These are not absolute
standards, merely the suggestions that I have come up with after
entering some 300 songs into a \this\ style based songbook.  These
guidelines rarely justify themselves, try things out and decide for
yourself whether they're right or wrong.
\begin{enumerate}
 \item Make each line of a song its own paragraph.  This means that
  the songbook file is mostly double spaced.  This allows the file to
  more easily survive encounters with users who edit the songbook
  source using a non-text-editor, such as WordPerfect.
 \item Use of the \B\bs Ch command:
  \begin{itemize}
   \item Always try to attach a chord to a single syllable.  If you
    need to include more than one syllable with the chord then include
    extra text in units of syllables (whenever possible).  For
    example:
    \begin{description}
     \item[\textsf{Do:}] \texttt{\bs Ch\{G\}\{Halle\}luia}
     \item[\textsf{Don't:}] \texttt{\bs Ch\{G\}\{Hall\}eluia}
    \end{description}
   \item Always include punctuation along with a syllable that has
    been included in a \B\bs Ch command.  For example:
    \begin{description}
     \item[\textsf{Do:}] \texttt{\bs Ch\{G\}\{Lord!\}}
     \item[\textsf{Don't:}] \texttt{\bs Ch\{G\}\{Lord\}!}
    \end{description}
   \item Only place a single chord within a \B\bs Ch command.  For
    example:
    \begin{description}
     \item[\textsf{Do:}] \texttt{\bs Ch\{\[\}\{\}\bs Ch\{G\}\{\} \bs
        Ch\{D\}\{\}\bs Ch\{\]\}\{\}}
     \item[\textsf{Don't:}] \texttt{\bs Ch\{\[G D\]\}\{\}}
    \end{description}
   \item Every line \emph{must} contain at least one \B\bs Ch command;
    even if it's an empty one.  For example:
    \begin{description}
     \item[\textsf{Do:}] \texttt{Behold your God!\bs Ch\{\}\{\}}
     \item[\textsf{Don't:}] \texttt{Behold your God!}
    \end{description}
  \end{itemize}

 \item Extension of syllables.  Syllables may be extended at either/or
  both ends.  Each end should be done in a different way:
  \begin{enumerate}
   \item One usually needs to make a syllable longer because the chord
    it is tied to is too long.  This type of extension should be done
    using the \B\bs Chr command.
    \begin{description}
     \item[\textsf{Do:}] \texttt{\bs Chr\{G\#m7/C\}\{Ho\}\bs
        Ch\{C\}\{ly\}}
     \item[\textsf{Don't:}] \texttt{\bs Ch\{G\#m7/C\}\{Ho\bs SBem\}\bs
        Ch\{C\}\{ly\}}
    \end{description}
   \item Extending the beginning (i.e., delaying the start) of a
    syllable is generally required because the chord change needs to
    occur \emph{between syllables.} For example, when the chord change
    is on the beat and the syllable is sung off-beat.  Use \B\bs SBen
    and \B\bs SBem for this purpose.
    \begin{description}
     \item[\textsf{Do:}] \texttt{none Ho\bs Ch\{D\}\{\bs SBen ly\}}
    \end{description}
  \end{enumerate}

 \item Typographic conventions.  \LaTeX\ knows about certain
  ligatures; that is, it groups certain sequences of letters into a
  single character unit.  \T ff is one of these ligatures and is
  typeset in a special way; however this cannot occur if the f's are
  split by a \B\bs Ch command.  Therefore, if at all possible, never
  split up the following character sequences with the \B\bs Ch
  command: \texttt{ff, fi, ffi, fl, ffl}.
  \begin{description}
   \item[\textsf{Do:}] \texttt{\bs Ch\{C\}\{diffi\}cult}
   \item[\textsf{Don't:}] \texttt{\bs Ch\{C\}\{dif\}ficult}
  \end{description}

 \item Ordering of songs in the songbook.  In order to allow \LaTeX\ 
  to fill pages in as natural a manner as possible, it is best to
  order the songs within the songbook based upon a \B wordbk formatted
  songbook.  In that way, the words-only songbooks will contain
  optimally filled columns.  Start by placing the longest songs first,
  only inserting shorter songs to cause page breaks at logical
  intervals.

 \item Overheads that occupy more than one page.  When in overhead
  mode, if a song spills over onto a second page (or beyond), it is
  helpful to print an extra header at the top of the page identifying
  which song the extra page belongs to.  This is accomplished with the
  \B\bs OHContPgHdr macro.  For example, one would insert the
  following lines where the new page is to occur:
  \begin{example}
    \begin{verbatim}
      \OHPageBrk
      \OHContPgHdr
    \end{verbatim}
  \end{example}
\end{enumerate}


\section{INDEX/TOC GENERATION}
The \this\ style provides facilities for title/first line index, song
key index and table of contents generation.  While this facility is
not yet completely developed, it is much better than it was in earlier
releases, and it produces \emph{very} usable output!

\subsection{Table of Contents Generation}
Steps to follow in order to produce a table of contents:
\begin{enumerate}
 \item Add a \B\bs makeTitleContents command to the preamble of your
  songbook.
 \item Run \LaTeX\ on the songbook source.
 \item Make your own copy of \file{sampleToc.tex} and customize its
  header and footer definitions (so they match your songbook's).  Then
  change the name of the file being \textbf{\bs input}'ed to match
  your table of contents file.
 \item Run \LaTeX\ on your copy of \file{sampleToc.tex}.
\end{enumerate}

\subsection{Title \& First Line Index Generation}
Steps to follow in order to produce a title and first line index:
\begin{enumerate}
 \item Add a \B\bs makeTitleIndex command to the preamble of your
  songbook.
 \item Run \LaTeX\ on the songbook source.
 \item Run the \prog{./mksbtdx} shell script on the \file{.tIdx} file
  that was produced by the previous step.  Do this by typing ``\T
  mksbtdx \I jobname'' at a UNIX command line.  For example, the index
  file for \file{sample-sb.tex} was produced by typing
  ``\texttt{mksbtdx sample-sb}''.
 \item Make your own copy of \file{sampleTdx.tex} and customize its
  header and footer definitions (so they match your songbook's).  Then
  change the name of the file being \textbf{\bs input}'ed to match
  your index file.  (\prog{./mksbtdx} told you this file's name).
 \item Run \LaTeX\ on your copy of \file{sampleTdx.tex}.
\end{enumerate}

\subsection{Song Key Index Generation}
Steps to follow in order to produce a song key index:
\begin{enumerate}
 \item Add a \B\bs makeKeyIndex command to the preamble of your
  songbook.
 \item Run \LaTeX\ on the songbook source.
 \item Run the \prog{./mksbkdx} shell script on the \file{.kIdx} file
  that was produced by the previous step.  Do this by typing ``\T
  mksbkdx \I jobname'' at a UNIX command line.  For example, the key
  index file for \file{sample-sb.tex} was produced by typing
  ``\texttt{mksbkdx sample-sb}''.
 \item Make your own copy of \file{sampleKdx.tex} and customize its
  header and footer definitions (so they match your songbook's).  Then
  change the name of the file being \textbf{\bs input}'ed to match
  your index file. (\prog{./mksbkdx} told you this file's name).
 \item Run \LaTeX\ on your copy of \file{sampleKdx.tex}.
\end{enumerate}


\section{EXAMPLE}
Here is an example songbook; where the the songbook contains exactly
one song.
{\small\begin{verbatim}
\documentstyle[12pt,chordbk]{book}     %% Songsheet with chords.

%%%
% C.C.L.I. license number definition; for copyright licensing info.
%%%
\newcommand{\CCLInumber}{\#999999}
\newcommand{\CCLIed}{(CCLI \CCLInumber)}
\newcommand{\NotCCLIed}{}
\newcommand{\PGranted}{}
\newcommand{\PPending}{(Permission Pending)}

%%%
% Turn on index and table of contents.
%%%
\makeTitleIndex         %% Title and First Line Index.
\makeTitleContents      %% Table of Contents.
\makeKeyIndex           %% Song Key Index.

\begin{document}

%%%
% Font selection for document's default font.
%%%
\SBDefaultFont

%%%
% Songbook begins.
%%%
\begin{song}{What A Mighty God We Serve}{C}
  {Public Domain}
  {Unknown}
  {Isaiah 9:6}
  {\NotCCLIed}

  \SBRef{Hosanna! Music Book~I}{\#93}

  \Ch{C#}{What} a mighty God we serve,

  What a mighty God we \Ch{G7}{serve},

  \Ch{Cb}{An}gels bow before Him,

  \Ch{C}{Hea}ven and earth adore Him,

  \Ch{C}{What} a mighty \Ch{G7}{God} we \Ch{C}{serve!}\Ch{[}{}\Ch{F}{}
  \Ch{C}{}\Ch{]}{}

  \begin{SBVerse}
    O \Ch{C}{Zion,} O \Ch{F}{Zion,} that \Ch{G7}{bring}est good
    \Ch{C}{tid}ings,

    Get thee \Ch{F}{up} into the \Ch{G7}{High} Moun\Ch{C}{tains}

    Je\Ch{C}{ru}salem, Je\Ch{F}{ru}salem, that \Ch{G7}{bring}est good
    \Ch{C}{tid}ings

    Lift up thy \Ch{F}{voice} with \Ch{G7}{all} thy \Ch{C}{strength}

    Lift it \Ch{F}{up,} be not afraid;

    Lift it \Ch{C}{up,} be not afraid

    Say \Ch{Am}{unto} the \Ch{C}{ci}ties of \Ch{G7}{Judah,}

    ``Behold your \Ch{C}{God,}\Ch{C7}{} Behold your \Ch{F}{God,}

    Be\Ch{C}{hold} \Ch{G7}{your} \Ch{C}{God!''}
  \end{SBVerse}

 \begin{SBExtraKeys}{
  \CBPageBrk
  \STitle{What A Mighty God We Serve}{D}

  \Ch{Eb}{What} a mighty God we serve,

  What a mighty God we \Ch{A7}{serve},

  \Ch{C#}{An}gels bow before Him,

  \Ch{D}{Hea}ven and earth adore Him,

  \Ch{D}{What} a mighty \Ch{A7}{God} we \Ch{D}{serve!}\Ch{[}{}\Ch{G}{}
  \Ch{D}{}\Ch{]}{}

  \begin{SBVerse}
    O \Ch{D}{Zion,} O \Ch{G}{Zion,} that \Ch{A7}{bring}est good
    \Ch{D}{tid}ings,

    Get thee \Ch{G}{up} into the \Ch{A7}{High} Moun\Ch{D}{tains}

    Je\Ch{D}{ru}salem, Je\Ch{G}{ru}salem, that \Ch{A7}{bring}est good
    \Ch{D}{tid}ings

    Lift up thy \Ch{G}{voice} with \Ch{A7}{all} thy \Ch{D}{strength}

    Lift it \Ch{G}{up,} be not afraid;

    Lift it \Ch{D}{up,} be not afraid

    Say \Ch{Bm}{unto} the \Ch{D}{ci}ties of \Ch{A7}{Judah,}

    ``Behold your \Ch{D}{God,}\Ch{D7}{} Behold your \Ch{G}{God,}

    Be\Ch{D}{hold} \Ch{A7}{your} \Ch{D}{God!''}
  \end{SBVerse}
 }\end{SBExtraKeys}
\end{song}
\end{document}
\bye
\end{verbatim}}


\section{DEPENDENCIES}
The \this\ style is dependent upon two other \LaTeX\ styles:
\file{conditional.sty} and \file{if\-then.sty}.
\file{Conditional.sty} is supplied with this package, and
\file{ifthen.sty} is part of the \LaTeX2e distribution.

Embedding chords within a songbook can be accomplished with the
\file{texchord.sty} package; which is supplied in the contrib
directory of the \this\ distribution.


\section{FILES}
\begin{filelist}
  \fileref{chordbk.sty} Words and chords substyle.
  \fileref{conditionals.sty} Donald Arseneau's conditional tests.
  \fileref{mksbkdx} A shell script around makeindex to sort the song
    key index.
  \fileref{mksbtdx} A shell script around makeindex to sort the
    title \& first line index.
  \fileref{overhead.sty} Overhead transparency substyle.
  \fileref{relnotes.txt} The \this\ package release notes.
  \fileref{sample-sb.tex} A sample songbook.
  \fileref{sampleKdx.tex} Song key index for the sample songbook.
  \fileref{sampleTdx.tex} Title \& first line index for the sample
  songbook.
  \fileref{sampleToc.tex} TOC for the sample songbook.
  \fileref{sb-manpg.tex} This manual page.
  \fileref{songbook.ist} The \this\ package makeindex \file{.ist} file.
  \fileref{songbook.sty} The base style file.
  \fileref{wordbk.sty} Words only substyle.
\end{filelist}

\section{SEE ALSO}
The \this\ homepage, at URL \URL{http://www.cyberus.ca/\tilde crath/Misc/Songbook/}\\
\command{latex}{1L}, \command{tex}{1L}, \command{makeindex}{1L}\\ 
\textit{The \TeX book,} by Donald Knuth\\
\textit{\LaTeX\ A Document Preparation System,} by Leslie Lamport


\subsection{Competing Packages}
There are a number of song and songbook formatting packages available
which attempt to provide similar functionality to the \this\ package
(although, IMHO, my package is better).  Similar \LaTeX packages (of
which the author is aware) include:
\begin{description}
 \item[chord.sty] Olivier Biot's (\URL{mailto:Olivier.Biot@rug.ac.be})
  song formatting package.  This package is based upon \LaTeX's
  article style and is available from Olivier's homepage, at URL
  \URL{http://studwww.rug.ac.be/\tilde obiot/}.
 \item[Song.sty] Jens T. Berger Thielemann's
  (\URL{mailto:jensthi@ifi.uio.no}) package to create songbooks.  This
  package is based upon \LaTeX's book style and is available from its
  author.  Jens' homepage can be found at URL
  \URL{http://www.ifi.uio.no/\tilde jensthi/}.
\end{description}


\section{BUGS}
In the specific case where a \textbf{\bs Ch}, \textbf{\bs Chr}, or
\B\bs ChX macro begins a paragraph, that line may not indent properly
in the \B chordbk substyle (specifically, a long, wrapped line won't
have its extra indentation).  I have been unable to identify the
reason for the problem, although it is easily reproducible.  The
work-around to this problem is to begin such lines with a \B\bs
mbox\{\} command; this inserts an empty (i.e., zero width) mbox at the
start of the line.  For example:
\begin{example}
  \begin{verbatim}
    \mbox{}\Ch{G}{Great} is the Lord \Ch{A}{even} beyond the 
      \Ch{D}{borders} of I\Chr{F#m}{srae}\Ch{Bm7}{l;}
  \end{verbatim}
\end{example}

Due to the recent change in the the \B\bs Ch macro (and its variants),
the \B\bs emph macro is no longer completely compatible with \B\bs Ch.
The specific problem is that sharps can not be specified via `\#'
within a \B\bs emph macro.  The following snippet will fail with the
\LaTeX\ message, ``\texttt{! Illegal parameter number in definition of
  \bs reserved@a.  $<$to be read again$>$}'':
\begin{example}
  \begin{verbatim}
    \emph{for the \Ch{G/A}{King} of} \Ch{F#}{kings.}}
  \end{verbatim}
\end{example}
The error message can be supressed by replacing `\#' with `\#\#',
however this results in a double-sharp being typeset.  The problem can
be worked-around by replacing the snippet with:
\begin{example}
  \begin{verbatim}
    \emph{for the \Ch{G/A}{King} of} \Ch{F#}{\emph{kings.}}
  \end{verbatim}
\end{example}


\section{SPECIAL THANKS}
Thanks to Donald Arseneau for writing the \file{conditionals.sty}
file, and for helping write the \B\bs Chord macro.  Donald, you are
one of the faithful who is always quick to reply with correct answers
to questions posted to \textbf{comp.text.tex}.  Thanks again.

Thanks also to Philip Hirschhorn whose \B\bs Chord macro I ultimately
used in versions~1.0--2.3 of the \this\ style, and to Olivier Boit who
constructed a similar chord macro which I used to enhance Philip's
code for version~3.0

A quick thank you to Herbert Martin Dietze $<$herbert@fh-wedel.de$>$
for noting that \textbf{SBVerse*} and its cousins were missing from
the \file{.sty} file, and then coding up an acceptable
\textbf{SBVerse*} which I could quickly use as a model for the other
two missing environments.

\section{AUTHOR}
Christopher Rath \hskip .5in \URL{mailto:crath@cyberus.ca} \hskip .5in (613)~824-4584\\
1371 Major Rd.
Orleans, ON\\
Canada \hskip .5cm K1E 1H3

\end{document}
\bye

% Local Variables:
%   LaTeX-item-indent:     -1
%   LaTeX-indent-level:     2
%   TeX-brace-indent-level: 2
%   TeX-auto-untabify:            nil
%   TeX-style-local:        style/
% End:
