#	SID	@(#)x11.txt	3.1 - 95/11/10

The X11 Executable
~~~~~~~~~~~~~~~~~~

	If you are not running X11, you should refer to the char.txt
	found in the ANGOSS oasys directory.

	Before attempting to run the X11 version, you will need to set
	the DISPLAY environment variable to the name of your X11
	device.  This is normally your machine name followed by
	a ":0.0".  For example, on my machine named gold:

		DISPLAY=gold:0.0
		export DISPLAY

	or in cshell, on a machine named sodium:

		setenv DISPLAY sodium:0.0
		See documentation on X11 for details.

	Unix users running X11 can make use of mouse and graphics features
	available in the Windows version of SmartWare by executing:

		xangoss

	or,

		xoac

	To change a variety of X defaults for SmartWare, refer to the
	SmartWare X11 Resources section below.


Using the Interface
~~~~~~~~~~~~~~~~~~~
	Pulldown Menus

	When running in a graphical environment, pulldown menus
	(appearing on the second line from the top of the application window)
	can be used in place of command list "ring" menus (which are found
	in the bottom area of the screen). To start SmartWare with pulldowns,
	use the pulldown paramter. For example,

		xoac -pulldown

	When a pulldown menu is opened, an item or list of items will appear
	beneath it. Any items that display a right pointing arrow will contain
	sub-options.

	To access a pulldown menu and select an item on it:

	Mouse

	Using the left mouse button, click on a menu name in the bar. Then,
	with the pulldown menu open, click on an item. Items can also be
	selected directly by dragging the highlighter from an initial position
	on the menu bar.

	Keyboard

	The Alt key activates/deactivates the menu bar. When the menu bar is
	active (when one of the menu names or the Control menu is
	highlighted), the left/right arrows keys move the highlighter
	horizontally along the bar and the up/down arrow keys open menus
	and move the highlighter vertically within the menu. Enter selects the
	highlighted item.

	Alternatively, activate the menu bar with the Alt key and type the
	first letter of a menu item.

	Pulldown menus in SmartWare use dialog boxes rather than the
	sequential prompting style used by command lists. Use the help
	system if you need assistance.


Pulldown Notes
~~~~~~~~~~~~~~
	Pulldown menus are an end user interface which can be turned off
	with the TOOLS PREFERENCES TERMINATE-PULLDOWNS
	command. Power users may require the complete command set
	offered by the command lists.

	In the wordprocessor and spreadsheet modules - the two modules with
	both Entry and Command modes - the Esc key toggles the command
	list on and off. If you use the command list but have not terminated
	the pulldown menus, it is possible for them to become temporarily
	inactive. For instance, if you enter the Text-Editor through the
	command list, the pulldown menu will not be cleared however, any
	commands selected from the pulldown menu will have no affect. This
	retains compatibility with existing macros.

	Toolbars

	Toolbars, or toolboxes, can only be activated by the mouse in a
	graphical environment. Usually toolbars are displayed along the top of
	the application window, just below the pulldown menu bar however,
	developers may choose to place them along the bottom or one side of
	the window.

	Like shortcut keys, toolbars make selecting certain items easier. A
	short description of any tool can be read by positioning the mouse
	pointer over the toolbar, holding the left mouse button down, and then
	dragging the pointer across the icons. The descriptions appear along
	the bottom of the application window as each tool is depressed.


Dialog Boxes
~~~~~~~~~~~~
	Dialog boxes are displayed when SmartWare (in pulldown mode) or
	RAD applications require information regarding a task you have
	selected. Simple dialog boxes, requiring no input, may also be
	displayed to provide information on the current task.

	If a dialog box overlays information on the screen that you would like
	to view, it can be moved by dragging its top border to a new position.
	However, you cannot move a dialog box, or any part of it, outside the
	application's border.

	Options

	Dialog boxes may contain a number of option types.

	Buttons

	Usually, actions that complete or cancel the current task or lead to
	other dialog box options, are performed by selecting buttons. Most
	dialog boxes have an OK button and a Cancel button: OK is used to
	continue the task; Cancel is used to abort. An ellipsis (...)
	following a button indicates that more options are available.

	Text Boxes

	Text boxes are used to enter text or numeric information. When a text
	box is current, a cursor flashes within its input area - this area may
	also have a reversed color scheme.

	List Boxes

	These behave similarly to text boxes except that a prompter or pop-up
	menu (e.g. a file selector) can be accessed by clicking the down arrow
	(located to the right of the input area) or by pressing the F6 key.

	To make a selection from the prompter, double click on an item with
	the left mouse button. A single click will move the pointer but will
	not complete a selection. In cases where multiple items can be
	selected, a single click will toggle the highlighter on and off for
	any items pointed at. Double click the final item to complete a
	multiple item selection.

	Menus

	Menus allow a single item to be selected from a small list of
	mutually exclusive items. When a menu is current, an arrow followed
	by a flashing cursor is displayed to the left of the menu items.

	A selected item always appears highlighted. To move the highlighter,
	click on the desired item or use the space bar and backspace keys.

	Moving Around in a Dialog Box

	To move around within a dialog box:

		Mouse

		Click on the desired option.

		Keyboard

		The up/down cursor keys move to the next/previous option.
		The Tab key moves to the next option.
		The Shift Tab key combination moves to the previous option.
		The left/right cursor keys move to the next/previous option
		except from within text or list boxes.

	Note that pressing the Enter key also moves to the next option.



