home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / devtools / smart / read.me < prev    next >
Encoding:
Text File  |  1994-02-26  |  12.2 KB  |  376 lines
  1.  
  2. The S.M.A.R.T. Tool
  3. Native 'C' and C++ Source Code Porting
  4. Version 1.0 Beta
  5.  
  6. (C) 1993, 1994 One Up Corporation
  7.     All Rights Reserved
  8.  
  9.  
  10. WHAT IS IN THE S.M.A.R.T. TOOL?
  11.  
  12.  The S.M.A.R.T. Tool provides analysis and source
  13.  code migration from one platform to another or one
  14.  version to another on a given platform.
  15.  
  16.  The process of porting source code from one
  17.  platform to another is indeed difficult and subjective.
  18.  
  19.  In fact, exploiting the features of one platform, and
  20.  using proprietary libraries, class, and objects may
  21.  make it severely difficult to port to another platform
  22.  without a major rewrite of the code.
  23.  
  24.  There is no pat solution or utility to port all code to
  25.  a target platform, and we dare say there most
  26.  probably never will be.  With the proper
  27.  tools, methodology, techniques and training the
  28.  effort required in the migration of source code can
  29.  be greatly reduced.
  30.  
  31.  The most appropriate solution for this process is to
  32.  use the computer tools to perform tasks that are
  33.  easily identified, routine, and labor intensive and
  34.  provide a knowledge base to contain information
  35.  related to all occurrence types of differences
  36.  between the platforms.  The human element must be
  37.  applied where the complexity of the issue is too
  38.  complicated for the computer analysis.  It is obvious
  39.  to again provide the programming professional with
  40.  powerful productivity tools to make global changes
  41.  based on the migration issues of complex nature.
  42.  This is the One Up S.M.A.R.T. approach to native code
  43.  migration.
  44.  
  45.  The current version of The S.M.A.R.T. Tool (1.0)
  46.  supports Windows 3.1 -> OS/2 2.1 and OS/2 1.3 ->
  47.  OS/2 2.1 migration and analysis depending upon the
  48.  tables that are installed with this application.
  49.  Additional migration tables will be available in the
  50.  future.
  51.  
  52.  The S.M.A.R.T. Tool is designed to assist in the
  53.  analysis and migration of native source code from
  54.  one platform to another or one version of an
  55.  operating environment to another on the same
  56.  platform.
  57.  
  58.  The platform dependent data is contained in the
  59.  migration dictionary (table) and the migration
  60.  database files.
  61.  
  62.  This process is based on finding keywords (API calls,
  63.  symbols, parameters, typedefs, etc) that differ in the
  64.  migration. These keyword differences are categorized
  65.  into groups to represent the difficulty in migration,
  66.  ranging from a simple literal replacement to the case
  67.  where the functionality does not exist in the target
  68.  platform.
  69.  
  70.  Analysis Procedure
  71.  ------------------
  72.  
  73.  The S.M.A.R.T. Tool will analyze source code and
  74.  prepare a report (display) providing a detailed
  75.  evaluation of the migration requirements.
  76.  
  77.  
  78.  Migration Procedure
  79.  -------------------
  80.  
  81.  Furthermore, in the migration process, The S.M.A.R.T.
  82.  Tool will process the user specified source files and
  83.  create migrated source files.  The migrated source
  84.  file will contain automatic migration changes (where
  85.  possible) and in all cases will provide in-line
  86.  commented code for the user to complete the
  87.  migration.
  88.  
  89.  
  90.  Using The S.M.A.R.T Tool with SourceLink
  91.  ----------------------------------------
  92.  
  93.  The S.M.A.R.T. Tool provides you with the capability
  94.  to specify Link options when creating a hyperlink
  95.  database from the data in the Analysis
  96.  Procedure or Migration Procedure.
  97.  
  98.  These options are only applicable when The
  99.  S.M.A.R.T. Tool is used with SourceLink
  100.  
  101.  SourceLink can be a very effective and productive
  102.  tool in the migration of source code.  SourceLink
  103.  allows you to mouse-click to each change
  104.  throughout your source base to provide a
  105.  systematic method of checking or making migration
  106.  code changes.
  107.  
  108.  More information on this can be found under
  109.  "Utilities", SLBUILD in the SourceLink
  110.  Technical Manual.
  111.  
  112.  
  113. NOTICE OF PRE-RELEASE CODE
  114.  
  115.  This software version of The S.M.A.R.T. Tool is
  116.  prototype code and is not at the level of
  117.  performance and compatibility of the final, generally
  118.  available software offering.  This version of The
  119.  S.M.A.R.T. Tool may not operate properly and may be
  120.  substantially modified prior to first customer
  121.  shipment.
  122.  
  123. DISCLAIMER OF WARRANTY
  124.  
  125.  Because this version of The S.M.A.R.T. Tool
  126.  constitutes prototype code and may be changed
  127.  substantially before first customer shipment, The
  128.  S.M.A.R.T. Tool and accompany documentation is
  129.  provided "AS IS", without warranty of any kind.  One
  130.  Up Corporation further disclaims all implied
  131.  warranties including without limitation any implied
  132.  warranties of merchantability or of fitness for a
  133.  particular purpose.  The entire risk arising out of the
  134.  use or performance of the software remains with
  135.  you.
  136.  
  137.  In no event shall The S.M.A.R.T. Tool or its suppliers
  138.  be liable for any damages whatsoever (including,
  139.  without limitation damaged for loss of business
  140.  information, or other pecuniary loss) arising out of
  141.  the use of or inability to use this One Up Corporation
  142.  product, even if One Up Corporation has been
  143.  advised of the possibility of such damages.
  144.  
  145.  
  146. ABOUT OTHER ONE UP CORPORATION PRODUCTS AND SERVICES
  147.  
  148.  One Up Corporation develops technical programming
  149.  and end user OS/2 software products, computer
  150.  education and consulting services.
  151.  
  152.  The S.M.A.R.T. Tool
  153.  -------------------
  154.  
  155.  The S.M.A.R.T. Tool is the application you are
  156.  currently running. This tool provides powerful
  157.  assistance in the process of migrating source code
  158.  and migration analysis and evaluation.
  159.  
  160.  SourceLink
  161.  ----------
  162.  
  163.  SourceLink is an excellent general programming tool
  164.  with an emphasis on hyperlink source code access
  165.  and source code editing. SourceLink is tightly
  166.  integrated into The S.M.A.R.T. Tool to provide a
  167.  highly productive programming environment.
  168.  
  169.  SourceLink is a feature rich programming
  170.  development tool combining hyperlink  source code
  171.  access, a fully functional editor, and many file
  172.  manipulation  utility functions.
  173.  
  174.  Features
  175.  
  176.      Build hyperlinks to key elements of your source
  177.       code.
  178.      REXX Macro interface.
  179.      Full IBM Workframe interface.
  180.      Spawn Compiles directly from SourceLink and
  181.       hyperlink to errors.
  182.      Context sensitivity to all IBM development help
  183.       files (if installed).
  184.      Edit with multiple windows, any size files.
  185.      Create functional call tree and other
  186.       documentation display - all hyperlink sensitive.
  187.      Unsurpassed methods for navigating directories,
  188.       drives and source code.
  189.      Hyperlink capabilities make learning new code a
  190.       breeze.
  191.      Print S.M.A.R.T. analysis and source code with
  192.       format from within SourceLink.
  193.      Interface with The S.M.A.R.T. Tool provides
  194.       automatic hyperlink to all points of change.
  195.  
  196.  The S.M.A.R.T. Resource Translator
  197.  ----------------------------------
  198.  
  199.  The S.M.A.R.T. Resource Translator (1st Qtr 1994)
  200.  extends the capabilities of The S.M.A.R.T. Tool to
  201.  provide complete source code resource translation.
  202.  
  203.  The S.M.A.R.T. Resource Translator translates
  204.  resource source files from one platform to another.
  205.  These files include dialog templates, menus,
  206.  accelerator tables, string tables and a number of
  207.  bitmap formats.
  208.  
  209.  Features
  210.  
  211.      Scheduled for completion 1st Quarter 1994.
  212.      Source to source translation.
  213.      Windows 3.1 -> OS/2 2.1 Translation.
  214.      Processes 'ifdef' statements.
  215.      Untranslatable statements are logged in error
  216.       file.
  217.      Interface with The S.M.A.R.T. Tool.
  218.  
  219.  The S.M.A.R.T. Commander
  220.  ------------------------
  221.  
  222.  The S.M.A.R.T. Commander (2nd Qtr 1994) is a
  223.  powerful, interactive tool for making global changes
  224.  to your source code. The Commander combines the
  225.  functionality of regular expression search and
  226.  replace, a code generator, and a macro command
  227.  processor along with additional functionality to
  228.  perform highly productive maintenance and porting
  229.  processes.
  230.  
  231.  Features
  232.  
  233.      Scheduled for completion 2nd Quarter 1994.
  234.      Macro command driven search and execute.
  235.      Spans multiple files, directories and drives.
  236.      Macro record and playback.
  237.      Integrates with both The S.M.A.R.T. Tool  and
  238.  
  239.  Open Shutter
  240.  ------------
  241.  
  242.  Open Shutter creates screen captures and bitmap
  243.  translation.
  244.  
  245.  This simple to use screen capture process allows you
  246.  to select any rectangular area, window, or the
  247.  entire desktop, and capture it with a single
  248.  user-defined keystroke or mouse click. Rotate your
  249.  image at any angle, map colors and modify your
  250.  color palette, and stretch or compress your image to
  251.  any dimension you need.
  252.  
  253.  Preview the modifications prior to output. Save your
  254.  image as an OS/2 or Windows BMP, ICO or metafile.
  255.  Also save as an OS/2 pointer, Windows Cursor, PC
  256.  Paint Brush (PCX), Tagged Image File Format (TIFF),
  257.  Graphic Interchange Format (GIF), Ventura Publisher
  258.  image format (IMG), and MacPaint (MAC) formats.
  259.  
  260.  Features
  261.  
  262.      Captures screen regions and windows for OS/2.
  263.      Output to printer, clipboard, or file.
  264.      Select any window or portion of a window for
  265.       capture.
  266.      Set your own hotkey for quick save or print.
  267.      Save in 2, 4, 8 or 24 bit color or gray scales.
  268.      Flip horizontally/vertically and rotate to any
  269.       angle.
  270.      View previously saved screen captures.
  271.      Stretch or compress captured area.
  272.      Gray shading and color mapping.
  273.      Preview prior to save or print.
  274.  
  275.  Window Washer
  276.  -------------
  277.  
  278.  Window Washer is a screen saver with many
  279.  animation features.
  280.  
  281.  This latest addition of the best selling 32-bit screen
  282.  saver for OS/2 now provides the first FULL SCREEN
  283.  keyboard monitoring feature for OS/2, along with
  284.  new effects and multimedia enhancements. Window
  285.  Washer provides OS/2 users with full password
  286.  security of their personal computers as well as
  287.  providing monitor phosphor burn-in protection.
  288.  
  289.  Features
  290.  
  291.      Provides screen saving and locking functionality.
  292.      Digital audio and video enabled.
  293.      Ability to use TIFF, GIF, BMP and PCX
  294.       backgrounds for Window Washer Effect.
  295.      Ability to play CD's, or any Digital Audio
  296.       supported by MMPM/2.
  297.      Hot Key activation.
  298.      Keyboard/Mouse password protection.
  299.      Keyboard monitoring of Full Screen sessions for
  300.       inactivity.
  301.      Effects include:
  302.  
  303.          Enhanced Window Washer
  304.          Riding Mower
  305.          Spot Light
  306.          Slider
  307.          PM Lines
  308.          Messages
  309.          Digital Movies
  310.          Spinning Globe
  311.  
  312.  Computer Education, Training, and Consulting Services
  313.  -----------------------------------------------------
  314.  
  315.  Computer Education and Training is provided in
  316.  formal classes at One Up's educational facility.
  317.  
  318.  Consulting Services providing outsourcing of platform
  319.  porting for your software and porting workshops.
  320.  
  321.  One Up's educational services offer an unmatched
  322.  curriculum delivered by OS/2 professionals.
  323.  
  324.  Features
  325.  
  326.      Scheduled classes are taught at One Up
  327.       corporate facility in Dallas, Texas.
  328.      Courses include:
  329.          OS/2 Basics for End Users
  330.          Installing, Using and Customizing OS/2
  331.          OS/2 Technical Support
  332.          'C' Language Programming
  333.          C++ Programming
  334.          OS/2 PM Programming
  335.          Advanced OS/2 PM Programming
  336.          SOM Programming for OS/2
  337.          OS/2 LAN Server Administration
  338.          OS/2 Communications Manager
  339.          S.M.A.R.T. Program Development and Migration
  340.            Tools
  341.  
  342.  One Up provides complete application migration and
  343.  porting services. Using the One Up developed Tools -
  344.  The S.M.A.R.T. Tool and SourceLink, in conjunction
  345.  with a migration methodology and the expertise of
  346.  trained and experienced professionals, One Up will
  347.  provide a native source code port for your
  348.  application.
  349.  
  350.  Features
  351.  
  352.      Custom outsourcing for the migration of your
  353.       application across multiple platforms.
  354.      Use of professional with extensive experience in
  355.       porting and multiple platform issues.
  356.      Reduction of effort and time through the use of
  357.       highly productive tools and methodologies.
  358.  
  359.  For sales information regarding these products and
  360.  services please contact:
  361.  
  362.  One Up Corporation
  363.       Sales Department
  364.       1603 LBJ Freeway, Ste 200
  365.       Dallas, Texas 75234
  366.  
  367.       voice (214) 620-1123
  368.       fax   (214) 620-9626
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.