1 NameLib
     NameLib is a package of subroutines intended to be used to Parse
a forign commandline, to Parse filenames, and to handle default filename
fields.

2 GetCommandLine
   Get the FOREIGN COMMAND LINE          ( 1 Argument)

Command Format 

  GetCommandLine(STRING CommandLine)

      This subroutine will only work if the program being run was set
up to be invoked by a symbol...
     
             $ CmdName :== $Tech$Disk:[ICPaul]CmdName

      Then if...
               
             $ CmdName hoho 
               
             ... is typed, GetCommandLine would return the string "HOHO".
 and if ...
          
             $ CmdName := $Tech$Disk:[ICPaul]CmdName
             $ CmdName 'P1' 'P2' 'P3' 'P4'

        ... were done in a .COM file, GetCommandLine would return a string
string with the translated values of P1, P2, P3, and P4 seperated by spaces.
  
2 GetInput 
   Prompt for and read user input     ( 4 Arguments)

Command Format 
     
 GetInput(STRING Prompt, STRING Default, STRING User_Input, STRING Switches)

  
     If the Prompt String is non-blank,  it is written out, followed by the
Default file name (if non-blank), enclosed in Square Brackets, and followed 
by a space. All characters on the line, up to a "/", are then read into the 
User_Input String.  Any characters appearing after a "/", as well as the 
"/", are read into the Switches string.
  
*** NOTE: The procedure -- GetInput --  uses channel #99 for User input. ***

2 BreakFileName
 Break a file name into its components and put them into the COMMON FBroken.
              ( 1 Argument)  

Command Format 
     
   BreakFileName(STRING FileName)

     If a string is passed, to this subroutine, which contains a logical 
assignment, in the device field, the logical will be translated and the 
modified string will be returned, in FileName, to the calling procedure.
      
2 MakeFileName
   Make a file name by combining a default file name with the user filename.
               ( 3 Arguments )

Command Format 
    
  MakeFileName(STRING Default, STRING User, STRING Result)

      This subroutine fills missing fields in STRING User, with that field
in STRING Default, if any, and places the results in STRING Result

      This subroutine uses the COMMON FBroken


2 SplitCommandLine 
      Split STRING CommandLine, like one returned by GetCommandLine, into
into several pieces (pieces are separated by spaces). 

          ( 3 Arguments)

Command Format 

   SplitCommandLine(STRING CommandLine, STRING User, STRING Switches)


      Each invocation of SplitString will sever the next piece off of 
the STRING CommandLine and put it into STRING User.  Additionally, if 
this piece contains a "/", the portion after, and including the "/", 
will be put into STRING Switches.  This piece will be removed from
STRING CommandLine and the modified string will be returned.


2  INCLUDE FILES
   To use these subroutines include the file...
     
        Sys$SysRoot:[SysUTL.NameLIb]NameLib.Def 

   in your BASIC program and link the program with

        Sys$SysRoot:[SysUTL.NameLib]NameLib/LIB
