Introduction to Sun WorkShop

Appendix A

Sun WorkShop and Text Editor Resources

This appendix describes the resources that you can set and gives you the information you need to change the settings.

Changes to Resource Settings

Sun WorkShop uses two resource files:

• WORKSHOP contains the resource settings for Sun WorkShop windows, including the Browsing and Debugging windows.
• ESERVE contains text editor resource settings.

Each resource file has two variations: one for CDE (Common Desktop Environment) and one for non-CDE environments. The CDE version does not define generalized color and font resources for Motif elements; it allows the CDE Style Manager to control these elements.

Both the WORKSHOP and ESERVE files contain comments that indicate what a group of resources pertains to. For example, the following group of resources controls the colors used in the text editors for highlighting:

! Resources for highlight colors used by WORKSHOP in the editors WORKSHOP.curPCColor: #8BD98B WORKSHOP.visitPCColor: #EDC9FF WORKSHOP.breakptColor: #FF9696

See the workshop(1) man page for more information about the resource files.

To change the default value of a resource, do the following:

1. Depending upon the resources you want to change, create a file called WORKSHOP or ESERVE in your home directory (or the directory specified in your XFILESEARCHPATH or XAPPLRESDIR environment variable).

2. Go to the directory where the installed resource file is located.

The resource files are located in the directory where Sun WorkShop is installed:

/opt/SUNWspro/WS6/lib/locale/lang/app-defaults/CDE

/opt/SunWspro/WS6/lib/locale/lang/app-defaults/non-CDE

lang is your current locale (for example, C or ja).

---

Note – If your Sun WorkShop software is not installed in the /opt directory, ask your system administrator for the equivalent path on your system.

---

3. In the installed WORKSHOP or ESERVE resource file, copy the resources and default values that you want to change.

4. Paste the resources and default values into the file you created in your home directory.

5. Change the resource values per the instructions in this appendix.

6. Save the file.

7. Start (or exit and restart) Sun WorkShop.

Editable Sun WorkShop Resources

TABLE A-1 through TABLE A-17 list the Sun WorkShop resources that you can change in the WORKSHOP resource file.

Resources that affect components in the core Sun WorkShop product do not affect Sun WorkShop TeamWare components or any component started from the Tools menu in the WorkShop main window.

---

Note – If you modify the default colors in Sun WorkShop to use a non-specified color, you might cause Sun WorkShop to fill up the color map.

---

Highlight Colors in Editor Windows

The resources listed in TABLE A-1 control the colors used to highlight functions, breakpoints, query matches, and build errors in source code displayed in the text editor windows (for an example of highlighting, see FIGURE 4-1).

TABLE A-1   Editor Highlight Color Resources

Resource Name	Description	Default Value
WORKSHOP.curPCColor	Current function	#8BD98B
WORKSHOP.visitPCColor	Visited function	#EDC9FF
WORKSHOP.breakptColor	Breakpoint	#FF9696
WORKSHOP.disabledBreakptColor	Disabled breakpoint	#BDBDBD
WORKSHOP.matchColor	Pattern or symbol match	#99CFFF
WORKSHOP.errorColor	Current build error	#FFCC40

Data Graph Window Colors

The resources listed in TABLE A-2 control the colors used in the graph types in the Data Graph window of the debugger (see Debugging a Program With dbx).

TABLE A-2   Data Graph Window Color Resources

Resource Name	Description	Default Value
WORKSHOP.dgLineColor	Color for Line graph type	#OOOOFF
WORKSHOP.dgFillColor	Color for Fill graph type	#FDF5E6
WORKSHOP.dgMeshColor	Color for Mesh graph type	#OOOOFF

Call Graph and Class Graph Window Colors

The resources listed in TABLE A-3 control the colors of the nodes, the lines (or arrows) connecting the nodes, and background color of the graph pane in the Call Graph window (see FIGURE 5-4) and the Class Graph window (see FIGURE 5-5).

TABLE A-3   Class Graph and Call Graph Window Resources

