zcompile [ -U ] [ -z | -k ] [ -R | -M ] file [ name ... ]
zcompile -ca [ -m ] [ -R | -M ] file [ name ... ]
zcompile -t file [ name ... ]
       This builtin  command  can  be  used   to   compile
       scripts,   storing   the  compiled  form in a file,
       files   containing   the   compiled   form.    This
       autoloading    of    functions   and  execution  of
       parsing of the text when the files are read.

       The first form (without the -c, -a or  -t  options)
       piled  file.   If  only the file argument is given,
       has the name `file.zwc' and will be placed  in  the
       as   the   file.   The shell will load the compiled
       the normal function file when the function  is  au-
       the  section  `Autoloading Functions' in zshmisc(1)
       tion of how  autoloaded  functions  are   searched.
       .zwc stands for `zsh word code'.

       If   there  is  at least one name argument, all the
       compiled into the output file given  as  the  first
       file   does  not  end  in  .zwc,  this extension is
       appended.  Files   containing   multiple   compiled
       called   `digest'   files,  and  are intended to be
       of the FPATH/fpath special array.

       The second form, with the -c or -a options,  writes
       definitions  for all the named functions into file.
       names must be functions currently  defined  in  the
       those  marked  for  autoloading.   Undefined  func-
       marked for autoloading may be written by using  the
-a option, in

       which  case  the fpath is searched and the contents
       tion files for those functions,   if   found,   are
       file.    If both -c and -a are given, names of both
       tions and functions marked for autoloading  may  be
       either  case,  the  functions in files written with
       option will be autoloaded as if  the  KSH  AUTOLOAD
       unset.

       The  reason  for handling loaded and not-yet-loaded
       different options is that some definition files for
       define   multiple functions, including the function
       name as the file, and, at the end, call that  func-
       cases   the  output  of  `zcompile -c' does not in-
       tional functions defined in the file, and any other
       tion code in the file is lost.  Using `zcompile -a'
       this extra information.

       If the -m option is combined with  -c  or  -a,  the
       as  patterns  and  all  functions whose names match
       patterns will be written. If no name is given,  the
       of   all  functions  currently defined or marked as
       be written.

       The third form, with the -t  option,  examines   an
       piled   file.  Without further arguments, the names
       nal files compiled into it are listed.   The  first
       shows  the  version of the shell which compiled the
       the file will be used (i.e. by reading it  directly
       it   into   memory).   With  arguments,  nothing is
       return status is set to zero if definitions for all
       found   in   the compiled file, and non-zero if the
       at least one name was not found.

       Other options:

       -U     Aliases are not expanded when compiling  the

       -R     When the compiled file is read, its contents
              into  the  shell's memory, rather than memo-
              -M).   This happens automatically on systems
              support memory mapping.

              When compiling scripts instead of  autoload-
              it  is  often  desirable to use this option;
              whole  file, including the  code  to  define
              have  already  been  defined,   will  remain
              quently wasting memory.

       -M      The   compiled  file  is  mapped  into  the
              read. This is done in such a way that multi-
              of  the  shell  running  on  the  same  host
              mapped file.  If neither -R nor -M is given,
              builtin  decides what to  do  based  on  the
              piled file.

       -k
       -z      These  options  are used when the  compiled
              functions which are to be autoloaded. If  -z
              function  will  be  autoloaded as if the KSH
              is  not  set,  even if it is set at the time
              file  is read, while if the -k is given, the
              be  loaded as if KSH AUTOLOAD is set.  These
              take  precedence  over any -k or -z  options
              the  autoload   builtin.   If   neither   of
              given, the function will be loaded as deter-
              setting  of  the KSH AUTOLOAD option at  the
              piled file is read.

              These  options may also appear as many times
              between  the listed  names  to  specify  the
              all  following  functions, up to the next -k

              The created file always  contains  two  ver-
              piled   format,   one   for   big-endian ma-
              small-endian machines.  The upshot  of  this
              compiled  file is machine independent and if
              mapped, only one half of the file is actual-
              mapped).
