Building Programs in Sun Workshop TeamWare

19

This chapter is organized into the following sections:

Building a TeamWare Target	page 213
Building With Default Values	page 214
Building With NonDefault Values	page 214
Modifying a TeamWare Target	page 215
Fixing Build Errors	page 215

• build directory
• build command
• makefile
• make target

1. From the TeamWare menu bar choose Building, then choose Build New Target to open the Define New Target dialog box.

The Define New Target dialog box contains the value Default in the Makefile and Target text fields. If you do not specify a particular makefile or make target, WorkShop looks for a makefile in the build directory named makefile or Makefile and uses the first make target in that makefile. The build command provided by default is dmake. It is set to run in distributed mode so you can run multiple jobs at the same time on the local host. For information on building in distributed mode, see "Running a Distributed Build" in the online help or Chapter 20, "Using DistributedMake."

2. Type the build path in the Directory text field.

You can also click the button to the right of the text field to open a directory chooser. Choose a directory in the list and click OK to load it into the Directory text field.

3. Click Build at the bottom of the dialog box and watch the build output in the Build Output display pane in the Building window.

The Building window displays the build output when you click the Build button.

1. Type the name of the directory you want to build in and click Apply to apply the change.

You can also select another directory from the Set Build Directory dialog box by clicking the button next to the Directory text field.

2. Type the name of the makefile you want in the Makefile text field.

If you want to choose another makefile from the current build directory, click on the button next to the Makefile text field. Choose a makefile from the list in the Set Makefile dialog box and click OK to load it into the Makefile text field.

3. Type the name of the make target you want in the Target text field.

You can also choose another make target in the current makefile by clicking on the button next to the Target text field. Click OK in the Target Chooser dialog box to load the make target into the text field.

4. Type the name of the build command you want in the Command text field.

---

Note - If the build command is not in your PATH, you might have to specify the full command path.

---

5. Click Build in the dialog box to start a build with the settings you supplied.

To edit an existing TeamWare target, choose Build Edit Target and choose a TeamWare target from the list. The Edit Target dialog box opens, displaying the current settings for the build directory, makefile, make target, and build command. Edit any of these fields or change options, macros, or environment variables. Click Build to rebuild the TeamWare target with your new settings. See "Editing a WorkShop Target" in the online help for detailed information.

Each error gives the name of the file containing the error, the line number on which the error occurs, and the error message.

---

Note - Only Sun compilers produce output that can be converted to hypertext links. If the build command you use does not call Sun compilers, you might lose the link facilities of the Building window.

---

The message area of the text editor displays the error message.

The following steps show how you can use the Building window and the text editor to quickly fix build errors:

1. Click on a highlighted error in the Build Output display.

The editor window opens, displaying the source file containing the error. You do not have to search for the line containing the error--the error line is highlighted in the editor and the cursor is already positioned at the line. The error message is repeated in the footer of the text editor.

2. In the text editor, make sure the source file can be edited.

From the vi editor, choose Version Checkout. From the XEmacs editor, choose Tools VC Check out File file. From the GNU Emacs editor, choose Tools Version Control Check Out.

3. Edit the source file containing the error.

4. In the Building window, click on the Next Error button in the tool bar to go to the location of the next build error in the text editor.

As you click Next Error, notice how each successive error in the build output is highlighted and how the corresponding source line in the text editor is also highlighted.

5. Save your edits to the file.

6. Check the file back in.

7. Click the Build button in the text editor's tool bar to rebuild.

You can also build by clicking the Build button in the Building window's tool bar.

For detailed information on building in TeamWare, see the online help. You can access the online help by choosing Help Building from the Building window or by choosing Help Help Contents Editing and Building Your Source from the main TeamWare Configuring window.