Previous Next Contents Index Doc Set Home


Setting WorkShop Resources

A

If you decide to change some of the resource settings in WorkShop, you should read this appendix for information you need before actually changing the resources.

This appendix organized into the following setcions:

Which Resource File?

page 63

Resources Available for Editing

page 64

Changing a Resource

page 64

Changing Wide Character Fonts in Hyperlink Windows

page 65

WorkShop Resources

page 66

ESERVE Resources

page 71

Which Resource File?

WorkShop provides two variations, CDE (Common Desktop Environment) and non-CDE, of each of its two resource files, WORKSHOP and ESERVE. The WorkShop program loads the correct resource file automatically based on whether the CDE window manager is running or not. The only difference between the CDE and non-CDE variations is that the latter does not define generalized color and font resource for the moftif widgets; it allows the CDE Style Manager control to these widgets.

Resources Available for Editing

Both the ESERVE and WORKSHOP files contain comments that indicate what the following group of resources pertain to, for example: 

! Resources for highlight colors used by WORKSHOP in the editors





WORKSHOP.curPCColor:   #8BD98B





WORKSHOP.visitPCColor:  #EDC9FF





WORKSHOP.breakptColor:   #FF9696







 










The types of WorkShop resources you can edit include:




You should be aware that resources that affect components in the core WorkShop product do not affect TeamWare components or any components started from the Tools menu. Be sure to read the comments that precede each set of resource definitions.






 Changing a Resource




Create a WORKSHOP file or an ESERVE file in your HOME directory (or some other directory as specified in your XFILESEARCHPATH or XAPPLRESDIR). Next, copy those resource definitions from either the CDE/WORKSHOP or non-CDE/WORKSHOP, depending on whether you run under the CDE desktop or not. Consult with your system administrator for assistance if you have difficulty locating the files.



Here are the steps involved in changing a resource definition from the CDE/WORKSHOP file (the process is the same for non-CDE and for ESERVE resource definitions):







	1.	 Create a file called $HOME/WORKSHOP.







	2.	 Go to the CDE/WORKSHOP file:



cd /opt/SUNWspro/WS4.0/lib/locale/<lang>/app-defaults/CDE





	3.	 Open the CDE/WORKSHOP file and copy only the resource definitions you want to change.



	4.	 Paste the resource definitions into $HOME/WORKSHOP.



	5.	 Change the resource settings and start WorkShop.



If WorkShop is already running, exit and restart it.






Note - If you modify the default colors inWorkShop to use a non-specified color, you can cause WorkShop to fill up the color map. 






 Changing Wide Character Fonts in Hyperlink Windows




The HTML widget has a number of wide character (WC) font resources.  The names of these resources, as they would appear if set in the WorkShop resource file, are: 







WORKSHOP*HTML*WCfont:







WORKSHOP*HTML*boldWCFont:







WORKSHOP*HTML*italicWCFont:







WORKSHOP*HTML*fixedWCFont:







WORKSHOP*HTML*fixedboldWCFont:







WORKSHOP*HTML*fixeditalicWCFont:







WORKSHOP*HTML*header1WCFont:







WORKSHOP*HTML*header2WCFont:







WORKSHOP*HTML*header3WCFont:







WORKSHOP*HTML*header4WCFont:







WORKSHOP*HTML*header4WCFont:







WORKSHOP*HTML*header5WCFont:







WORKSHOP*HTML*header6WCFont:







WORKSHOP*HTML*addressWCFont:







WORKSHOP*HTML*plainWCFont:







WORKSHOP*HTML*plainboldWCFont:







WORKSHOP*HTML*plainitalicWCFont:







WORKSHOP*HTML*listingWCFont:







 










These resources serve as flags indicating that non-ascii characters written to a hyperlink display are to be interpreted as multi-byte characters. The multi-byte characters are displayed in the font indicated by the resource.



The resources should be set only in locales in which there is to be multibyte interpretation of non-ascii characters.



Each WC 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 isto produce consistent spacing of a line where ascii and multi-byte characters are mixed. The WC font dimensions are also used for formatting a line written only in the non-WC fonts.




Note - Where WC font resources are set for hyperlink displays of multi-byte 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. 






 WorkShop Resources




