TRANS
-----

Format:        TRANS  source  [/A] [/H] [dest [/A]  [/C]  [/T 
          transform]]

Purpose:       Changes   characters   in  a  file  to   other 
          characters.

Use:           The  TRANS  command  is similar  to  the  COPY 
          command, the source being a filespec that specifies 
          the  files  to  be  copied and  the  dest  being  a 
          filespec  that specifies their destination,  as  in 
          COPY.   The  /H  and  the  /A  on  the  source  and 
          destination   filespecs  behave  as  in  the   COPY 
          command.

               The parameter after the /T is either a list of 
          character  transformations  to be  applied  to  the 
          files  as they are copied,  or is a filespec  which 
          specifies   a   file   containing   the   character 
          transformations.

               The list of transformations, whether specified 
          on  the command line or in a file,  consists of the 
          letter  to be transformed,  an equals-sign (=)  and 
          one or two characters which replace the transformed 
          character. For example:

                    a=x, b=yy, c = zz

          will  replace all occurences of 'a' with  'x',  all 
          occurences of 'b' with 'yy' and all occurences of c 
          with zz.  Thus single characters may be replaced by 
          another  single character or by a  character  pair, 
          and more complex transformations require the use of 
          an   editor   with   string  search   and   replace 
          facilities.

               The /C option causes the transformations to be 
          case sensitive.  Thus, in the above example without 
          /C,  all occurences of 'c' are replaced by 'zz' and 
          all occurences of 'C' are replaced by 'ZZ'.  If  /C 
          was  given,  then  only lower-case  'c'  characters 
          would be replaced.

               When  a filespec is given after /T,  a file is 
          looked for that contains the transformations.  If a 
          drive  or path are given as part of  the  filespec, 
          then  just the specified directory is searched  for 
          the file.  If no drive or path is given, then first 
          the  current  directory is searched for  the  file, 
          followed  by,  if it was not found,  the  directory 
          from  which  the  TRANS  command  was  loaded.  The 
          filename   part   of  the  filespec   defaults   to 
          TRANS.DAT.

               Note  that  this is a transient  command,  and 
          must be loaded from disk.

Examples:

     TRANS *.DOC *.PRN

               All .DOC files are copied to .PRN files,  both 
          in the current directory of the current drive,  and 
          character transformations are applied according  to 
          a  TRANS.DAT  file  found  either  in  the  current 
          directory  of the current drive or in the directory 
          from which the TRANS command was loaded.


     TRANS *.DOC *.PRN /C /T a=la A=ua

               All .DOC files are copied to .PRN files,  both 
          in the current directory of the current drive,  and 
          during  the copy all lower-case 'a' characters  are 
          replaced by 'la' and all upper-case 'A'  characters 
          are replaced by 'ua'.
