README for 'requireFEXpackage'


WHAT IS IN THE BOX:

This submission to Matlab Central File Exchange (FEX) contains 
the following files:

	* requireFEXpackage.m -- function 
	* suggestFEXpackage.m -- function
	* RequireFEXpackageExample1.m -- sample script, Example 1
	* RequireFEXpackageExample2.m -- sample script, Example 2
	* installFEXpackages.m -- sample script to use in other packages submitted to FEX
	* README.TXT -- this file


THE PURPOSE

The authors of submissions (packages) to FEX may sometime use the functions from the packages submitted to FEX by other authors. Instead of distributing those packages written by others, the authors of FEX submissions can use the function 'requireFEXpackage.m' for helping users with downloading and installing the required FEX packages. 

Three included sample scripts demonstrate how this can be done. 
In particular, see the instruction in the 'installFEXpackages.m'.

The easiest way is just to add the files 'requireFEXpackage.m' and 'installFEXpackages.m'
to your toolbox, modify the file 'installFEXpackages.m', and instruct the user of your toolbox
to run the script 'installFEXpackages.m' once before using your toolbox.

The user is always asked where to put the requested FEX package. A subdirectory called 'NNNNN' (where NNNNN is the ID of the requested FEX package) is created in the user-selected location, and all files from the requested FEX package are installed there.

There is also another function in this toolbox, namely 'suggestFEXpackage.m', which can be used in situations, where the the other FEX submission can be recommended as a related one, but is not a necessary pre-requisite. 

it can be recommended to create a directory called 'FEX' for putting all FEX packages there. 


UPDATES:

2011-04-19: 
* Added a fix to handle the case of single m-files without the BSD licence.
* Improved instructions in 'installFEXpackages.m'.
* Modified README.TXT 

2012-05-09:
* Enhanced formatting in the dialog in 'requireFEXpackage.m'
* Function 'suggestFEXpackage.m' added.


Author: Igor Podlubny, 
		Technical University of Kosice, Slovakia
		igor.podlubny@tuke.sk