home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / chord3_6.zip / chord / readme.os2 < prev    next >
Text File  |  2000-04-17  |  3KB  |  64 lines
  1.   This is the OS/2 port of a Unix utility called CHORD.
  2.  
  3.   The program CHORD  takes a text file as an argument, which contains the
  4. lyrics of  a  song with the chords  to  be played embedded into the text,
  5. and returns a  Postscript (TM) file which can be printed via a Postscript
  6. compatible printer, or viewed and printed by using Ghostview/Ghostscript.
  7.  
  8.   For a better description of CHORD, see the README file included.
  9.  
  10.   Obviously,  I  compiled the  program for US and A4 paper sizes,  so you
  11. don't have to build the project from scratch. I here include instructions
  12. for making  CHORD  just for completeness,  and to be useful if you'd like
  13. to hack the source code.
  14.  
  15.   In the OS/2 port  I used EMX 0.9d, and slightly modified the make file:
  16. substantially  I commented out some rules  (install section) and modified
  17. a  little the  clean section and  the  program names.  Now for making it:
  18. edit the makefile with any program you like ( I used emacs 19.29, but the
  19. little old TEDIT works as well) and select the paper size you want to use
  20. for printing sheets, by commenting/uncommenting the PAPERSIZE statement.
  21.  
  22.   Then, the only thing you have to do is 'make all': note that gnumake is
  23. necessary to make correctly.  If you have XFree86 /2, x11make.exe will do
  24. the job greatly.
  25.  
  26.  If you want, you can make the two versions (US and A4 paper size) simply
  27. following the subsequent scheme:
  28.  
  29. Select PAPERSIZE=A4 - make all - ren chord.exe chord_a4.exe
  30.  
  31. move chord_a4.exe in a safe directory
  32.  
  33. make clean - Select PAPERSIZE=US - make all - ren chord.exe chord_us.exe
  34.  
  35. move chord_us.exe and a2crd.exe in the same directory as chord_a4.exe
  36.  
  37. you're done now...
  38.  
  39.   Please apologize me for  not  having found  a better solution,  perhaps
  40. modifiying the  make file  to make all automagic: I'm actually not a real
  41. make file expert, so I preferred this low-level way.  Just a little thing
  42. to end: the last time I compiled it,  make refused to see the file toc.c.
  43.   If it does the same to you, it is simple  to compile the file (or other
  44. uncompiled source files)  separately,  and then make all again.  Luckily,
  45. this is a little program! :-)
  46.  
  47.   Chord is able to use the complete  ISO-8859-1  character set, which is
  48. used in Linux and many Unices: but on my Italian OS/2 release I had some
  49. problems with this character set, so  I include in the OS/2 distribution
  50. the Gnu recode programs, so if you aren't writing only English songs, or
  51. haven't got Linux to write chord source files, you can convert the files
  52. to make CHORD read 'em. Am I a good person or not? :-)))
  53.  
  54.  
  55.   I hope this port will be useful to all lazy musicians like I was! :-)
  56.  
  57. Sincerely,
  58.  
  59. Mentore Siesto
  60. Team OS/2 Italy
  61. Trying to keep the OS/2 way of life!
  62.  
  63. Oh, and by the way: obviously, chord is under the GPL, so read it...
  64.