home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume13 / casette-lbl / README < prev   
Text File  |  1988-01-31  |  4KB  |  102 lines
  1. Cassette label formatting programs:
  2.     Build these with
  3.     % make
  4.     and install with
  5.     % make install
  6.     
  7.     Dimensions, fonts, and other tweakable parameters are in dimensions.h.
  8.     This was developed under UNIX 4.2 but ought to port to System V and
  9.     other flavors easily.  Possible porting considerations are:
  10.     bcopy() -- memcpy() (or something) in System V.
  11.     fgets() -- reads line up to AND INCLUDING newline.
  12.     perror() -- prints diagnostic error message for system calls.
  13.     
  14.     Happy listening!
  15.  
  16. Cassette:
  17.     Cassette takes as input files describing the title, artist, and songs
  18.     on the sides of a cassette tape, and sends a PostScript(TM) description
  19.     of a cassette label suitable for sending to a high-resolution printer
  20.     (such as a laserprinter) to the standard output.  The resulting label
  21.     may be inserted into a standard-issue cassette tape case.
  22.  
  23.     The input file format is the following:
  24.     One file for each album (collection of artist, title, and songs).
  25.     The first line of each file is the artist, the second is the title,
  26.     the third is the noise reduction scheme used, and the songs are
  27.     listed one-per-line thereafter.
  28.  
  29.     An empty title line signifies a self-titled album.
  30.     An empty noise-reduction line indicates no noise reduction used.
  31.     An empty song line divides songs on the first side of the tape
  32.     from those on the second side (a la two-record set).
  33.  
  34.     Leading and trailing white space on any line is not significant.
  35.  
  36.     The cassette program copes with:
  37.     1) Extra-long artist, title, and song names.
  38.     2) Recognizing Dolby(TM) B and C (and outputting the Dolby symbol).
  39.     3) Long song list -- outputs an extended label outline.
  40.     4) Self-titled albums
  41.     5) One side of a tape unused.
  42.     And much, much more.
  43.  
  44.     Syntax:
  45.     cassette [-n]  <album1 file>  [<album2 file>]
  46.  
  47.     The '-n' option triggers numbering of the songs.
  48.  
  49. Printlabels:
  50.     Printlabels is a simplistic bourne-shell script that takes the output
  51.     of cassette (above) and surrounds it with PostScript(TM) commands to
  52.     orient the output for more efficient printing on an 8 1/2 by 11 page.
  53.     The output of Printlabels is sent to the standard output.
  54.     Four non-extended labels or two extended ones can fit on a page, and
  55.     page-feeds are inserted every four labels automatically.
  56.  
  57.     Syntax:
  58.     printlabels [-a] [-m]  <label file>  [<label file>...]
  59.  
  60.     The '-a' option places the labels adjacent to one another
  61.     for easier paper cutting.
  62.  
  63.     The '-m' option enables manual feeding of the printer (for
  64.     thick paper and such).
  65.  
  66. Known Bugs:
  67.     On a single tape side, titles and artists longer than about
  68.     80 characters or songlists longer than about 20 songs overflow
  69.     the available room.
  70.  
  71.     The manual-feed option to 'printlabels' might only work on the
  72.     Apple Laserwriter Plus(TM).
  73.  
  74.     If an album has a long song list that requires an extended area to
  75.     hold it, the label must be printed with 'printlabels', or the
  76.     label definition must be offset into the page.
  77.  
  78.     'Printlabels' automatically fits four labels to a page even if the
  79.     labels have an extension area (and thus won't fit).
  80.  
  81.     The '-a' and '-m' flags may not be reversed in order on the command line.
  82.  
  83.  
  84. Example:
  85.     % cassette -n album1.sample album2.sample > label1.ps
  86.     % cassette -n double.sample > label2.ps
  87.     % printlabels -a -m label1.ps label2.ps | lpr -Plaser
  88.  
  89.  
  90. Bug reports/fixes or enhancements may be sent to me (Tom Smith) at
  91.     {hplabs, ucbvax!sun!sunncal}!analog!smith
  92.  
  93.  
  94. Copyright (C) 1987, Thomas H. Smith -- San Francisco, California
  95.    Permission is granted to any individual or institution
  96.    to use, copy, modify, or redistribute this software so long as it
  97.    is not sold for profit and provided this copyright notice is retained.
  98.  
  99.    PostScript is a registered trademark of Adobe Systems, Inc.
  100.    The name 'Dolby' and the Dolby symbol are trademarks
  101.     of Dolby Industries, Inc.
  102.