PutInst v3.0 - (c) 1994,95 Andy Voss (Phoenix/KFMF)
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

 PutInst replaces the entire instrument or filename list of a digital music 
 file with the contents of an Ascii text file.

Syntax
ÄÄÄÄÄÄ
 PUTINST song-filename text-filename (parameters)
 PUTINST (asks for filenames & parameters within program)
 
 To erase the instrument list (as if you were inserting a file filled
 with spaces, replace the text-filename with the word "BLANK".

Parameters  
ÄÄÄÄÄÄÄÄÄÄ
 /t  - Do not insert tagline in last blank instrument name
 /f  - Insert text file into file names (S3M) or sample names (XM)
       instead of instrument names
 /g  - Reverse operation - extracts instrument names (file/sample
       names w/ the "/f" parameter) into the specified textfile
 /b  - Do not insert blank spaces in remaining instrument/file names
 /sX - Start insertion at instrument # X
       (see chart below for range of X)

 What will result in the song file depends on the limitation of its instrument
 name limits.  The following song formats are supported, shown with limits:

 Format   Type                               # of Inst's   Max Length/Inst
 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
  MOD     Sound-/Pro-/Noise-/FastTracker Module  31'            22
  MTM     MultiTracker Module                    31             22
  STM     ScreamTracker Module (pre 3.0)         31             12
  S3M     ScreamTracker Module (3.x)            1-99            27
  XM      FastTracker Ext.Module (2.x)          1-128ý          22

 ' PutInst does not support 15-instrument MODs.
 ý 1-16 samples per XM instrument.

Sample Usage
ÄÄÄÄÄÄÄÄÄÄÄÄ
 To change a module's samplenames in an external text-editor:
  putinst song.s3m list.txt /g
  edit list.txt
  putinst song.s3m list.txt

 To erase all text inside a module (e.g., for MC3)
  putinst song.s3m blank
  putinst song.s3m blank /f <-- for S3M's and XM's

 To insert a 5-line ASCII at line 20, leaving the rest intact
 (like the notorious Music Channel BBS)
  putinst song.s3m /s20 /b /t

Questions or comments? 
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
Email me at: vossa@rpi.edu.

Revisions
ÄÄÄÄÄÄÄÄÄ
 3.0  Added XM support
      Added "/g" parameter
      Added #-of-instrument refit for S3M's/XM's
       and "/r" parameter to disable it
      Added instrument-name eraser (see syntax)
      Fixed lines-with-CR bug
 2.1  Added "/n", "/f", "/b", and "/s#" parameters
      Fixed PutInst tagline bug
      Added FT2 "xxCH" MOD support
 2.0  Added STM & S3M support
      Compiled into EXE form
      Added many forms of error handling
      Added command line input
 1.2  Unreleased version by The Hacker/KLF
 1.1  Added MTM support
 1.0  Original .BAS version, MOD only