............................Contents


Preface	xvii
1. Introduction to Devguide	1
...Available Companion Tools	1
...How the Tools and Devguide Fit Together	1
...Naming Conventions	2
2. Getting Started	3
...Installing Devguide	3
...Changing Environment Variables to Run Devguide	3
...Starting Devguide	6
......Choosing a Toolkit	6
...Quitting Devguide	7
...Devguide Window	8
......Controls	9
......Element Glyphs	10
......Element Information	12


...On-line Help	13
...Creating Interfaces: A Quick Example	14
......Creating the Interface	14
......Editing the Interface	17
......Testing the Interface	24
......Saving the Interface	25
......Generating Source Code	27
......Compiling Object Code and Running the Results	27
3. Using Devguide	29
...Basic Devguide Operations	30
......Window Menu	30
......Working with Files	31
......Viewing Layers, Windows, and Interfaces	38
......Editing Interfaces	39
......Arranging Elements	41
......Editing Features Using Property Windows	46
......Building and Testing	49
......Using the Drag and Drop Target to Load GIL Files	50
...Understanding the Element Information Area	51
......Element Field	51
......Position Field	52
......Size Field	52
......Pointer Field	52
...Customizing Devguide's Properties	52


......Specifying the Toolkit	53
......Setting the Grid Default	54
......Producing a `.guidedefaults` File	54
...Adding Elements to a User Interface	54
......Placing UI Elements	54
......Sizing Windows and Panes	55
......Moving UI Elements	56
......Cutting, Copying, and Pasting UI Elements	57
......Selecting and Deselecting Elements	58
......Opening UI Element Property Windows	60
......Adding Glyphs and Icons to UI Elements	61
...Editing Help Text	61
...Choosing a Color	63
...Making and Editing Menus	65
......Menu Editor Window	66
......Creating, Editing, and Moving Menus	68
......Setting Properties of the Selected Menu	68
......Inserting and Editing Menu Items	70
......Setting Properties of the Selected Menu Item	71
......Applying Editing Changes to Menus and Menu Items	73
......Leaving the Menu Editor Window	73
......Attaching a Menu to a UI Element	74
......Detaching a Menu From a UI Element	74
......Viewing a Menu and Its Contents	74


...Grouping UI Elements	75
......Creating a Group	75
......Determining a Group's Bounding Box	75
......Ungrouping and Modifying Groups	76
......Editing the Properties of a Group	76
...Handling Events Using Connections	81
......Choosing the Source of a Connection	83
......Choosing the Target of a Connection	84
......Choosing the Event for a Connection	84
......Choosing the Action for a Connection	85
......Defining Callbacks	85
......Viewing Lists of Connections	85
......Establishing a Connection	86
......Modifying a Connection	86
......Deleting a Connection	86
......Tying a Pop-Up Window to a Button	86
......Attaching a Notify Handler to an Object	87
......Connecting Objects in Different Interface Files	87
......Attaching a Menu to a UI Element	87
...Assembling Interfaces into a Project	87
......Creating and Modifying Projects	88
......Creating and Modifying Interfaces	93
...Layering Panes	99
......Sizing Layered Panes	100


......Moving Layered Panes	100
......Scrolling through Layered Panes	100
...Using the Code Generator Tool	101
......Using the File... Button	102
......Using the Properties... Button	102
...Printing Windows	105
4. Devguide Reference	107
...Base Windows	108
......Editing the Properties of a Base Window	108
...Pop-up Windows	113
......Editing the Properties of a Pop-up Window	113
......Dismissing a Pop-up Window	117
......Recalling a Pop-up Window	118
......Tying a Pop-up Window to Other Elements	118
......Setting a Pop-up Window's Appearance Location	118
...Control Areas	118
......Editing the Properties of a Control Area	118
......Aligning Controls in a Control Area	122
...Canvas Panes	123
......Editing the Properties of a Canvas Pane	123
...Term Panes	128
......Editing the Properties of a Term Pane	128
...Text Panes	132
......Editing the Properties of a Text Pane	132


...Buttons	136
......Editing the Properties of a Button	136
...Messages	140
......Editing the Properties of a Message	140
...Settings	144
......Editing the Properties of a Setting	144
...Text Fields	151
......Editing the Properties of a Text Field	151
...Sliders	157
......Editing the Properties of a Slider	157
...Gauges	163
......Editing the Properties of a Gauge	163
...Scrolling Lists	168
......Editing the Properties of a Scrolling List	168
...Drop Targets	175
......Editing the Properties of a Drop Target	175
A. Files Provided With Devguide	183
......`bin` Subdirectory	183
......`demo` Subdirectory	183
......`include` Subdirectory	184
......`lib` Subdirectory	184
......`lib/templates` Subdirectory	184
......`man` Subdirectory	185
......`src` Subdirectory	185


......`doc` Subdirectory	185
B. Porting Devguide 3.0 Applications to Devguide 3.0.1	187
...Background Information	188
...Porting Hints	189
......System Calls	192
......If You Make a Mistake or Change Your Mind	193
C. Adding Devguide to the SPARCworks or ProWorks
...Environment
... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	195
D. Devguide 3.0.1 Release Notes	199
...Compatibility	199
...New Devguide Features	200
...New GXV Features	202
...New GOLIT Features	203
...Devguide Changes From the Previous Release	203
...GNT Changes From the Previous Release	204
...Known Problems with the Devguide Software	204
...Known Problems with the GXV and GXV++ Software	205
...Known Problems with GNT Software	206
...Unresolved Installation Bugs	206
...Unresolved Devguide Bugs	207
...Unresolved GXV Bugs	207
...Unresolved GOLIT Bugs	208
...Unresolved GUIL Bugs	208
...GOLIT Features not Implemented in the Current Release	208


...GNT Features that are not Implemented in the Current Release	210
Index	211