coyote: CGAPPENDTOFILENAME

Description
The purpose of this routine is to allow the user append text to the end of the
root name of an absolute file name. The text is appended to the end of the root
name (see `cgRootName`) and before the final file extension.
Categories
Utilities
Returns
The appended filename.
Params
filename: in, required, type=string
    This file name the text is to be to be appended to. It may be a relative or absolute path
    name to a file.
thetext: in, required, type=string
    The text to append to the end of the file root name.
Examples
Append "processed" to a filename::
   IDL> thePath = "C:\rsi\idl7.8\lib\jester.img"
   IDL> outFileName = cgAppendToFilename(thePath, '_processed')
   IDL> Print, outFileName
        C:\rsi\idl7.8\lib\jester_processed.img
Author
FANNING SOFTWARE CONSULTING::
   David W. Fanning 
   1645 Sheely Drive
   Fort Collins, CO 80526 USA
   Phone: 970-221-0438
   E-mail: david@idlcoyote.com
   Coyote's Guide to IDL Programming: http://www.idlcoyote.com
History
Change History::
   Written by: David W. Fanning, 19 September 2012.
Copyright
Copyright (c)2012, Fanning Software Consulting, Inc.