home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / miscprog / plist3_1 / plmerge.doc < prev    next >
Encoding:
Text File  |  1992-04-16  |  4.2 KB  |  113 lines
  1.  
  2.             PLMERGE - A Text File Merge Utility for PLAYLIST
  3.  
  4. PLMERGE merges music library data in text file format into a PLAYLIST
  5. music library database file.
  6.  
  7. The following files should have been provided with this package:
  8.  
  9.         PLMERGE.DOC     This documentation file
  10.         PLMERGE.EXE     The PLMERGE program itself
  11.  
  12.  
  13.                          MERGE FILE DATA FORMAT
  14.  
  15. To generate a text file for conversion to PLAYLIST, the following format
  16. should be used:
  17.  
  18.     va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  19.     va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  20.         va\vt\vm\vi\sa\st\sm\sy\mm:ss\nn
  21.         (etc. - one line for each selection entry)
  22.                         
  23. ...where the following definitions apply:
  24.  
  25.         va = volume artist's name
  26.         vt = volume title
  27.         vm = volume media type
  28.     vi = volume location index number
  29.  
  30.         sa = selection artist's name
  31.         st = selection title
  32.         sm = selection music type
  33.     sy = selection year of release, copyright, etc.
  34.     mm = minutes
  35.         ss = seconds
  36.         nn = selection number (on or in the volume)
  37.  
  38. Values for vi, sy, mm, ss, and nn can be zero if unknown.  The punctuation
  39. shown above must be used for field delimiters ("\" and ":").  Each
  40. selection entry record ends with a new-line sequence (carriage-return +
  41. line-feed); thus the data can be created, viewed, or modified as
  42. necessary with any standard text editor capable of handling extra-wide
  43. lines, such as QEDIT.  Data for each record starts in the first column
  44. of the line.
  45.  
  46. NOTE:  Any spaces or tabs in front of or behind the field delimiters
  47. should be removed prior to using PLMERGE.
  48.  
  49. In order to make things easier, PLMERGE will accept records (lines) in
  50. any order; i.e., it will sort the data automatically during the merge
  51. process.  Therefore, no guidelines are necessary with respect to
  52. pre-sorting your data.
  53.  
  54. The data format specified above may appear a bit verbose, but it is
  55. fairly easy to generate using a database or spreadsheet text file output
  56. followed by a few text editing search-and-replace operations.  It is also
  57. not too difficult to generate from scratch using a decent text editor;
  58. however, if you're generating new data from scratch by hand, you'll find
  59. that it's easiest by far to do this within PLAYLIST itself.
  60.  
  61.  
  62.  
  63. FIELD LENGTH LIMITATIONS -- All fields are variable length.  Text fields
  64. should be limited to no more than 40 characters, while the total length
  65. of any single line (record) should be limited to under 190 characters.
  66. NOTE:  PLMERGE does not perform any field length checking.
  67.  
  68. CASE (IN)SENSITIVITY -- PLMERGE applies the same rules for handling
  69. capitalization as PLAYLIST does; i.e., when an artist, selection title,
  70. volume title, music type, or media type is entered that already has
  71. been entered before, the capitalization of the new entry will be
  72. ignored, and the previously-entered version of the capitalization will be
  73. used.
  74.  
  75.  
  76.                             RUNNING PLMERGE
  77.  
  78. PLMERGE requires that a PLAYLIST data file, such as MUSIC.LDB, already
  79. exists -- this can be an "empty" database file created by PLAYLIST.  To
  80. use PLMERGE, enter the following command:
  81.  
  82.     PLMERGE MUSIC.LDB filename.ext
  83.  
  84. ...where filename.ext is the name of the text file to be merged
  85. conforming to the format described above.  PLMERGE will merge any data
  86. in the new file into the existing PLAYLIST data file, exiting with a new
  87. version of MUSIC.LDB.  A backup copy of MUSIC.LDB, called MUSIC.BAK,
  88. will be created by this utility, in case you want to "undo" the merge.
  89.  
  90.  
  91.                   REPEATED MERGES
  92.  
  93. If PLMERGE is run two or more times with the same basic files, any changed
  94. data in the text file from one time to the next will be added.  PLMERGE
  95. avoids duplicate entries; if no new or changed data is seen, the PLAYLIST
  96. database file will be left unchanged.
  97.  
  98. If text file data records are modified from one run to the next, both the
  99. original and the modified versions will then be in the PLAYLIST database.
  100. Any obsolete data entries can subsequently be removed very easily within
  101. PLAYLIST.
  102.  
  103.  
  104. PLAYLIST and PLMERGE are produced by:
  105.  
  106.                         Software Solutions
  107.                         217 Victory Lane
  108.                         St. Charles, MO  63303-8432
  109.  
  110.  
  111. Copyright 1992 Douglas B. Stinson
  112.  
  113.