home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / miscprog / plist3_1 / pextract.doc < prev    next >
Text File  |  1992-04-16  |  2KB  |  69 lines

  1.     PEXTRACT utility instructions:
  2.  
  3.     This utility extracts a text file from a PLAYLIST database file.
  4.     To use, enter the command:
  5.  
  6.     PEXTRACT <database filename> [<music type>]
  7.  
  8.     ...where <database filename> is the name of an existing PLAYLIST
  9.     database file and <music type> is an optional music type number, starting
  10.     with 1.  A new text file will be generated from the database file using
  11.     the same base name with a .TXT extension, in the following format:
  12.  
  13.     va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  14.     va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  15.         va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  16.     (etc. - one line for each selection entry)
  17.  
  18.     The following definitions apply to the above:
  19.  
  20.     va = volume artist's name
  21.     vt = volume title
  22.     vm = volume media type
  23.     vi = volume location index number
  24.  
  25.     sa = selection artist's name
  26.     st = selection title
  27.     sm = selection music type
  28.     sy = year of selection
  29.     mm = minutes
  30.     ss = seconds
  31.         nn = selection number (on or in the volume)
  32.  
  33.  
  34.     Example commands:
  35.  
  36.     To extract a text file called MUSIC.TXT from MUSIC.LDB, enter:
  37.  
  38.         PEXTRACT MUSIC
  39.  
  40.     To extract only those selections with the music type listed
  41.     third in PLAYLIST's user-defined music type F1 listing (i.e.,
  42.     this would correspond to "Folk" music in the example database
  43.     library provided), enter:
  44.  
  45.         PEXTRACT MUSIC 3
  46.  
  47.     NOTE:  The music type option was provided primarily to support
  48.        a secondary effect that may be encountered to due PLAYLIST's
  49.        new YEAR feature.  In the previous versions, the example
  50.        database contained the music type "Oldie".  Since the year
  51.        information is better at defining just what an "oldie" is,
  52.        one might want to replace an existing "Oldie" music type
  53.        with one or more other music types.    By using PEXTRACT
  54.        together with PLMERGE and a bit of fancy text editing,
  55.        it's relatively easy to change "Oldie" to something else
  56.        instead of revising each such selection via PLAYLIST.
  57.  
  58.  
  59.  
  60.     PLAYLIST and PEXTRACT are produced by:
  61.  
  62.             Software Solutions
  63.             217 Victory Lane
  64.             St. Charles, MO  63303-8432
  65.  
  66.  
  67.     Copyright 1992 Douglas B. Stinson
  68.  
  69.