NAME

       yexpand - tool to expand environment variables in Nypatchy cradles

SYNOPSIS

       yexpand inputfile [ outputfile ]

DESCRIPTION

       yexpand  is  a  very simple script to expand environment variables in a text file to their
       current values in the shell environment.  It was written to be used with nypatchy cradles.
       It is recommended you not try to use it for any other purposes (note BUGS below).

USAGE

       yexpand  takes  inputfile as input, replaces all instances of shell variables (in the form
       $VARIABLE or ${VARIABLE}) with their current values in  the  environment,  and  saves  the
       result  to  outputfile.   Undefined  variables  are  replaced  with  the empty string.  If
       outputfile is not given, the result is instead saved to the current directory as a file of
       the  same  name  as  inputfile.   Thus  an  input  file  in  the current directory will be
       overwritten.

BUGS

       This script is very simple-minded.  Since it basically just echos  its  input  file  as  a
       here-doc,   it   will  attempt  to  perform  all  types  of  shell  substitution  (command
       substitution, etc.) as well as variable substitution.  Hence  it  is  likely  to  fail  on
       anything except the very simplest text files.

       Additionally,  this  script  creates a temporary file.  The file is created in the current
       directory, so there should not be security implications.  However, any existing file named
       file.yexp  (where  file  is  the  basename  of inputfile) in the current directory will be
       overwritten and then deleted.

SEE ALSO

       fcasplit(1),  nycheck(1),  nydiff(1),  nyindex(1),  nylist(1),  nymerge(1),   nypatchy(1),
       nyshell(1), nysynopt(1), nytidy(1)

       The  reference  manual  for  the  Nypatchy  suite  of  programs is available in compressed
       PostScript format at the following URL:
       http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz

AUTHOR

       This manual page was  written  by  Kevin  McCarty  <kmccarty@debian.org>  for  the  Debian
       GNU/Linux system (but may be used by others).  It is licensed under the GNU General Public
       License, version 2 or later (at your choice).

COPYRIGHT

       Copyright (C) Kevin B. McCarty, 2008.

                                           Mar 12, 2008                                YEXPAND(1)