The following tables lists the WorkShop color and font resources that you can change.




Table  A-1	 Highlight Colors in WorkShop Editors






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





 










The following resources apply to the graph types in the Data Grapher window.




Table  A-2	 Data Grapher Colors






Resource Name



Description



Default Value






WORKSHOP.dgLineColor:




Color for Line graph type




#OOOOFF





WORKSHOP.dgFillColor:




Color for Fill graph




#FDF5E6





WORKSHOP.dgMeshColor:




Color for Mesh graph type




#OOOOFF





 










The following resources control the colors of the nodes, the  lines (lines or arrows) connecting the nodes, and background color of the graph pane.  




Table  A-3	 Resources for Class Grapher and Call Grapher






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





 










The next two tables list the resource settings for the standard Help window and the smaller Quick Help window.




Table  A-4	 Colors for General Help Viewer 






Resource Name 



Description



Default Value






Colors for Help viewer





WORKSHOP*XmDialogShell.DtHelpDialog*DisplayArea.background:




Background color 




White





WORKSHOP*XmDialogShell.DtHelpDialog*DisplayArea.foreground:




Background color 




Black





Colors for Quick Help viewer





WORKSHOP*XmDialogShell.DtHelpQuickDialog*DisplayArea.background:




Background color 




White





WORKSHOP*XmDialogShell.DtHelpQuickDialog*DisplayArea.foreground: 




Background color 




Black





 











 Hperlink Resources




The following resources set the font type, weight, and angle used in the windows and dialog boxes of the English version of WorkShop.




Table  A-5	 Hyperlink fonts for 'C' locale (English)






Resource Name



Default Value






WORKSHOP*HTML*TitleFont:




-*-lucida-bold-r-normal-*-24-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Font:




-*-lucida-medium-r-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*ItalicFont:




-*-lucida-medium-i-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*BoldFont:




-*-lucida-bold-r-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*FixedFont:




-*-lucidatypewriter-medium-r-normal-*-15-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*FixeditalicFont:




-*-lucidatypewriter-medium-o-normal-*-14-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*FixedboldFont:




-*-lucidatypewriter-bold-r-normal-*-15-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header1Font:




-*-lucida-bold-r-normal-*-24-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header2Font:




-*-lucida-bold-r-normal-*-18-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header3Font:




-*-lucida-bold-r-normal-*-18-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header4Font:




-*-lucida-bold-r-normal-*-14-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header5Font:




-*-lucida-bold-r-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*Header6Font:




-*-lucida-bold-r-normal-*-10-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*AddressFont:




-*-lucida-medium-i-normal-*-10-*-*-*-*-*-*-*





WORKSHOP*HTML*PlainFont:




-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*PlainboldFont:




-*-lucidatypewriter-bold-r-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*PlainitalicFont:




-*-lucidatypewriter-medium-i-normal-*-12-*-*-*-*-*-iso8859-1





WORKSHOP*HTML*ListingFont:




-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-iso8859-1





 






 



Hperlink WC font resources for locales with multi-byte characers. If set, non-ascii characters written to HTML displays are interpretted as multi-byte characters and displayed with font indicated by the resource.




Table  A-6	 Hyperlink fonts for Japanese locale






Resource Name



Default Value






WORKSHOP*HTML*WCfont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*italicWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*boldWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*fixedWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*fixedboldWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*fixeditalicWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header1WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header2WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header3WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header4WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header4WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header5WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*header6WCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*addressWCFont:




-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





WORKSHOP*HTML*plainitalicWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





WORKSHOP*HTML*listingWCFont:




-jis-fixed-medium-r-normal--16-150-75-75-c-160-*-0





 










The following resource lets you set text to automatically wrap or start a new line in a WorkShop window.




Table  A-7	 Automatic Wrapping of Text






Resource Name



Default Value






WORKSHOP*HTML*wrapPreformatText:




True





 










This resource enables you to turn vertical scrollbars off or on.




Table  A-8	  Availability of Vertical Scrollbars






Resource Name



Default Value






WORKSHOP*HTML*verticalScrollbarAlways:




True





 











 Motif-specific Resources




The following tables list resources that are specific to Motif environments only and are not used by CDE.




