PC Musician 2000

home *** CD-ROM | disk | FTP | other *** search

/ PC Musician 2000 / PC_Musician_2000.iso / PCMUSIC / MISC / MUSICZIP / STUFFZIP.EXE / UPDATES.TXT < prev next >

Wrap

Text File | 1996-03-28 | 29.0 KB | 458 lines

<<< MUSIC v3.3 >>> MUSIC: The Electronic Song Book Written in Borland Turbo C++ 3.1 by The CAP (aka Chris Pierce) (c) 1994-96 by The PC Works Revision History ~~~~~~~~~~~~~~~~ 08/01/94: First release to public (unfinished Pascal version). 08/11/94: Initial dflt "get another drawer" dir is current DOS dir (not \MUSIC). Properly handles error when printing to printer (printer off). == v2.0 == (09/02/94 - 10/11/94) * <<< PORTED TO C from PASCAL by The CAP (PHEW!) creating v2.0 >>> * Auto-detects and properly uses Color or Monochrome monitor. * User can specify initial "get another drawer" dir on cmd line: MUSIC A:\MUSIC\XMAS or MUSIC A:\MUSIC\XMAS\ * If dir is specified then that drawer is auto-quick-loaded. * Changed L)oad to A)bort. * Removed [Tab] to move between windows. * Completed "Build a song drawer". * Completed "Delete this drawer". * Completed "Delete" a song(s). * Completed "Copy songs". (takes the place of "Move" and "Import"). * Added "Lists menu" and all supported functions (BIG ENHANCEMENT!). * Print now does a FormFeed at song line = "[NewPage]" (ignore case). * Increased song drawer size from 200 to 900 (due to C Large mem mdl). * Increased song file size from 100 lines to 300 lines. * Allows scroll through > 20 SubDirs in "Get another drawer". * Allows changing drives in "Get another drawer". * New opening screen graphics-look. * New pop-up boxes look 3-D by showing a shadow (new box routine). * Fixed editor: ^Y shows lines at bottom of screen properly. * When in Insert mode: underline cursor; Overwrite mode: Block cursor. This is true for both the full-screen editor and single lines. * In editor: TAB when in INSERT mode inserts 5 spaces. * Added "Selected: xx" at bottom-left of screen. * Placed cursor over menu option bold letter (was at EOL) for B&W users. * Print options screen allows moving through questions with Up/Dn arrows and PgUp/PgDn goes to top/bottom quickly. * Print now allows for printing Tbl of Contents (O)nly. * When printing TOC user enters song list heading. * Changed chord strings to recognize Cb and Fb as B and E. * Removed sound from sort routine. * Added global selection_list_heading string all over: prints on TOC. * Fixed bunches of strange (non-toxic) errors. * Added lots of little stuff, too numerous (and insignificant) to list. 11/94 - 11/95: work on the new v3.0... Several Alpha and Beta releases were... well... released. -- v3.0a3 (3rd alpha release of the new 3.0 in development) == * New song file format handles new song attributes. * New song drawer file format (MUSIC.DWR) to keep some new attributes. * Automatically converts old song file and drawer file formats. * Keys can now be Major (C) or Minor (Am). * Completely new PRINT functionality uses Printer Config files (*.PC). * Implemented "MUSIC Configuration" option to update new MUSIC.CFG file. * Added song attributes, including user Defineable Song Attributes. * Changed "Abort" to "Reload" and changed "Rename" to "Attributes". * Fixed bug in song editor & single-line editor routines. * Added command-line parameter /BW and /COLOR (must be B4 song dwr). * In Editor: cursor is now always the right color (Yellow or Gray). * [F2] toggles <sound> on/off when at main menu. * [F3] toggles <notice detail> on/off when at main menu. * Self-diagnostic routine continually checks for data corruption. * input_line() routine now allows scrolling input lines (box_size). -- New to v3.0a4 * Dynamically allocates memory for song_body (300 lines of 78 char's). * Dynamically allocates memory for song drawer records (max songs=999). * These dynamically allocated arrays means smaller MUSIC.EXE file (~120k). * UpArrow goes into (C)hange mode in [A]ttribute screen starting at last attr. * AFTER SONG print code is printed before attributes. * Added print keyword [PLACE NUM] for Xth song in drawer (as currently sorted). * Added print keywords [COMMENT 1] .. [COMMENT 6] for printing just one line. * INSERT key (while in songs window) prompts for selection # rather than just adding the song to the end of the selection list. * Allow FAST/SLOW toggle even while not on chord line. * In song editor, ALT-I inserts ONE line and ALD-D deletes ONE line. * [F10] (find song) now allows either partial title or number for Xth selected or Xth song in window (if no songs selected). * When in Songs Window [F7]/[F8] goes to prev/next selected song. * [F1] Help screen has been updated to show new keys. * [F9] New routine searches all songs in the song drawer for given text. * Print reports: attribute summary, 3 key range charts ([P]rint - [R]eports). * Fixed the REBUILD DRAWER option to handle the new file formats. * Added new fields for STORED_KEYS: [KEY FROM] [KEY TO] [KEY MOD STEP]. This allows an easier way to print in keys other than what the song is stored as since the stored keys and print keys are now separate. This also forced the change of field names for print codes: [KEY] is now [PKEY FROM], [KEY MOD] is now [PKEY TO] and [MOD STEP] is now [PKEY MOD STEP]. The old field names are also understood for backwards compatibility with older alpha releases though I will most likely stop this before the final 3.0 is released. * When you reference a keyword (like [TITLE]) that does not exist (like [TITL]) in a print code field (like BEFORE SONG) then you will get [??? TITL ???] on the output. Prior versions just ignored it which made it tricky to debug you fancy print codes. -- New to v3.0a5 * Fixed bug in 3.0a4: in Song Editor ^LfArrow inserted 1 line. * Using [F7] and [F8] to jump to prev/next selected song in Songs Window works even when not on selected song (jumps to 1st, last selected song). * The [-] and [+] keys now work just like the [F7] and [F8] keys (easier). * Attribute screen doesn't allow you to change the .MUS filename extension now. * Shows fields in Songs Window as MUSIC.CFG dictates (set in Config option). * NEW SONG option now clears the 6 comment lines for new song. * Fixed Multi/One highlight bug. * Updated Config screen used to set which fields are shown in the Songs Window so it understands the new field names KEY FROM, KEY TO, KEY MOD STEP, etc. -- New to v3.0a6 * Implemented the TRAILING_THE option: shows titles as "Servant Song, The" and "Shield About Me, A" (places THE and A at end of title for easy alphabetical skimming through the songs window). * The LISTS MENU now uses a scrolling selector bar to select list rather than having to enter a number to pullup a list. A much nicer method. * There is a new "PEEK" option in the LISTS MENU which, when ON, shows you the songs in the currently highlighted selection list (or the first 17 since that's all that will fit). This is a great way to skim through the contents of selection lists. Press [P] to turn the Peek option on/off. * The "Alphabetize Songs" option now allows you to sort by the either the song [T]itle alone (as was the case before) or by the [F]ields you have setup to be displayed in the Songs Window. This allows you to sort by any field or combination of fields you wish, for example: sort by Key+ Title to give you a list of songs grouped by their keys. Use this new ability along with the Print Reports option to print your reports in any order you wish or several reports in many different orders for quick- referencing songs by key, tempo, date last used, theme, etc. * Added to the prementioned alphabetize routine: option to sort by the 3 digits in the song filenames. This allows you, essentially, to sort by the date you entered the songs. A handy way to see the newest songs in the list. * While in Configuration screens, [F10] now exits. [Esc] used to be used before, except pressing [Esc] would cancel any changes made to the current field when [Esc] was pressed. Pressing [F10] will allow you to exit while still in a field you just changed. This was done to eliminate the many "I could have SWORN I changed that before exiting!" quandaries. * When making changes to Attributes in the Attribute screen, [F10] now accepts the changes, saves them and exists instantly, much like the way [F10] now works in the Config screens (just explained above). * Fixed small glitch in using [End] to get to the last song. Bet nobody even encountered this one (tricky to duplicate). * Fixed small glitch in "Rebuild this drawer" where it made a mess of the screen when auto-converting old music files while rebuilding. * Added new Report: Fields shown in Songs Window. Since you can customize which fields are shown in the Songs Window using screen [F5] of the MUSIC Configuration menu, you can now print your own custom reports showing just the fields you want to see in the order you want to see them. Way Cool! * Minor mods to the Attribute report. * Now save the report output filename (or "PRINTER") in MUSIC.CFG so it will default to the last one used next time you print a report. Also saves the status of the "Peek Box" in the Lists Menu. * When printing songs you are only asked for the Selection List Heading if it's printed. If you do not print a Table of Contents and you don't have the [LIST NAME] keyword being printed in a Before/After code or page header then you won't be asked for the list name. * Attribute screen (view/change song attributes) now has a different user interface which makes it fast and easy to see/change many songs. - Don't press [C] to go into Change mode any more; always in Change mode. - If you press [Esc] after having made changes to the attribute data, the original data will be restored and you can continue editing (an "OOPS!" button). If you press [Esc] while no changes have been made then you are returned to the Main Menu screen. This is a "Smart" Escape. - Pressing PgUp/PgDn will go the the previous/next song... > in the drawer as sorted (if pressed [A]ttribute on non-selected song) > in the selection list in order (if pressed [A] on a selected song). Once again the PgUp/PgDn keys are "Smart". This can be used to quickly set the keys to print the songs in that are currently selected. Pressing PgUp/PgDn will auto-save the song you were on if any changes were made. When the next song is loaded the cursor remains in the same attribute field. This new interface is MUCH nicer and can make a lot of tedious jobs tons easier (like setting a certain attribute for all the songs). Sure would have saved ME a lot of time setting the attributes for all 141 of my songs. * Added the "Search songs for text" feature in the Song Drawer window commands menu. It can no longer be run by pressing [F9]. * Changed the "Song name display" option to "Title display" (which implies that it's new hot-key is ^T instead of ^S) so I could use ^S for the new "Search songs for text" menu option. It now shares the same place on the menu screen as "File name display" and simply toggles between the two depending on which is currently active (just try it and see :) * Updated the [F1] help screens to reflect all these changes described here. * New Sub-List feature. Let me explain... - A sublist is a way to exclude some songs from your list within a song drawer without having to delete them. You can still see excluded songs (songs NOT in the sub-list), but they are dark gray and you cannot select them. This opens up a lot of useful things that you can now do such as... if you are looking for a FAST song in the key of Dm then you can exclude all but the FAST songs in Dm so you have a shorter list to look through (see the Power Picker description below). - Through the use of Sub-Lists you can select any group of songs using even the most complicated search requirements based on logical expressions (AND OR INVERT) as used in the new Power Picker option. There is an example shown below of how you can use the Sub-List to select a group of songs based on detailed criteria through the use of logical expressions in the Power Picker. - The sublist is saved in the MUSIC.DWR (song drawer) file so it will be restored next time you run MUSIC. This feature can be very handy to the MUSIC master users out there but can be ignored by those who don't understand it. Once again, the best way to understand this feature is to play with it. * Pressing CTRL-ENTER on a song in the Songs Window will toggle a song as included or excluded from the sublist. * Power Picker: this is a new menu option in the Song Drawer Tools window that allows a powerful way to modify which songs are in/out of selection lists and sub-lists. Using a new LOV (List of Values) interface gizmo you create a simple sentence describing what you want to do. For example: "ADD SOME songs to the SELECTION LIST" or "INVERT ALL songs in the SUB-LIST". Sound tricky? It's actually really easy because you are given the possible words to create your command sentence in a simple LOV pop-up window. If you tell MUSIC to do something to "SOME" songs then you are provided another window where you specify WHICH songs to mess with. You do this by creating a "Logical Expression" such as "KEY = D" or "TITLE CONTAINS LOVE" or "LAST_USED >= 01/25/95". This process is easy because it too works off the LOV pop-up windows to let you select the field and logical operator. It won't take long to become a POWER PICKER Professional who can do things like "Select all songs in the key of D that are FAST and modulate". You would do this by issuing the following Power Picker commands... 1. "REMOVE ALL songs from the SUB-LIST" 2. "ADD SOME songs to the SUB-LIST" Condition: "KEY MOD STEP != 0" (Include songs with built-in mods) 3. "ADD SOME songs to the SUB-LIST" Condition: "PRINT MOD STEP != 0" (Include songs with print mods) Now that we have a sub-list containing only modulating songs... 4. "ADD SOME songs to the SELECTION LIST" Condition: "KEY FROM = D" 5. "REMOVE SOME songs from the SELECTION LIST" Condition: "ATTR 2 != F" (my ATTR 2 is Tempo) Steps 1-3 create a sub-list that only contains songs that modulate, either because they have modulations built-into the song itself or the PRINT KEYS fields has been set to print modulations. This sub-list is important because songs that are not in the sub-list cannot be selected so steps 4 and 5 can only add songs that are currently in the sub-list we created in steps 1-3. And again... the best way to see it's use and power is to play with it. It really is easy to use (I think :) and is definitely powerful. * External editor (if specified in Configure MUSIC menus, field "Editor") is now used in place of the built-in MUSIC editor when you press ALT-E to edit a song (pressing just E will use the INTERNAL MUSIC editor. * Now you can press [F9] anywhere in the Config screens to call your defined external editor on MUSIC.CFG (the same editor you setup to edit song files when you press ALT-E). You are notified when this is possible by a message at the top of the configuration screens (the only time you cannot press [F9] is when you don't have an editor specified or you specified "INTERNAL"). * Cleaned up (re-organized so they make sense) the Printer code user-styles fields in the MUSIC.CFG configuration screens. Changed all the example *.PC files to work properly with the new style numbers. -- New to v3.0b1 (first BETA release) * Added startup message screen explaining the BETA release vs. v2.0 for users who get MUSIC through the book/CD-ROM publication by Prentice Hall. * Added note on the [F1] help for REAL CHORDS option (in Configure MUSIC) that the Real Chords option is not yet implemented. -- New to v3.0b2 * Fixed bug in "Build song drawer" routine that messes up screen when entering the new directory name. * Fixed "Lists menu" where, after adding a new list, you can't see it. * Fixed bug in Print routine when trying to save a PC file when one isn't already loaded. Now shows "- none -" for PC Filename field when a PC file is not loaded yet. * Changing monitor type (Auto/Mono/Color) is immediately effective now. * Fixed screen messup bug in "Rebuild this drawer" when cannot find key. * Fixed bug when trying to "Get" a drawer after having "Deleted" one. -- New to the final v3.0 * Fixed bug in COPY: didn't properly update destination MUSIC.DWR file. * Fixed bug in ALPHABETIZE: didn't sort properly by TITLE when in ^Filename mode (show songs in Songs Window as filenames rather than titles). * Changed the song filename convention, moving the 3-digit sequence number from the end of the filename to the beginning: WE_AR012.MUS => 012WE_AR.MUS. I did this so I could use a directory sorting program to properly sort the song files by sequence number (so number MUST come first). MUSIC still uses your old song filenames just fine, but when MUSIC creates a filename for you, it will follow the new convention. You can have MUSIC auto-rename all your current song files using the new [F9] menu-less command described below... * Added new [F9] routine to auto-rename all song filenames to the new MUSIC filenaming convention described above. You can also use this routine to re-assign the 3-digit sequence numbers to the song filenames which will eliminate any holes in the sequence (created by deleting songs) or duplicate sequence numbers (created by copying songs from another drawer). * Fixed bug where it was possible to get Drawer file and Song files out of sync. This should no longer be possible (we'll see) since each time a song is saved, the MUSIC.DWR file is now saved as well. * MUSIC no longer trims off the leading or trailing spaces for Before/After codes since it is common to want spaces at the beginning or end of a code definition for spacing out the placement of printed fields (keywords). It also no longer trims the spaces at either end of the Page Heading field. * Updated Keywords list help window to properly show the usage of [ATTR n NAME] and [ATTR n VALUE] where n=1-12. * If the .PC extension is not entered for the "Default PC File" parameter (in the Configure MUSIC prog. Printer screen) then it is automatically added. * Special (hidden) command: press "~" at the main menu screen to see where MUSIC thinks your MUSIC home directory is. This is only for debugging purposes to help me help you if you are experiencing problems. * Properly handles when no Printer Config files (*.PC) exist and user tries to L)oad one. * When creating a NEW song, MUSIC will tell you if the title of your new song is already in the song drawer so you don't enter the same song twice, though you still can if you wish. * You can press [F9] when in LISTS MENU to use your external editor on the MUSIC Selection Lists file (MUSIC.SL). Be careful! * Implemented REAL_CHORDS option. If REAL_CHORDS is on then MUSIC transposes songs according to the following rules: Each key has a key signature which determines the type of accidental to use (an accidental is the "b" or "#" on a note letter like "Ab"). The key signature for each key is either "b" or "#" as determined by the rules of music theory. The exception to this is the key of C which has no accidental since all chords played in the key of C should not have accidentals (A, B, C, D, E, F, G only; no Ab...). Since MUSIC needs to be able to transpose anything I needed to pick an accidental for the key of C; I chose "b" since it is the most commonly used in my "normal" list of key names (as listed in the table below). The accidentals are... key -> A Bb B C Db D Eb E F F# G Ab accidental -> # b # # b # b # b # # b There is one glitch: MUSIC assumes the keys are called the names listed in the table above. This means if a song is in the key of C#, MUSIC will treat it like it is the key of Db. I know of no music theory rule that determines what you call a key (C# or Db) as you modulate so MUSIC uses the keys as shown in the table (which is most common in my experience). So as far as MUSIC is concerned, while transposing songs there is no key of C#, just Db. Once MUSIC knows the key signature then transposing is simple: if an accidental is needed on a note while transposing then MUSIC will use the proper key name which uses the proper accidental. For example: If MUSIC is transposing a song to the key of Bb and it comes across a chord that it needs to call either F# or Gb, it will call it Gb because the key signature for the key of Bb is "b" according to the table shown above. Likewise, if MUSIC is transposing a song to the key of E and it comes across a chord that it needs to call either F# or Gb, it will call it F#. If REAL_CHORDS is set to OFF then none of this applies and MUSIC simply calls the chord the name as listed in the table shown above (never Gb, only F#). This is the only way MUSIC transposed songs up until now and it is likely to be the most commonly used for guitar players. * When the Lists Menu options try to locate a certain song in the song drawer that is listed in the Selection Lists data file (MUSIC.SL) it looked for a match based solely on the song filename (*.MUS). This assures that if you have more than one song with the same title it would still reference the correct one. The problem with this is if you change a song file's name which is more likely now that there is a special routine designed to cleanup the song filenames within a song drawer. So now MUSIC looks for a matching filename and if it can't find it, it looks again for a matching title. This means that if you have two songs with the exact same title and you rename the song files after having a selection list, when you go back to reference that entry in the list file MUSIC will not know which song you mean since the filenames will no longer match and there are two songs titles that match. In this case MUSIC will simply reference the first song. * "Newer version of MUSIC available" message condition modified. If you have MUSIC v3.0 and you download a song or MUSIC configuration file off the Net that was created with a newer version of MUSIC (say 3.1) then MUSIC will tell you that a newer v3.1 MUSIC program is available -- go get it! The check would fail because of the alpha and beta releases since the condition Is "3.0" > (newer than) "3.0b2"? would reply "No" because 3.0 is actually < 3.0b2 when sorting. So a change to the comparison routine had to be made so that it would recognize that "3.1" > "3.0" (easy) and also see that "3.0" > "3.0b2" (the final 3.0 is newer than the 3.0b2 beta release). * Changed the way MUSIC stores information in MUSIC.SL (Selection Lists file). Previously MUSIC added an extra blank line at the end of the file to indicate the end-of-file. Since people may be editing this file using their own text editors I felt MUSIC needed to be more "normal" so it no longer keeps an extra blank line at the end of the file. It will also handle messy files that have multiple extra blank lines between selection list line groups. As soon as you delete a list the MUSIC.SL file will automatically be cleaned up, and until then MUSIC will properly handle having extra blank lines between selection lists (this will happen when you add a new list to a list maintained by an older version of MUSIC). * Fixed bug in General Configuration screen that confused the entry of the REAL CHORDS parameter. * Print routine will print faster now. It no longer transposes chord lines unless it needs to. It was transposing chord lines to the same key which not only took needless time, it could change your assigned names to chords. For example, if you called a chord "Dbm7" in a song that is in the key of E and you had REAL CHORDS On then when the song printed it would rename that chord to "C#m7" (because the key of E has a sharp key signature). -- New to v3.1 * Bug fix: now reads PC files if archive bit is not set (been backed up). Also corrects errors that could occur when trying to read other MUSIC data files with strange file attributes (read-only, hidden...). * Bug fix: Power Picker compares using VOCAL MIN or VOCAL MAX didn't work. * Added new song attribute fields for > AUTHOR 40 characters, before/after keyword=[AUTHOR] > COPYRIGHT 40 characters, before/after keyword=[COPYRIGHT] * CCLI Song Usage Totals report now prints both of these fields so the report more closely matches the actual CCLI required report format (optionally). NOTE: CCLI will not accept this report as is; this is the main reason for the release of v3.2... -- New to v3.2 * Selection Lists are now saved with a new field "Activity Category" = A-E, N. This tells MUSIC "what" you did with the songs in the Selection List you saved: A - Single Use D - Arrangement B - Projection E - Recording C - Print <N>- None (no "copy" was made) These are required by CCLI for the "Copying Activity Report" they require from their subscribers. Any lists saved prior to using v3.2 will be assumed to be no category; you can easily change the MUSIC.SL file manually if you wish to properly categorize your old selection lists by adding a space and "[A]" at the end of each list name (use [A] - [E]). Any lists you wish to save that didn't entail printing a copy of the song(s) may be saved as category "N"one. If you don't intend to send in CCLI Copy Activity reports then none of this matters (choose any category). The category you choose is only used when printing CCLI Copy Activity Reports. * Selection Lists Search Template expanded to allow restriction of lists by the new Category attribute assigned to saved selection lists. There is also a new Help screen for this template which is seen by pressing [F1]. * New CCLI report format will be accepted by CCLI (verified). It includes the new "Activity Category" field stored with each saved Selection List. It also prints the first line of the song (as much as will fit). * New Copy/Paste feature works for ALL data entry fields using Alt-C to Copy and Alt-V to Paste. For example, you can press Alt-C when at the first comment line (attribute screen) and press Alt-V at the second comment line and the first comment line's contents will be copied to the second. Note: This does not apply to the Song Editor. It uses [F9] and [F10] for Copy/Paste. This can be VERY useful, especially when setting up the Printer codes. * Safer Delete List(s) routine that defaults to only the list where the cursor is on (it used to default with an empty Search Template which would delete ALL lists). * Fixed bug that kept users from having NO default PC file (if you made the field empty MUSIC changed it to ".PC" which meant MUSIC couldn't load the PC file automatically when run (since there isn't a .PC file). * Fixed minor [PgDn] bug in Lists Menu (and improved [PgUp]). * When adding a New song, you can safely press F10, Esc, PgUp or PgDn to accept the data on the Attribute screen (which then sends you to the editor). -- New to v3.3 * Fixed bug in Copy Songs routine which made a mess of the destination song drawer (doing a Rebuild of the destination drawer would fix this mess). * Copy Songs routine is entirely redone to allow powerful options for copying songs from one song drawer to another. You can have it verify that a song isn't already in the destination song drawer (by matching filename or song title) and tell MUSIC what to do if it is, including copy only if the song in the source song drawer is Newer than the one being copied to. Or you can have MUSIC show you several important statistics on the two duplicate song files and determine for yourself if you want the song copied or skipped. It is fully designed to help people share songs without copying songs that already exist in the destination song drawer, even if the song filenames are different (*.MUS). This checking can be fully automatic or manual. * Press [1] - [9] to go to the 1st - 9th selected song, [0] goes to the 10th. (remember that [+] and [-] walk you through them in order too). * [F5] is another way (short-cut key) to "Get Another Drawer". * Fixed minor bug in Printing reports (Stored Key rpt). Also fixed default output of reports which transposed PRINTER to PRN. Though this didn't create a problem, it could be confusing to the user. It now saves PRINTER as PRINTER and auto-converts PRN to PRINTER.