## (Note that lines beginning with '#' are treated as comments.  There is no
## need to strip them before sending in your entry)

## This file gives you three heavily annotated Musi-Cal submission
## templates, one for basic concert additions and two for the Concert
## Itinerary Slicer-Dicer.  For full details about the email interface, send
## a message to concerts@musi-cal.com with

##    help manual

## as the body.

########## Template #1: A simple add command ##########

add
      ## Note that performers are listed last name,first name and
      ## multiple performers are separated by '/' characters
      ## performer Carpenter,Mary-Chapin/Mavericks,The
    performer
      ## Select whatever types and keywords are appropriate.  The full list
      ## of valid types and keywords can be retrieved from the concerts mail
      ## alias by sending it a "help types" command
      ## type country,folk,rock
      ## keywords contemporary
    type
    keywords
      ## dates are pretty flexible.  Check the users guide for all the
      ## possibilities. 
      ## date 16 August 1995
    date
      ## where is she playing?
      ## venue Riverfront Amphitheatre
      ## city Little Rock
    venue
    city
      ## Make sure you get state/province abbreviations correct!  Otherwise
      ## Little Rock might wind up in Alaska!
      ## state AR
    state
      ## If the first "word" of the info field is a URL, it will be used as
      ## a link to further information.  (This is a hack, but it works for
      ## now.  Look for a better solution soon.)
      ## info http://www.music.sony.com/Music/ArtistInfo/MaryChapinCarpenter.html
    info
      ## Other possible fields include "program", "province", "country",
      ## "event" and "time".  Check the users guide for full details.
end

########## Template #2: Slicing and Dicing multiple gigs for one artist ##########

## The first Slicer-Dicer template assumes you have date, city, state, venue
## and phone for each gig and that the artist (Mary Hartman, a fictitious
## acoustic folkie) is playing a one-nighter at each spot on her midwest
## tour.

## The default command is where you identify the constant information and
## define the format of the lines to be converted.
default
      ## Most fields are the same as their counterparts in the "add"
      ## command.  Exceptions include the "pattern" field, and special
      ## fields for identifying different parts of the date.
    performer Hartman,Mary
    type folk
    keywords acoustic
    info http://www.automatrix.com/hartman/
      ## For details on describing the format of your data, send a "help
      ## patterns" command to the concerts mail alias
    pattern %{Smonth} %{sday} %{city}, %{st}, %{venue}, %{info}
end

## The raw data goes between "convert" and "end".  Nothing tricky here
## except the lines you want converted have to match the pattern given in
## the default command.  Making sure you haven't left out a comma or added
## an extra field in some lines can be tedious.  But it sure beats typing in
## all the "add" commands...
convert
    June 27 Toledo, OH, Buck's Cafe, (999)555-1212
    July 1  South Bend, IN, Strung Out Coffeehouse, (888)555-1212
    ...
end

########## Template #3: Slicing and Dicing multiple gigs for one venue ##########

## The last example is something you might use to submit events for a venue.
## The extra complication here is that each performer name has to be ordered
## properly, last name first for individuals (separated by commas) with '/'
## characters used to separate multiple performers.

default
    venue The Bluebird Cafe
    city Nashville
    state TN
    info http://www.hidwater.com/bluebird/bluebird.html
      ## Since venues often
      ## publish their itineraries month-by-month so you might get raw data
      ## that doesn't have months in it.  No problem! Just default the month
      ## name 
    Smonth August
      ## For details on describing the format of your data, send a "help
      ## patterns" command to the concerts mail alias
      ## Note that a comma is a bad terminator character for performer
      ## names.  Pick something that is not likely to appear in the input,
      ## like an equals sign.  Also, special characters for regular
      ## expressions are a very bad idea...
    pattern %{sday} %{performer}= %{type}
end

convert
    5 Nicholson,Gary= country
    6 Hengber,Liz= folk,country
    ...
end