SmartWare X11 Resources
~~~~~~~~~~~~~~~~~~~~~~~

	An X11 resource is a simple "name: value" binding. For example,

		*background: black
		*foreground: white

	An X11 application builds a "database" of these resources by reading
	a number of files, each file consisting of lines like the above.

	For general (non ANGOSS-specific) information on X11 resources,
	check the X11 documentation.


	SmartWare Resource Database Construction
	========================================

	SmartWare begins by building its own resource database. Note that a
	resource which occurs later in this list, takes precedence over one
	that precedes it.

	- The file "/usr/lib/X11/app-defaults/XAngoss" is read.

	- Any file "XAngoss" inside any directory "X11/app-defaults" pointed
	to by the ANGOSS environment variable is read.

	- The X-server's resource-database, or the file ".Xdefaults" (possibly
	called .Xresources) in the user's home directory is read.

	- The file specified in the XENVIRONMENT environment variable is
	read.

	- Command line options.

	SmartWare X11 Resources Detailed
	================================

	The general form of a resource name is:

		"angoss" * RESOURCE

	For example, the "geometry" resource is given the name:

		angoss*geometry

	Setting the window size to 80 columns by 50 rows can be
	accomplished with the geometry resource:

		angoss*geometry: 80x50


	In the following list, the string "angoss" and the asterisk are
	omitted.

	geometry

	Specifies the size of the "screen". Format is "COLSxROWS", (e.g.,
	"80x50" for 80 cols, 50 rows). Minimum COLS is 80 and minimum
	ROWS is 24. These are strict - SmartWare will use 80x24 if you give
	a screen smaller values than this. Maximum values depend on the
	font selected and the size of the screen. If the maximum size is
	exceeded, SmartWare will again use 80x24. The default is 80x50.

	font

	Names the X11 font to draw text with. It is strongly recommended to
	use the "spc" family of fonts, as they contain the needed special
	characters for box and line drawing etc. The "fixed" font is used
	as a fallback. However, if no font can be found, SmartWare will
	complain and exit.

	There are a number of font tools that may have been shipped with
	your X11 software:

		xlsfonts - lists server fonts available
		xset - user preference utility
		mkfontdir - create fonts.dir file from font files

	Refer to the X11 documentation for more information.


	font.italic
	font.thin-caps
	font.superscript
	font.strikeout
	font.greek
	font.symbol
	font.graphics
	font.thick-caps
	font.gothic
	font.script

	These specify which fonts to use for "WYSIWIG" mode. They
	MUST be the same size as the font named with the "font" variable. It
	is recommended that the "SFF" fonts be used here (refer to the sec-
	tion SFF Fonts for more information). There are no defaults. If
	there is a size-mismatch or, if the font can't be found, the standard
	"font" is used in place.

	title

	This string appears on the title bar of the window. The default is
	"ANGOSS SmartWare". For example:

		angoss*title: ANGOSS SmartWare System

	monitor

	Specifies a string which is used to search the resource database for
	color information. It is called "monitor" because one can place the
	name of a specific monitor here. The usual setup, however, is to use
	one of "color", "grey" or "mono". The value of "monitor" is used to
	make resource names of the form:

		angoss*MONITOR.xx

		where xx is a number from 00 to 15, specifying the Smart
		Color. For example, if the monitor resource is specified
		as: angoss*monitor: color, the Smart system will search for
		the 16 colors:

		angoss*color.00
		angoss*color.01
		angoss*color.02
		etc.
		angoss*color.15

		or, should monitor have the value:

		angoss*monitor:expensive_monitor

		then,

		angoss*expensive_monitor.00
		angoss*expensive_monitor.01
		angoss*expensive_monitor.02
		etc.
		angoss*expensive_monitor.15

		are used instead. Refer to SmartWare Colors in X11.


