yexpand(1) [debian man page]

YEXPAND(1)						      General Commands Manual							YEXPAND(1)

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  val-
       ues  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 implica-
       tions.  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)

NYSHELL(1)						      General Commands Manual							NYSHELL(1)

NAME

       nyshell - tool to generate shell scripts to build nypatchy output

SYNOPSIS

       nyshell logfile options cradle [ print ] [ .go ]

DESCRIPTION

       nyshell is a tool in the Nypatchy suite of programs for working with Patchy Master Files (PAM files); see nypatchy(1).  Specifically, given
       the log file of a nypatchy run, it can create a shell script to compile all the source code files output by nypatchy.  This program is sim-
       ilar to fcasplit except that it takes the log file as input instead of a source file, and it remembers which source code files have already
       been compiled in previous runs.

USAGE

       logfile is the name of the log file coming from nypatchy, with a default extension of ".log".  A cradle file cradle may	be  given  to  add
       additional  setup  options  such as desired compilers or compiler flags to use.	(See the reference manual for more details.)  print is the
       file to which informational output should be written (the default is standard output if omitted), and options is a sequence of single-char-
       acter  flags.  This program generates a shell script file named name.shfca (with name being the part of logfile sans extension) that can be
       run to build all object files.  The file name.xqtlog "remembers" the current state.

       The command should be ended with ".go" unless one wants to enter the Nypatchy interactive shell.

OPTIONS

       Note that options should be given as a single string of characters with no space separation and no use of the - character (except  that	it
       can be used in place of the options field if no options are desired).  Alphabetic options are not case-sensitive.

       A      Force recompilation of all routines.

       B      Bypass tests based on the .xqtlog file.

       E      Bypass tests based on the .xqtlog file if it is empty.

       H      Print help information only.

       Q      "quick" - Do not print the setup.

       S      Print the setup only (only together with H).

       U      "up to date" - Check that all .o files are ready to go into a library.

       V      "verbose" - Print the complete setup.

SEE ALSO

       fcasplit(1), nycheck(1), nydiff(1), nyindex(1), nylist(1), nypatchy(1), nymerge(1), nysynopt(1), nytidy(1), yexpand(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

       Running the command "nyshell help .no" also gives some brief help on usage.  Running the command "nyshell - hs .no" prints the default set-
       up (compiler names and options) to be used in the generated shell scripts.

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 							NYSHELL(1)