
The updtsrc File Converter 
===========================


DESCRIPTION

- The updtsrc file converter takes a Maple source file containing code
  written in Maple V Release 3, and updates it to conform with rules for
  use with Maple V Release 4. 

- See the platform specific documentation for information about how to
  use updtsrc on your platform. 

- The updtsrc program reads from the specified files.  Output is written
  to the standard output.

- The program reads from command line files or from standard input and
  writes to standard output. 

RUNNING updtsrc

You can access updtsrc from within Windows or OS/2,
or from the DOS command line.

  Windows and OS/2:   Click on the updtsrc application icon.

  DOS:   Enter "updtsrc" at the command line prompt.  You can find the
	 executable updtsrc.exe in the bin.win directory.


OPTIONS

Once inside uptsrc, you may specify any any options and the names of
the files you wish to update.

- updtsrc has the following options: 

    -p allow printing of copyright procedures          
    -w suppress warning messages of deleted procedures 
    -h suppress printing of file name header            

- If a procedure definition is copyright K.O. Geddes, G.H. Gonnet, M.B.
  Monagan, University of Waterloo, Waterloo Maple Inc., or
  ETH-Zentrum(Zurich) then it is not copied to the output file and a
  newer version of the procedure is available. The -p option will
  override this. 

- A warning message is written to standard error whenever text is not
  copied to the output file.  The warning gives the procedure name and
  line number in the source text.  The use of outdated library procedures
  also gives a warning message of the same form. 


- The ":" delimiter, when used for declaring parameter types in procedure
  definitions, is replaced by "::".

- Operator procedures defined using "<" and ">" (angle bracket notation) are
  replaced by a different notation as follows:

       "<expr>" becomes either "() -> expr", "var -> expr", or "(var,...,var)
       -> expr", where the vars are determined by computing "indets(expr)".

       "<expr|var>" becomes "var -> expr".

       "<expr|var,...,var>" becomes "(var,...,var) -> expr".

       "<expr|vars|locals>" becomes "proc(vars) option operator; local
       locals; expr end".

       "<expr||locals>" becomes "proc(vars) option operator; local locals;
       expr end", where the vars are determined by computing "indets(expr)".


DIAGNOSTICS

- Exit status is 0 for normal exit and 1 if an error occurs.


SEE ALSO

- See also the updtsrc help page which may be viewed from within Maple
  by typing ?updtsrc.
