FILENAME Name
Filename
 Purpose
     
       File names with system independent symbolic directories.
Category
Calling Sequence
      
       f = filename(symdir, name) Inputs
             symdir = symbolic directory name.   in
              name = file name.                   in
Keyword Parameters
Keywords
        
         /NOSYM means directory given is not a symbolic name.
        
         OPSYS=os specifiy operating system to over-ride
          
           actual.  Use VMS, WINDOWS, or MACOS.  UNIX is default.
        
         DELIM=c delimiter character between directory and
          
           file name.  This is returned. Outputs
             f = file name including directory.  out
Common Blocks
Notes
      
       Notes: symdir is a logical name for VMS and
        
         an environmental variable for UNIX and WINDOWS.  Ex:
        
         DEFINE IDL_IDLUSR d0:[publib.idl]  for VMS
        
         set IDL_IDLUSR=c:\IDL\LIB\IDLUSR   for WINDOWS.
        
         setenv IDL_IDLUSR /usr/pub/idl     for UNIX.
        
         Then in IDL: f=filename('IDL_IDLUSR','tmp.tmp')
        
         will be the name of the file tmp.tmp in IDL_IDLUSR.
Modification History
      
       R. Sterner,  4 Feb, 1991 
      
       R. Sterner, 27 Mar, 1991 --- added /NOSYM 
      
       R. Sterner, 21 May, 1991 --- If not a listed opsys assume unix.
              R. Sterner,  4 Jun, 1991 --- added DOS.
              R. Sterner,  2 Jul, 1991 --- added DELIM.
      
       R. Sterner, 17 Jan, 1992 --- added OPSYS= and avoided double //
              R. Sterner, 1994 Feb 7 --- Added MacOS.
      
       R. Sterner, 1994 Feb 14 --- Changed DOS to windows.
      
       R. Sterner, 1998 Jan 16 --- Changed from !version.os to os_family.
  
 Copyright (C) 1991, Johns Hopkins University/Applied Physics Laboratory
  
 This software may be used, copied, or redistributed as long as it is not
  
 sold and this copyright notice is reproduced on each copy made.  This
  
 routine is provided as is without any express or implied warranties
  
 whatsoever.  Other limitations apply as described in the file disclaimer.txt.