SmartWare Colors in X11
~~~~~~~~~~~~~~~~~~~~~~~

	There are 16 colors in SmartWare. The resources that tell the X server
	which color to use for a particular SmartWare color are created via
	the "monitor" resource described above.

	The colors are numbered from 00 to 15. The resource values specify a
	valid color name (such as, "red") in the local color-name database.
	For example, if "monitor" is set to "color", then the resource would
	be:

		angoss*color.09: red

	This means that, when you draw in color #9 within SmartWare, the
	color that appears on your screen is "red".


	There are 5 special "monitor" names that SmartWare recognizes:

	color
	colour

	Both mean the same thing and imply that the X server can display a
	minimum of 16 distinct colors. Given this monitor, the following
	default values are used:

		Color X11 name Description:

		00 #000000 black
		01 #000080 dark blue
		02 #008000 dark green
		03 #008080 dark cyan
		04 #800000 dark red
		05 #600080 dark magenta
		06 #805000 brown
		07 #a0a0a0 grey
		08 #303030 dark grey
		09 #0000ff blue
		10 #00ff00 green
		11 #00ffff cyan
		12 #ff0000 red
		13 #ff00ff magenta
		14 #ffff00 yellow
		15 #ffffff white

	gray
	grey

	Both mean the same thing and imply the X server can display a mini-
	mum of 16 distinct gray-scales. Given this monitor, the following
	default values are used:

		Color X11 name:

		00 #000000
		01 #111111
		02 #222222
		03 #333333
		04 #444444
		05 #555555
		06 #666666
		07 #777777
		08 #888888
		09 #999999
		10 #aaaaaa
		11 #bbbbbb
		12 #cccccc
		13 #dddddd
		14 #eeeeee
		15 #ffffff

	mono

	This implies a bi-level display. The background "color" is specified
	by either "black" or "background". For instance:

		angoss*mono.black: black
		angoss*mono.background: black

	are identical resources as far as SmartWare is concerned. The default
	for "black" is "black".

	The foreground color is given by "white" or "foreground". The
	default is "white".

	The synonyms "foreground" and "background" are present so that
	SmartWare will use the X-server defaults other applications use.

	Any other monitor name is permitted, but it is up to the user to setup
	color information for all 16 colors. There are no defaults in this
	situation and a lack of information will cause SmartWare to halt.



	Resource File Example
	~~~~~~~~~~~~~~~~~~~~~
	! ANGOSS X11 Resource File
	angoss*geometry: 90x50

	! FONT settings
	angoss*font spc08x14e
	angoss*font.italic sff08x14b
	angoss*font.thin-caps sff08x14c
	angoss*font.superscript sff08x14d
	angoss*font.strikeout sff08x14e
	angoss*font.greek sff08x14f
	angoss*font.symbol sff08x14g
	angoss*font.graphics sff08x14h
	angoss*font.thick-caps sff08x14i
	angoss*font.gothic sff08x14j
	angoss*font.script sff08x14k

	! MONITOR settings
	angoss*gray.00: black
	angoss*gray.01: gray7
	angoss*gray.02: gray13
	angoss*gray.03: gray20
	angoss*gray.04: gray27
	angoss*gray.05: gray33
	angoss*gray.06: gray40
	angoss*gray.07: gray47
	angoss*gray.08: gray53
	angoss*gray.09: gray60
	angoss*gray.10: gray67
	angoss*gray.11: gray73
	angoss*gray.12: gray80
	angoss*gray.13: gray87
	angoss*gray.14: gray93
	angoss*gray.15: white

	! TITLE
	angoss*title ANGOSS SmartWare



Resource Start Up Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	Resource values can be specified on the command line by passing the
	resource name followed by the required value. The resource name
	must be preceded by a dash (-) and the value separated from the name
	by a space.

	For a list of resource names, refer to the section, SmartWare X11
	Resources Detailed. Note however that the full name is not used,
	that is, "angoss*" is not specified on the command line. For example,
	to set the geometry to 80x24, the command line would be:

		xoac -geometry 80x24

	Resource start up parameters override any other resource settings.



SFF Fonts
~~~~~~~~~

	NOTE: If you've run the xfontinstall script successfully during the
	installation process, the steps performed in the following section
	will not be required.

	The SFF fonts recommended for use as the "WYSIWYG" fonts (e.g.
	font.italic) are placed in the /usr/angoss/resource/X11/fonts
	directory.  Because of differences from one system to another,
	these font files are shipped in Bitmap Distribution Format (BDF)
	and must be compiled before use. The compiled format can be Server
	Normal Font (SNF), Portable Compiled Format (PCF), or X11/NeWS
	format. PCF is the default format.

	To compile fonts, change to the fonts directory and execute the
	sff_install script specifying the desired format and output
	directory.  A typical example:

		cd /usr/angoss/resource/X11/fonts
		./sff_install -pcf /usr/lib/X11/fonts/misc

	The sff_install flag, -pcf, is the default format and is therefore not
	required. The output directory /usr/lib/X11/fonts/misc is a common
	place for system font files however, depending on your system and its
	setup, this may be a different directory. If your X version has the
	xset 	utility, run it with the q flag to determine the current font
	directory.

	NOTE: UnixWare, may not have the PCF compiler; if so, use the -snf
	flag. Sun/Solaris will probably not have either the PCF or SNF
	compilers; use the -fb flag instead. Also, the Sun's equivalent
	directory for system fonts is: /usr/openwin/lib/fonts.

	Use the -x flag with ssf_install to see a list of options.

	When the font files have been compiled, use the X11 utility
	mkfontdir, specifying the output directory used in the sff_install.
	This creates a file that the X server uses to determine what fonts
	are available. For instance:

		mkfontdir /usr/lib/X11/fonts/misc

	Finally, for these changes to take effect, run the X utility, xset
	with the fp parameter (i.e., xset fp rehash). If your X version
	does not have xset, try restarting your X server and font server.


