CONVERT_TO_XVIEW(1)       UNIX System V(11 June 1990)       CONVERT_TO_XVIEW(1)


NAME
      convert_to_xview - convert a SunView1 source program to XView source

SYNOPSIS
      converttoxview [ -m ] filename...

AVAILABILITY
      This command is available with the XView software distribution.

DESCRIPTION
      converttoxview is a shell script which uses sed(1) scripts to convert
      SunView1.x programs to the XView Application Programming Interface (API).
      converttoxview parses filename and creates a new file with the XView
      API in the current directory called filename.convertedtoxview.  The
      default conversion that is done is called FULL conversion. FULL
      conversion of SunView source converts everything to XView naming
      conventions regardless of API compatibility support (e.g., changes
      WINFONT to XVFONT even though WINFONT would still work).

      The other type of conversion is called MINIMAL conversion.  MINIMAL
      conversion retains SunView compatibility wherever possible and inserts a
      unique flag and comments at every instance where manual conversion is
      necessary in C language source comment form. The flag and comments will
      look something like this:

            #ifdef XVIEWCOMMENT
            XView CONVERSION - Make sure to use xvinit to process the attrs
            first. Sect 3.2
            #endif

      The original SunView1.x file is not modified.   After the file is
      converted, you should then search for

            XView CONVERSION

      in the new converted program (filename.convertedtoxview).  Use the
      conversion documentation, XView 1.0 Reference Manual: Converting SunView
      Applications, to determine the proper conversion for these flagged items.
      In some possible cases, the comments may make references to sections in
      the manual which should be consulted to correctly convert something.

OPTIONS
      [-m]  Perform minimal conversion only.

ENVIRONMENT
      The script recognizes the environment variable $OPENWINHOME as the root
      directory for the installation point for converttoxview.  By default it
      should be installed into the root directory '/'. Additionally, the sed(1)
      scripts that are used by converttoxview must be located in the
      $OPENWINHOME/conversion directory.




10/89                                                                    Page 1

CONVERT_TO_XVIEW(1)       UNIX System V(11 June 1990)       CONVERT_TO_XVIEW(1)


EXAMPLES
      Convert foo.c from SunView1 to XView:

            % converttoxview foo.c
            ----Converting File: foo.c
            --Done
            %

      Now go in and edit (with your favorite text editor such as vi,textedit,
      etc.) the result of the conversion (my_program.c.converted_to_xview) and
      see if there is anythingthat didn't get converted:

            % textedit foo.c.converted

      Do only minimal conversion of my_program.c & your_program.c to XView:

            % converttoxview -m foo.c blah.c
            ----Converting File: foo.c
            ----Converting File: blah.c
            --Done
            %
      The above would create two files new files and each will only had minimal
      conversion performed (just flags inserted).

FILES
            $OPENWINHOME/bin/xview/converttoxview
            $OPENWINHOME/bin/xview/converttoxview.README (this file)

      Where $OPENWINHOME is the installation/mount point for XView.

SEE ALSO
      sunview(1), sed(1), textedit(1), vi(1), sh(1)






















Page 2                                                                    10/89