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,  and
       files    containing    the   compiled  form.   This
       autoloading of functions and execution of   scripts
       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 file
       the   normal   function   file when the function is
       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  used
       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
       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
       either case, the functions in  files  written  with
       option   will   be   autoloaded   as if the KSH AU-
       unset.

       The reason for handling loaded  and  not-yet-loaded
       different   options  is  that some definition files
       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 oth-
       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,
       of all functions currently defined or marked as au-
       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
       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  con-
              into  the shell's memory, rather than  memo-
              -M).   This  happens automatically  on  sys-
              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 shell's
              read.  This is done in such a way that  mul-
              of the shell running on the same  host  will
              mapped file.  If neither -R nor -M is given,
              builtin decides what to do based on the size
              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  these
              given,  the  function will be loaded as  de-
              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   machines
              small-endian   machines.    The   upshot  of
              compiled file is machine independent and  if
              mapped,  only  one half of the file is actu-
              mapped).
