home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / database / musicdb2 / music_db.doc < prev    next >
Text File  |  1991-02-10  |  8KB  |  263 lines
  1. Music Inventory Database
  2. ========================
  3.  
  4. What is it?
  5. -----------
  6.  
  7. It's a very easy to use program to help you keep track of all of your
  8. music, from CDs to 8-tracks, with up to 32,760 entries allowed.  To
  9. start the program, simply place the .PRG and .RSC files in the same
  10. directory, and double click on MUSIC_DB.PRG.
  11.  
  12. For sake of clarity, from here on:
  13.  
  14. Words in [brackets] are selectable buttons
  15. Words in <symbols> are editable text fields
  16.  
  17. Loading Music Records
  18. ---------------------
  19.  
  20. Menu Bar Option: "Load"
  21.  Key Equivalent: Ctrl-L
  22.  
  23. Loads record files from disk.  If there are records already in
  24. memory, you'll have the choice to either [Keep] the current records in
  25. memory (thereby appending the new records) or [Clear] all records in
  26. memory.  You'll then be prompted to find the appropriate .REC file
  27. you wish to load.  At any time, click on [Cancel] to abort your current
  28. choice of options.
  29.  
  30. Saving Music Records
  31. --------------------
  32.  
  33. Menu Bar Option: "Save"
  34.  Key Equivalent: Ctrl-S
  35.  
  36. Saves records currently stored in memory.  You'll be prompted to find a
  37. destination file.
  38.  
  39. * Warning *:
  40.   If you select a file that already exists, it will be overwritten.
  41.  
  42. Adding Music Records
  43. --------------------
  44.  
  45. Menu Bar Option: "Add"
  46.  Key Equivalent: Ctrl-A
  47.  
  48. Adds a record to the inventory list.
  49.  
  50. Options to choose from are self explanatory.  However, I'll briefly
  51. describe the options/limitations.
  52.  
  53. Rec #:
  54.   Displays the record number of the item being added to the inventory
  55.   list.
  56.  
  57. Type of Medium:
  58.   [Compact Disc/CD Single/Cassette/Cassingle/8-Track/Record/
  59.    45 Single/12" Single] 
  60.  
  61.   Only one type of medium maybe selected at a time.
  62.  
  63. Special Type:
  64.   [Promotional/Import/Bootleg]
  65.  
  66.   Any combination of the above can be selected at a time.
  67.  
  68. <Artist/Title>
  69.   Use these lines to enter in the name of the artist and the title.
  70.   Either field has a maximum of 50 characters a piece.
  71.  
  72.   Note:  Both fields MUST contain some kind of text for the item to
  73.          be added to the music inventory.
  74.  
  75. [*]:
  76.   This is used in conjunction with sorting.  If set, when sorting is
  77.   done with either [The Artist] or [Artist, The] selected, then the
  78.   artist field will be rewritten to "The Artist" or "Artist, The",
  79.   depending on what was selected.  Here are a few scenerios to clear it
  80.   up a bit:
  81.  
  82.   When adding records, some artist names you might enter would be:
  83.   
  84.     The Beatles, Joe Cocker, The Doors
  85.  
  86.     When these are sorted, it is done by the first character in the
  87.     artist's name.  This means the above would be sorted like this:
  88.  
  89.     Joe Cocker, The Beatles, The Doors
  90.  
  91.     which is correctly done, except that no record store that I know of
  92.     keep their stock in order of the first name of the artist.
  93.  
  94.     If the [*] is set on The Beatles, Joe Cocker, and The Doors, then
  95.     they would be sorted like this:
  96.  
  97.     Beatles, The  Cocker, Joe  Doors, The
  98.  
  99.     which makes looking for a group a lot easier when scanning thru 100s
  100.     of names.
  101.  
  102.   When adding records, some artist names you might enter would be:
  103.  
  104.     Hoodoo Gurus, Led Zeppelin, Grateful Dead
  105.  
  106.     These groups would NOT have the [*] set, as they are perfectly fine
  107.     they way they are.
  108.  
  109.     Note:  On groups like "Edie Brickell & New Bohemians" or "Bob Marley &
  110.            the Wailers", the [*] must NOT be set, or when the inventory
  111.            is set, the names will turn out VERY strange (ie, like
  112.            "& New Bohemians, Edie, Brickell").
  113.  
  114. [Add More/Finished/Cancel]:
  115.    [Add More] (Default) - Either hit RETURN once the artist and title
  116.       fields have been entered, or click on it.
  117.   
  118.    [Finished] - If you click this and the artist and title fields both
  119.       contain text, then the record will be added to the inventory list,
  120.       before going back to the main options.  If either one or both
  121.       fields are left blank, then the item will not be saved before
  122.       returning to the main  program.
  123.  
  124.    [Cancel] - Will disregard whatever settings or text that you have
  125.       chosen as it returns to the main options.
  126.  
  127. Editing Music Records
  128. ---------------------
  129.  
  130. Menu Bar Option: "Edit"
  131.  Key Equivalent: Ctrl-E
  132.   
  133. Allows you to edit a record that contains valid data.
  134.  
  135. You can show ANY record in the list (whether it's empty or not)
  136. by doing any one of the following:
  137.  
  138.   - Editing the <Rec #> field.  Type the number of the record you
  139.     want to show up on the top line and hit return.
  140.  
  141.   - [First/Middle/Last].  Clicking on anyone of these will show you
  142.     the first, middle, and last page of records, respectively, in memory.
  143.  
  144.   - [Up/Down Arrow Keys].  Clicking on these will either scroll up or
  145.     down one page in memory (which is 20 records).  You cannot scroll
  146.     up past record #1 or down past record #32741.
  147.  
  148. To edit a record, simply click on the record you wish to change.
  149. You will then be presented with a screen which looks almost exactly
  150. like the one you saw when adding a new record, with the following
  151. changes:
  152.  
  153. [Keep Changes] - whatever changes that have been made to the record will
  154.    be saved in memory.
  155.  
  156. [Delete] - will delete the record.
  157.  
  158. [Cancel] - will disregard any changes made to the record.
  159.  
  160. Clearing Music Records
  161. ----------------------
  162.  
  163. Menu Bar Option: "Clear"
  164.  Key Equivalent: ^C
  165.  
  166. You will be presented with an alert box, asking if you want to delete
  167. all of your hard work from memory.
  168.  
  169. Sorting Music Records
  170. ---------------------
  171.  
  172. Menu Bar Option: "Sort"
  173.  Key Equivalent: ^T
  174.  
  175. [Artist/Title] - This will sort the music records in alphabetical order.
  176.   If [Artist] is selected, then records will be sorted based on the
  177.   name of the artist.  If [Title] is selected, the records will be
  178.   sorted based on the name of the title.
  179.  
  180. [Do It!] - Sort the records
  181. [Cancel] - Do not sort the records
  182.  
  183. Optional Sorting Items:
  184.  
  185. [The Artist] - This will change all occurences in the list of records
  186.   that are in the format "Artist, The" to "The Artist", if the [*]
  187.   was selected when adding or editing the record.
  188.  
  189. [Artist, The] - This will change all occurances in the list of records
  190.   that are in the format "The Artist" to "Artist, The", if the [*]
  191.   was selected when adding or editing the record.
  192.  
  193. Printing Music Records
  194. ----------------------
  195.  
  196. Menu Bar Option: "Print"
  197.  Key Equivalent: Ctrl-P
  198.  
  199. Outputs record list to either printer or to a file.
  200.  
  201. You'll be presented with the familiar list of music mediums and
  202. special types.  Select those which you want to appear in the output.
  203.  
  204. [Clear Options] - this will unselect all music medium and special
  205.   type buttons.
  206.  
  207. [Everything] - this will select all music medium and special type
  208.   buttons.
  209.  
  210. [Printer/File] - determines where the output goes.
  211.  
  212. [80/132] - determines the column length of the output.  This was included
  213.   for you people who have access to 132 column printers [which makes
  214.   output look great!]
  215.  
  216. [Do It!] - outputs all records corresponding to the buttons selected.
  217.            Items are not exclusive when used with one another.  (ie,
  218.            if [CD], [CD single], and [Import] are selected, then
  219.            any record that is a CD or a CD single or an Import will
  220.            be outputed.
  221.  
  222. [Cancel] - return to the main options.
  223.  
  224. Quitting
  225. --------
  226.  
  227. Menu Bar Option: "Quit"
  228.  Key Equivalent: Ctrl-Q
  229.  
  230. Leaves the program.  You'll have 3 choices before you leave:
  231.  
  232. [Save]   - Save the current records in memory to a disk file.
  233. [Quit]   - Exit to the GEM Desktop [or shell]
  234. [Cancel] - go back to the main options, as you're not finished yet.
  235.  
  236. Program Info
  237. ------------
  238.  
  239. Why did I write this?  Sure there are "other" music db programs out there
  240. (that only allow 30 characters for each artist/title field -- argh!).
  241. I even used one for a while, until it bombed on me when trying to print
  242. out the records.  The I tried to run it in mono (a no-no).  Then I said,
  243. "Enough is enough..."
  244.  
  245. This program runs in either medium or high resolution.
  246.  
  247. Version: 1.1/December 19, 1990
  248.  
  249. Program designed, written, documented, and (c) Chris Carpinello.
  250. RSC files created with RCS, v2.
  251.  
  252. This program may be freely copied and distributed.
  253.  
  254. GFA 3.x Source code (and resource .DFN files) are available from me for
  255. $10 (in US funds):
  256.  
  257. Chris Carpinello
  258. 604 Atlantic Ave.
  259. Virginia Beach, Va 23451
  260. USA
  261.  
  262.  
  263.