
*** Mel-Assembler ReadMe ***

	This script was created to give Mel a semblance of the #include feature
	in C++.  
	
	This script is mainly for cases where you, the scripter, have a lot of small
	broken down procedures for things you commonly do, like string operations,
	and other little functions that you put in your Maya scripts path so they're always
	there.
	
	Now, when you're writing a script for yourself there's no problem,
	but when the script needs to go to somebody else you have to copy/paste
	the contents of those other scripts into your file.

*** Usage ***

	This Assembler makes it possible to place include statements in your script.
	The Assembler goes through your code, picks out the include statements, finds the files,
	and creates a new file containing the main script and all the other scripts

	write the include line like this:
	
	//#include  "someFolder/someScript.mel"

*** how it works ***

	The assembler searches for //#include as its cue to include a file.
	It's commented out so it won't interfere with the normal operation of your script.

*** File paths ***

	You can use absolute paths:
	
	//#include "C:/scripts/someFolder/thatScript.mel"
	
	or relative paths:
	
	//#include "thatScript.mel"

	When you use a relative path the Assembler bases the path off the location
	of the main script.
	
	If the main script is located at
	
	C:/scripts/someFolder/

	the line:
	//#include "thatScript.mel"
	
	will result in it looking for the file at:
	
	C:/scripts/someFolder/thatScript.mel
	
	If you have another folder in the path:
	
	//#include "otherFolder/thatScript.mel"
	
	if will search for a file at:
	
	C:/scripts/otherFolder/thatScript.mel
	
	It goes back as many directories as you have in the #include path, up to the drive letter.
	If you want it to add the path you give on top of the main script path, put a + in front:

	//#include "+otherFolder/thatScript.mel"

	will result in:
	
	C:/scripts/someFolder/otherFolder/thatScript.mel
	
*** Set a different base path ***
	
	You can tell the assembler to use a different base path by putting this line:
	
	//#includeBase "C:/someotherpath/"
	anywhere in the file
	

*** ***

	Hopefully this syntax will be acceptable, however, if you have an suggestions, complaints,
	or bugs, please let me know at:
	
	dan@nerfsafetysquid.com
