PORTTOOL: Ports Applications to Win32(TM)

THIS TOOL IS NOT SUPPORTED BY MICROSOFT CORPORATION. IT IS PROVIDED "AS IS" BECAUSE WE BELIEVE IT MAY BE USEFUL TO YOU. WE REGRET THAT MICROSOFT IS UNABLE TO SUPPORT OR ASSIST YOU, SHOULD YOU HAVE PROBLEMS USING THIS TOOL.

PORTTOOL version 2.1 is a 32-bit application for Microsoft(R) Windows(TM) that helps developers port their existing applications to Win32(TM). PORTTOOL's primary interface closely resembles the Windows Notepad applet. As in Notepad, this interface can be used to edit files, one file at a time.

NOTE: PORTTOOL version 2.1 updates PORTTOOL version 2.0, which was distributed with the Win32 Preliminary Software Development Kit (SDK) for Windows NT(TM).

PORTTOOL also lets you select any available system font for the edit environment. For example, you can select a monospaced font to edit source code.

To port a file using PORTTOOL, select the Interactive command from the Port menu. Starting from the top of the current file, PORTTOOL searches each line for substrings that match the predefined port tokens (predefined tokens are discussed below). When it finds a token in a line, PORTTOOL pauses, displays the line with the offending token highlighted, and offers an explanation of the porting problem.

At this point, you can choose one of the following options:

1.> Edit the source file in the editor environment immediately. Notice that the offending line is automatically scrolled into view at the top of the editor window behind the porting dialog box.

2.> Invoke context-sensitive Help on this porting issue.

3.> Change one or more porting options.

4.> Restart the port from the top of the file using the appropriate options.

5.> Resume porting the file where it left off.

6.> Exit the porting process.

PORTTOOL also lets you port one or more files in the background while you work on something else. You can invoke this feature either from the PORTTOOL editor or directly from the command line using the /B (or /b) switch. When PORTTOOL finds a token while porting in the background, it inserts comments into the source code at the token location. These comments identify the token, describe the porting issue, and suggest a possible fix if available.

PORTTOOL reads in a data file (WIN32API.DAT) to initialize its porting information. This data file looks like a standard Windows .INI file and can be customized. You can add, delete, or modify specific porting issues. You can also add tokens to the file to search for other substrings.

PORTTOOL consists of an executable and a dynamic link library (DLL) called PORT.DLL. Any application can call the DLL to perform porting, so a developer can make this functionality available from within another editor on a line-by-line basis. The PORT.H file documents the exported function CheckString and its parameters. This function is the single entry point necessary to port a given string.

For more information on PORTTOOL, see the technical article "Porting 16-Bit Windows Applications to Win32."

{ewc navigate.dll, ewbutton, /Bcodeview /T"Click to open or copy files in the porttool project." /C"samples}