Resource Name	Description	Default Value
WORKSHOP*labelNodeBackground	Background color of each node	#EFEFEF
WORKSHOP*viewBackground	Graph pane background (Default uses X's Old Lace)	#FDF5E6
Node Properties When Unhighlighted
WORKSHOP*arcForeground	Arrow between nodes	#000000
WORKSHOP*nodeForegroundColor	Node border	#000000
WORKSHOP*labelNodeForeground	Node text	#000000
Node Properties When Highlighted
WORKSHOP*arcHighlightColor	Arrow between nodes	#FF0000
WORKSHOP*nodeHighlightColor	Node border	#FF0000

Audible Warnings

The resource listed in TABLE A-4 enables you to turn on and turn off audible warning beeps. The possible values are -XmBell and -XmNONE.

TABLE A-4   Audible Warning Resources

Resource Name	Description	Default Value
WORKSHOP*audibleWarning	Turns audible beeps on and off	XmBell

Debugger Buttons

The resource listed in TABLE A-5 enables you to set the delay in milliseconds before debugger and text editor buttons are disabled when dbx starts. This disabling prevents button flashes when you are stepping through code. If you are running Sun WorkShop on a slow system or over an ISDN line, you might want to increase this delay.

TABLE A-5   Debugger Button Disable Delay Resource

Resource Name	Description	Default Value
WORKSHOP.ButtonDisableDelay	Delays disabling of debugger and text editor buttons when dbx starts	250

Dbx Commands and Program I/O Window Output Lines

The resource listed in TABLE A-6 sets the number of lines of output to save in the Dbx Commands window and the Program Input/Output window.

TABLE A-6   Dbx Commands and Program I/O Windows Output Line Resource

Resource	Default Value
WORKSHOP*dtTerm.saveLines	1000

Project make Command

The resource listed in TABLE A-7 sets the make command used to build projects. It must accept the -f flag as well as the target and macros operands. For example, you can write your own wrapper around make that filters out certain warnings and passes the flags on to make. See the dmake(1) and make(1) man pages for more information.

TABLE A-7   Project make Command Resource

Resource	Default Value
WORKSHOP.ProjectMakeCommand	dmake -m serial

Browser Used to Display Web Updates

The resource listed in TABLE A-8 enables you to change the default path for the browser used to display the Sun WorkShop Web updates page (to access the Web updates page, choose Help Web Updates from any Sun WorkShop window).

TABLE A-8   Web Updates Browser Resource

Resource	Description	Default Value
WORKSHOP.browser	Path to browser used to display Web updates	sdtwebclient

Character Fonts in Hyperlink Windows

Many of the windows in Sun WorkShop use hyperlinks to connect to other windows to facilitate the display of related information. For example, clicking on a build error in the Building window causes an editor window to display the source code file that contains the error. Certain resources serve as flags indicating that non-ASCII characters written to a hyperlink display are to be interpreted as multibyte characters. The multibyte characters are displayed in the font indicated by the resource. The resources should be set only in locales in which there is to be a multibyte interpretation of non-ASCII characters.

The names of the resources as they would appear if set in the WORKSHOP resource file are:

WORKSHOP*HTML*WCfont: WORKSHOP*HTML*boldWCFont: WORKSHOP*HTML*plainWCFont: WORKSHOP*HTML*plainboldWCFont: WORKSHOP*HTML*Font: WORKSHOP*HTML*boldFont: WORKSHOP*HTML*plainFont: WORKSHOP*HTML*plainboldFont:

Each WC (wide-character) font resource corresponds to a non-WC font resource. If the WC font resource is set, WC font dimensions determine the line spacing and baseline of text elements written in both the WC font and corresponding non-WC font. The purpose is to produce consistent spacing of a line where ASCII and multibyte characters are mixed. The WC font dimensions are also used for formatting a line written only in the non-WC fonts.

Where WC font resources are set for hyperlink displays of multibyte characters and you change a WC font resource, the size and spacing of WC fonts should be proportional to the size and spacing of non-WC fonts. To get proportional formatting you might need to modify the resources for non-WC fonts.

Hyperlink Resources

The resources listed in TABLE A-9 set the font type, weight, and angle used in hyperlinks in the windows and dialog boxes of the English version of Sun WorkShop. For examples of hyperlinks in Sun WorkShop windows, see FIGURE 3-3, which shows build error links in the Building window.

TABLE A-9   English (C) Locale Hyperlink Font Resources

Resource Name	Default Value
WORKSHOP*HTML*BoldFont	-*-lucida-bold-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*HTML*PlainFont	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*HTML*PlainboldFont	-*-lucidatypewriter-bold-r-normal-*-12-*-*-*-*-*-iso8859-1

TABLE A-10 lists hyperlink wide-character (WC) font resources for locales with multi-byte characters. If set, non-ASCII characters written to HTML displays are interpreted as multibyte characters and displayed with font indicated by the resource.

TABLE A-10   Japanese (ja) Locale Hyperlink Font Resources

Resource Name	Default Value
WORKSHOP*HTML*boldWCFont	-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0
WORKSHOP*HTML*plainWCFont	-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0
WORKSHOP*HTML*plainboldWCFont	-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0

Automatic Text Wrapping

The resource listed in TABLE A-11 lets you set text to automatically wrap or start a new line in a Sun WorkShop window. The default value is True, which means that text automatically wraps when it meets a window border.

TABLE A-11   Automatic Text Wrapping Resource

Resource Name	Default Value
WORKSHOP*HTML*wrapPreformatText	True

Vertical Scrollbars

The resource listed in TABLE A-12 enables you to turn vertical scrollbars off or on.

TABLE A-12   Vertical Scrollbar Resource

Resource Name	Default Value
WORKSHOP*HTML*verticalScrollbarAlways	True

Motif-Specific Resources

TABLE A-13 through TABLE A-17 list resources that are specific to Motif environments only and are not used by CDE.

TABLE A-13   Motif (non-CDE) Windowing Systems Font Resources

Resource Name	Description	Default Value
WORKSHOP.labelFontList	Label font	-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*
WORKSHOP.buttonFontList	Button font	-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*
WORKSHOP.textFontList	List font	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*

In your resource file, uncomment the resources listed in TABLE A-14 to change the fonts in a specific Sun WorkShop window.

TABLE A-14   Window Font Resources

Resource Name	Default Value
WORKSHOP*ipeDbxCommandWindow*userFont	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*ipeProgramIOShell*userFont	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*threadsList*fontList	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*handlerList*fontList	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1
WORKSHOP*processList*fontList	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1

This resource listed in TABLE A-15 is applicable to text in a tabular format, such as tables.

TABLE A-15   Tabular Windows Font Resource

Resource Name	Default Value
WORKSHOP.DataMonospacedFont	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*

Window Foreground and Background Colors

TABLE A-16 lists the resources that control the foreground and background colors used in most Sun WorkShop windows.

TABLE A-16   Windows, Dialog Boxes, Menus, and Buttons Color Resources 

Resource Name	Description	Default Value
WORKSHOP*foreground	Foreground color of windows (text such as labels)	#000000
WORKSHOP*XmTextField*background	Background color of text boxes	#FFFFFF
WORKSHOP*XmText*background	Text color	#FFFFFF
WORKSHOP*threadsList.background	Background color of Threads pane	#FFFFFF
WORKSHOP*ipeDbxCommandWindow*dtTerm.background	Background color of Dbx Commands window	#FFFFFF
WORKSHOP*ipeProgramIOShell*dtTerm.background	Background color of Program Input/Output window	#FFFFFF
WORKSHOP*XmDrawingArea.background	Background color of Stack pane, Data Display, and so forth	#FFFFFF
WORKSHOP*background	Background color of Sun WorkShop windows	#DEDEDE
WORKSHOP*XmPushButton*background	Background color of buttons	#DEDEDE
WORKSHOP*XmMenuShell*background	Background color of menus	#DEDEDE
WORKSHOP*XmList*background	Background color of lists, such as the Match list in the Browsing window	#DEDEDE
WORKSHOP*topShadowColor	Color of shadows at top and left edges of buttons and text boxes	#FFFFFF

Scrollbar Background and Toggle Button Colors

TABLE A-17 lists the resources for the colors of the scrollbar background (trough), and the colors in toggle buttons to indicate toggle on or off.

TABLE A-17   Trough and Toggle Buttons Color Resources

Resource Name	Description	Default Value
WORKSHOP*HTML*troughColor	Background color for scrollbars	#DEDEDE
WORKSHOP*XmToggleButton.selectColor	Color for check boxes when selected	#FF9696
WORKSHOP*XmToggleButton.fillOnSelect	Fill check box when selected	true
WORKSHOP*XmToggleButtonGadget.selectColor	Color for radio buttons when selected	#FF9696
WORKSHOP*XmToggleButtonGadget.fillOnSelect	Fill radio button when selected	true

Editable Text Editor Resources

TABLE A-18 through TABLE A-25 describe the text editor resources that you can change in the ESERVE file.

Text Editor Default Path Names

The resources listed in TABLE A-18 are used by the edit server to start the text editor of your choice. If a fully qualified path is specified, it is executed.

TABLE A-18   Text Editor Default Path Resources

Resource Name	Default Value
ESERVE*defaultGnuEmacsPath	emacs
ESERVE*defaultXEmacsPath	xemacs
ESERVE*defaultNEditPath	nedit
ESERVE*defaultGVimPath	gvim

The values for these resources can either be fully qualified paths or the base name of the command (for instance, myfavoriteemacs).

If a base name is used then it is invoked from the PATH environment variable.

Blinking Pointer

TABLE A-19 lists the resource to change the pointer in text editor windows to a non-blinking pointer. Default setting is for a blinking pointer. Set to 0 for a non-blinking pointer.

TABLE A-19   Blinking Pointer Resource

Resource Name	Default Value
ESERVE*DtTerm.blinkRate	250

Fonts for Text Editor Motif Environments

TABLE A-20 lists font resources for the text editor windows that are specific to Motif environments only and are not used by CDE.

TABLE A-20   Motif (non-CDE) Windowing Systems Editor Window Font Resources

Resource Name	Default Value
ESERVE.labelFontList	-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*
ESERVE.buttonFontList	-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*
ESERVE.textFontList	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*
ESERVE*dtTerm*userFont	-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*

Text Editor Window Colors

TABLE A-21 lists the resource for foreground and background colors in the text editor windows.

TABLE A-21   Editor Windows, Dialog Boxes, Menus, and Buttons Color Resources

Resource Name	Description	Default Value
ESERVE*foreground	Foreground color of windows (text such as labels)	black
ESERVE*background	Background color of windows	#dededededede
ESERVE*XmPushButton*background	Background color of buttons	#dededededede
ESERVE*XmMenuShell*background	Background color of menus	#dededededede

Scrolling List Background Color

TABLE A-22 lists the resource for the background color for scrolling lists available from a text editor.

TABLE A-22   Scrolling List Background Color Resource

Resource Name	Description	Default Value
ESERVE*XmList*background	Background color of scrolling lists	#dededededede

Writable Text Area Background Color

TABLE A-23 lists colors for areas in the text editor windows containing text, other than menus and buttons (not applicable to Emacs and XEmacs).

TABLE A-23   Writable Text Area Background Color Resources

Resource Name	Default Value
ESERVE*XmTextField*background	white
ESERVE*XmText*background	white
ESERVE*dtTerm*background	white
ESERVE*readwriteBackground	white

Balloon Expression Evaluator Popup Dimensions

The resource listed in TABLE A-24 sets the maximum dimensions for the balloon expression evaluator popup that instantly shows you the current value of the expression at which your cursor is pointing in your editor. Width is measured in characters, and height is measured in lines.

TABLE A-24   Balloon Expression Evaluator Popup Dimensions Resources

Resource Name	Default Value
ESERVE.balloonWidth	60
ESERVE.balloonHeight	20

Text Editor Audible Warnings

The resource listed in TABLE A-25 enables you to turn off audible warning beeps in the text editor windows. The possible values are -XmBell and -XmNONE.

TABLE A-25   Text Editor Audible Warning Resource

Resource Name	Description	Default Value
ESERVE*audibleWarning	Turns audible beeps on and off	XmBell