
		FILE LINKING UTILITY

NAME
	linkFile - File linking utility


USAGE
	linkFile [-h] [-v] [-n <name> -e <ext> -f <from> -t <to>]
        -h              Prints this help
        -v              Verbose mode
	-p <path>	Base path for all the files
        -n <name>       Prefix name of the files
        -e <ext>        Extension of the files
        -f <from>       Sequence starting point
        -t <to>         Sequence ending point


DESCRIPTION

    linkFile is a renaming tool for files to be used in Jaleo. The reason
    of this is to provide Jaleo with files of the following format:
    
	<name><sequence number>.<extension>
	
    as in clip1_0001.rgb, which states that the file is of type rgb.
    
    In case you have another numbering sequence, which is:
    
	<name><extension>.<sequence number>

    you can use this command to create linked references to the original.
    
    The command behaves in two modes:
    
    a) From command arguments: you must then specify all clip options 
    (name, ext, from and to) and eventually the verbose and/or the path to 
    work in.
    
    b) From interactive input: if you omit all the clip options, you will be
    prompted to enter them, then they will be processed.

    The files will be linked in the same directory as where the original files
    reside. You can then use the new name for use in Jaleo.


NOTES

    The command checks for files that:
	a) cannot be read, taken as a source file
	b) cannot be written, because already there

    In the first case you should check that the arguments and bounds of the loop
    don't exceed the number of files you originally have.
    
    In the second case, you can remove the files, since these are references only.

    When in interactive input, typing return will leave the value displayed in
    brackets. Entering a new value, will override the one displayed.
    
    
EXAMPLES

    $ linkFile -v -n a_ -e rgb -f 1 -t 14
    This will rename files called a_rgb.1 to a_rgb.14 to a_1.rgb to a_14.rgb.

    You also can make a script that calls this command in many times, with
    different paths, i.e.:
    
    $ cat linkBatch
    linkFile -p clip1Directory -n clip1_ -e rgb -f 1 -t 100
    linkFile -p clip2Directory -n clip2_ -e rgb -f 1 -t 200
    linkFile -p clip3Directory -n clip3_ -e sgi -f 1 -t 40

    In case you need to repeat the command a few times, you can type:
    
    $ while :
    do
	linkFile -v
    done
    
    and stop the loop with Ctrl-C at any time.
