workshop(1)

NAME

workshop − An Integrated Programming Environment

SYNOPSIS

workshop [ −standard motif toolkit options ] [ −D [ a.out [ core ] ] [ −s editsessionname ] [ −v ] [ worksetname ]

AVAILABILITY

Available on Solaris 2.4 and 2.5 on SPARC, x86, or PowerPC and running OpenWindows, CDE, or Motif 1.2 or later.

DESCRIPTION

WorkShop is an integrated programming environment that allows you to build, edit, debug, and browse a program without having to explicitly start individual tools. It accepts all standard Motif Toolkit options.

You also have the option of using the text editor of your choice. When you bring up WorkShop for the first time, the Select Editor window appears in which you can set your default text editor to Vi, Xemacs, or GNU Emacs. Once the editor is set, this window no longer appears when you start WorkShop. You can change the editor setting later by choosing Text Editor Options... from the Options menu.

WorkShop Options

You can start WorkShop with the following options:

−D a.out core
Run WorkShop and start a debuggin session. If a.out is specified, load this program into the Debugger. If core is specified, the Debugger will use it to do post-mortem debugging on a.out.

−s editsessionname
Run WorkShop under the edit server named editsessionname. If there is no edit server with the given name, start one. If this option is not specified (that is, the default), WorkShop applications will share the same editor.

−v Display the version of WorkShop or stdout.

worksetname
Load the specified workset into WorkShop. If a workset with the given name does not exist, one is created.

Starting WorkShop

To start WorkShop from a shell, type workshop & at the command prompt.

Starting WorkShop From Emacs

You can start WorkShop directly from the editor without having to return to the command line. When you quit out of Emacs, both WorkShop and Emacs are terminated.

You can start WorkShop from the XEmacs editor in three ways:

∗ Type M-x workshop-start in the minibuffer.

∗ Choose Start WorkShop from the Tools menu.

∗ Click the WorkShop button in the tool bar.

To start WorkShop from the GNU Emacs editor, do the following:

1. Load workshop.el by

Setting the load path in your .emacs file as follows:

   (setq load-path
       (append load-path ’("/directory_where_WorkShop_is_installed/lib")))
   (require ’workshop)

and restart Emacs.

2. Type M-x workshop-start in the minibuffer or choose Start WorkShop
from the Tools menu.

Breaking the WorkShop-Emacs Connection

You can break the connection between Emacs and WorkShop with the command, M-x workshop-quit. If you started WorkShop from Emacs, the command will terminate the WorkShop process while continuing to run Emacs.

If you try to start WorkShop from Emacs and WorkShop does not connect to the editor or does not appear at all, you should terminate WorkShop from Emacs by choosing Quit WorkShop from the WorkShop menu.

Customizations

Windows

WorkShop windows can be customized by changing the X resources default values. The resource file for WorkShop is:

/opt/SUNWspro/sparc-S2/WS4.0/lib/locale/C/app-defaults/WORKSHOP

(Note: if you are running on the Intel platform, replace sparc-S2 with intel-S2; if you are running on the PowerPC platform, replace sparc-S2 with ppc-S2. If you have installed WorkShop in a non-standard location, replace /opt/SUNWsrpo with the appropriate directory.)

You do not have to modify any of the resources in order to use WorkShop. However, if you do want to make modifications, follow these steps:

1. Copy /opt/SUNWspro/sparc-S2/WS4.0/lib/locale/C/app-defaults/WORKSHOP to some private directory, such as ~/.app-defaults.

2. Set XFILESEARCHPATH to include that directory:

csh: setenv XFILESEARCHPATH ~/.app-defaults/%N%S
ksh: export XFILESEARCHPATH=~/.app-defaults/%N%S

3. Modify the resources you are interested in changing. For example, if you wish to change the left-most toolbar button color to red, you would set this resource:

WorkShop∗toolbarButton1.background: red

CAUTION: Gratuitous changes can cause WorkShop to malfunction!

Function Keys

Emacs users can disable WorkShop’s binding of function keys by setting the elisp variable, ebo-bind-fkeys. Add the following code to your .emacs file after the load line for the workshop.el file.

(setq load-path
(append load-path ’("/directory_where_WorkShop_is_installed")))
(required "workshop")
(setq ebo-bind-fkeys nil)

OPTIONS

Takes all standard Toolkit options.

Museum