home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / chord3_6.zip / chord / README < prev    next >
Text File  |  1995-04-25  |  6KB  |  164 lines
  1. This is a description of a utility called CHORD.
  2.  
  3. It's purpose is to provide guitar players with a tool to produce good
  4. looking, self-descriptive music sheet from a text file.
  5.  
  6. CHORD read a text file containing the lyrics of a song, the chords to
  7. be played, their description and some other optional data to produce a
  8. PostScript document that includes:
  9.  
  10.     Centered titles
  11.     Chord names above the words
  12.     Graphical representation of the chords at the end of the songs
  13.  
  14. CHORD also provides support for 
  15.  
  16.     Multiple columns on a page
  17.     Index of a songbook
  18.     Multiple logical pages per physical pages ( 1, 2 or 4)
  19.     Configurable fonts for the lyrics and the chord names
  20.     Multiple songs inside one file
  21.     The complete ISO 8859-1 character set
  22. and
  23.     Chorus marking
  24.  
  25. The authors spent a great deal of
  26. time making it as feature-full and usable as possible. If you like this
  27. program, please take the time to send a postcard from your home town or
  28. locality to each of the two authors and let them know what you think of
  29. CHORD. Please send the cards to the following addresses:
  30.  
  31.     Martin Leclerc        Mario Dorion
  32.     19 Browning        18 Georgia Crescent
  33.     Dollard des Ormeaux    Pointe Claire
  34.     Quebec, H9G 2K5        Quebec, H9R 5V7
  35.     CANADA            CANADA
  36.  
  37. NEW IN VERSION 3.6
  38.  
  39. o Song index is sorted
  40. o .chordrc is read only once per execution
  41. o Speed improvement by a factor of ~5
  42. o support of multiple columns
  43. o better (I hope...) support of A4 format
  44. o inclusion of a2crd to convert ASCII files to chord format
  45. o Chords defined multiples times ALL stay in the known chord structure, so
  46. that 'chord -D' shows them all, even if the names are duplicates.
  47. o bug fixes
  48.  
  49. NEW IN VERSION 3.5
  50.  
  51. o Generation of PostScript indexes.
  52. o Generation of PostScript chord-charts.
  53. o Additional 'comments' style (box and italic).
  54. o Directive to set a monospace font (ie: not-proportional) suitable for
  55.   tabs.
  56. o Support for A4 paper format.
  57. o Page numbers are now "physical page numbers".
  58. o Chord-charts (-dump option) now include chords from .chordrc file.
  59. o Option to print/not-print page numbers.
  60. o Option to print/not-print chord grids.
  61. o Option to print grids only for "difficult" chords.
  62. o Directive to force a physical page break.
  63. o Directive to force a virtual page break.
  64. o Chords are printed in a logical order.
  65. o Special chord [N.C.] (no-chord) without a chord grid.
  66. o New (and improved!) {define} syntax.
  67. o Chord names and directives are case-insensitive.
  68. o Public domain getopt() routine (for portability).
  69. o (almost) lint free (better portability)
  70. o Ansi-C compliant
  71. o ... and bug fixes
  72.  
  73. NEW IN VERSION 1.2
  74.  
  75. o More flexible Page Numbering
  76.   o Left/right
  77.   o always-present
  78.   o an option for simgle spacing on lines with no chords
  79. o Distinction between an unplayed string and a buffed one
  80. o TOC generation
  81. o Some bug fixes
  82.  
  83. NEW IN VERSION 1.1
  84.  
  85. o CHORD supports transposition. See the man page.
  86. o miscellanious bug fixes, including dubious coding that kept IBM and
  87.   SGI from executing CHORD properly
  88. o the grids now indicate string played open
  89. o Error messages noe correctly report the name of the file and
  90.   the line number where the error was found
  91.  
  92. ===== PLATFORM =====
  93.  
  94. CHORD has been developped on SPARCStations running Solaris 2.2 and
  95. OpenWindows 3.2. The PostScript previewer (PageView), SparcPrinters and
  96. LaserWriter II have had no problem with the output. Please report any
  97. changes your system requires.
  98.  
  99. Known port include VMS, DOS, U*IX, AMIGA-DOS.
  100.  
  101. ===== CREDITS =====
  102.  
  103. CHORD has been developped and is still being maintained by Martin
  104. Leclerc and Mario Dorion. 
  105.  
  106. CHORD uses the GNU getopt() routine made available to the community by
  107. the Free Software Foundation.
  108.  
  109. We would like to thanks the following individuals:
  110.  
  111. Steve Putz, who has kindly contributed a number of suggestions, bug
  112. fixes and enhancements(?).
  113.  
  114. Jim Gerland (GERLAND@ubvms.cc.buffalo.edu), who has performed the initial
  115. VMS port.
  116.  
  117. Leo Bicknell (ab147@freenet.acsu.buffalo.edu) has provided the chord sorting
  118. routine.
  119.  
  120. Additional thanks to Fred handloser (and his pal Duncan) and many
  121. others for providing many suggestions of features that were implemented
  122. in CHORD 3.5.
  123.  
  124.  
  125. ===== COMPILING =====
  126.  
  127. CHORD is written in fairly portable C and should work on most UNIX
  128. systems with little or no change. Let us know of your problems.
  129.  
  130. Simply edit the Makefile to meet your environment and 'make'.
  131.  
  132. Note: If your environment does not offer a getopt() routine edit the
  133. Makefile to de-comment the lines (INCL, SRC and OBJ) that mention the
  134. included getopt routine ... We reccomend using your system's getopt()
  135. if it is available.
  136.  
  137.  
  138. ===== ARCHIVES =====
  139.  
  140. The offical chord archive is maintained generously by Jan-Erik Schuch (f91-jsc@nada.kth.se)
  141.  
  142. Check out the web page http://www.nada.kth.se/~f91-jsc/ 
  143.  
  144. Another great source is ftp://ftp.nevada.edu or http://www.nevada.edu
  145.  
  146. ===== COPYRIGHT =====
  147.  
  148. CHORD is licensed following the conditions of the
  149. general GNU license. You are authorized to use this program free of
  150. charge. You are authorized to distribute this program freely as long as
  151. the full source is included. You are not allowed to remove the
  152. `copyright' notices from the authors nor are you allowed to pretend you
  153. wrote it. You are not allowed to charge any money for CHORD. You are
  154. not allowed to distribute a modified version of CHORD without written
  155. authorizations from the authors. You are not allowed to use parts of
  156. CHORD in any other commercial or public-domain software. Sorry for all
  157. the negatives rules ... but we've been bitten once!
  158.  
  159.  
  160.  
  161.  
  162. Martin Leclerc (Martin.Leclerc@canada.sun.com)
  163. Mario Dorion   (Mario.Dorion@canada.sun.com)    
  164.