File: gpgme.info,  Node: UI Server Set Input Files,  Next: UI Server Sign/Encrypt Files,  Prev: UI Server Verify,  Up: UI Server Protocol

A.5 UI Server: Specifying the input files to operate on.
========================================================

All file related UI server commands operate on a number of input files
or directories, specified by one or more ‘FILE’ commands:

 -- Command: FILE [--clear] NAME
     Add the file or directory NAME to the list of pathnames to be
     processed by the server.  The parameter NAME must be an absolute
     path name (including the drive letter) and is percent espaced (in
     particular, the characters %, = and white space characters are
     always escaped).  If the option ‘--clear’ is given, the list of
     files is cleared before adding NAME.

     Historical note: The original spec did not define ‘--clear’ but the
     keyword ‘--continued’ after the file name to indicate that more
     files are to be expected.  However, this has never been used and
     thus removed from the specs.