home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / chord3_6.zip / chord / a2crd.txt < prev    next >
Text File  |  1995-04-25  |  2KB  |  61 lines
  1. a2crd(l)          Misc. Reference Manual Pages           a2crd(l)
  2.  
  3.  
  4.  
  5. NAME
  6.      a2crd - attempts the conversion of lyrics  file  into  chord
  7.      input
  8.  
  9. SYNOPSIS
  10.      a2crd [ options...] [ filename... ]
  11.  
  12. DESCRIPTION
  13.      a2crd reads the  lyrics  of  one  songs  from  a  file,  and
  14.      attempts to produce a output suitable for chord. Chord names
  15.      can appear above or below  the  lyrics.   a2crd  will  embed
  16.      those names into the lyrics.
  17.  
  18.      The FAQ list of alt.guitar documents the way  a  ascii  file
  19.      should  look, but this format is not recognized by everyone,
  20.      or fully enforced. Thus, it is impossible  to  modify  chord
  21.      itself  to  read  *any* type of ascii input and produce good
  22.      result. a2crd tries its best to to do the tedious conversion
  23.      job.
  24.  
  25.      a2crd attempts to recognize mail/news headers, and  comments
  26.      them  out.  It preserves as is any line starting with a '{',
  27.      which would indicates a chord command. It also preserves any
  28.      lines starting with a '#'.
  29.  
  30.      a2crd prepends to the output the content of  a  file  called
  31.      $HOME/.a2crdsig, if it exists.
  32.  
  33.      The first line that is not a comment is assumed  to  be  the
  34.      title  of  the  song.  The  nest lines until a blank one are
  35.      assumed to be sub-titles.
  36.  
  37.  
  38. OPTIONS
  39.      -r ratio
  40.              Sets the threshold for chord line recognition. a2crd
  41.              looks at every line. If the ratio ( space_characters
  42.              / (non-space_characters) is greater than ratio,  the
  43.              line  will  be  recognized  as a chord line, and its
  44.              content will be merge with the next  available  text
  45.              line.  The  ratio  has  a  initial value of 1. It is
  46.              defined as a floating precision value.
  47.  
  48.      -D       Prints debugging information. For programmers only.
  49.  
  50.      -o filename
  51.              Sends output to filename
  52.  
  53.      chord(l)
  54.  
  55. COPYRIGHT
  56.      Copyright 1992 by Martin Leclerc and Mario Dorion
  57.  
  58.  
  59. AUTHORS
  60.      Martin Leclerc (martin.leclerc@canada.sun.com)
  61.