Porting Assistant
Making the changes

»

Porting Assistant

Site information

» Send us your comments

Product information

» Products
» Technical information
» Ordering information
» Download software

Related links

» Related web sites
 

After you understand the specific problems identified by the Porting Assistant, it is time to consider editing your code. There are two types of actions you can take:

  • After investigating a flagged problem, you decide it is not a significant issue for your code. You can stop further reporting of the problem by using filtering functions.
  • You need to change your source code.

Filtering...

The Porting Assistant will filter

  • A specific diagnostic on a particular line
  • A specific diagnostic in a source file
  • A specific diagnostic in any source file
  • Any diagnostic containing a specific pattern

You can do the first three filtering operations in either the Editor or the Builder using a menu pick. The menu picks build a pattern to match the current diagnostic and add it to the current list of filters. You accomplish the fourth filtering operation by creating your own pattern or editing one that the Porting Assistant created.

The Builder has a Filter Manager that lets you edit, disable, enable, construct, and save sets of filters.

Changing your source code...

If you decide to change your code, the Porting Assistant helps in several ways. First, you can use any of the editors that are packaged with the Porting Assistant to make the changes. This works particularly well because the Porting Assistant steps you through the issues it has uncovered.

If you have a large number of similar changes to make to multiple source files, try the Search tool (screen shot). The top section of this tool searches for a string matching a regular expression pattern in a set of files in either a single directory or a directory hierarchy.

For example, the Porting Assistant screen searches all files in a directory called search_demo for the string printf. The tool lists all matches in a scrolled window. By double clicking on any match, the file containing the match is read into the editor.

The replace function is at the bottom of the Search tool. Type the replacement string for your located string (eg xprintf) in the Replace With box and select in the scrolled area those matches you wish to replace. Then click on Replace.

Replace will work in one of two ways depending on the check box to the right of the Replace button. If Confirm Replace is checked, Replace will serially bring each replacement location up in the editor for you to confirm. Without the check box, Replace with do a batch replacement. Note that a backup file is always created in case you change your mind.

After you make a change, you will want to know whether your change is correct and deal with managing the changed source file. Running the Porting Assistant check again is a first level check. Just go back to the appropriate check and execute it again. Any source file that passed the last time and has not changed will not be rechecked.

Compiling, linking and debugging can be done either with command line tools or using Compaq's visual software development environment, Compaq FUSE. If you enjoy using the Porting Assistant, you will likely find the Compaq FUSE environment to be familiar and helpful. The two products share many tools and concepts.

[Setup] [Locating] [Understanding] [Making Changes]