Table  A-9	  Fonts for Motif (non-CDE) Windowing Systems






Resource Name



Description



Default Value






WORKSHOP.labelFontList:




Font types for labels




-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*





WORKSHOP.buttonFontList:




Font types on buttons




-*-lucida-medium-r-normal-*-12-*-*-*-*-*-*-*





WORKSHOP.textFontList:




Font types in lists




-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*





 










In your resource file, uncomment the following resources to change the fonts in a specific WorkShop window. 




Table  A-10	  Fonts for Specific Windows






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 is applicable to text in a tabular format, such as tables.




Table  A-11	  Font Used in Tabular Windows






Resource Name



Default Value






WORKSHOP.DataMonospacedFont:




-*-lucidatypewriter-medium-r-normal-*-12-*-*-*-*-*-*-*





 










The next table lists all the foreground and background colors used in most WorkShop windows.




Table  A-12	  Colors for WorkShop Windows, Dialog Boxes, Menus, and Buttons






Resource Name



Default Value






WORKSHOP*foreground:




#000000





WORKSHOP*XmTextField*background:




#FFFFFF





WORKSHOP*XmText*background:




#FFFFFF





WORKSHOP*threadsList.background:




#FFFFFF





WORKSHOP*ipeDbxCommandWindow*dtTerm.background:




#FFFFFF





WORKSHOP*ipeProgramIOShell*dtTerm.background:




#FFFFFF





WORKSHOP*XmDrawingArea.background:




#FFFFFF





WORKSHOP*background:




#DEDEDE





WORKSHOP*XmPushButton*background:




#DEDEDE





WORKSHOP*XmMenuShell*background:




#DEDEDE





WORKSHOP*XmList*background:




#DEDEDE





WORKSHOP*topShadowColor:




#FFFFFF





 










Colors for scrollbar background and toggle buttons to indicate toggle on or off.




Table  A-13	  Colors for Trough and Toggle Buttons Used in WorkShop






Resource Name



Default Value






WORKSHOP*HTML*troughColor: 




#DEDEDE





WORKSHOP*XmToggleButton.selectColor: 




#FF9696





WORKSHOP*XmToggleButton.fillOnSelect: 




true





WORKSHOP*XmToggleButtonGadget.selectColor: 




#FF9696





WORKSHOP*XmToggleButtonGadget.fillOnSelect: 




true





 













 ESERVE Resources




The following tables lists the ESERVE resources that you can change.



These resources are used by the edit server to invoke the GNU Emacs and XEmacs text editors. If a fully qualified path is specified, it is executed.




Table  A-14	 Default Paths for Emacs Editors 






Resource Name



Default Value






ESERVE*defaultGnuEmacsPath:




emacs





ESERVE*defaultXEmacsPath:




xemacs





 










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



If a basename is used then it is invoked from the path environment variable. In either case, there is a check to see if the binary to be invoked is a valid executable.



Resource to change cursor to a blinking cursor. Default setting is for non-blinking cursor. 




Table  A-15	 Blinking Cursor Resource 






Resource Name



Default Value






ESERVE*DtTerm.blinkRate:




0





 










The following tables list resources that are specific to Motif environments only and are not used by CDE.




Table  A-16	 Fonts for Motif (non-CDE) windowing systems






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-*-*-*-*-*-*-*:





 











 ESERVE Colors




Colors for text editor windows.




Table  A-17	  Colors for WorkShop Windows, Dialog Boxes, Menus, and Buttons






Resource Name



Default Value






ESERVE*foreground:




black





ESERVE*background:




#dededededede





ESERVE*XmPushButton*background:




#dededededede





ESERVE*XmMenuShell*background:




#dededededede





 










Background color for scrolling lists available from a text editor.




Table  A-18	  Readonly Text Areas (lists)






Resource Name



Default Value






ESERVE*XmList*background:




#dededededede





 










Colors for areas  in text editors containg text other than menus and buttons.




Table  A-19	  Writable Text Areas






Resource Name



Default Value






ESERVE*XmTextField*background:




white





ESERVE*XmText*background:




white





ESERVE*dtTerm*background:




white





ESERVE*readwriteBackground:




white





 
















 



Previous


Next

Contents

Index

Doc Set

Home