willow
NAME
willow - Washington Information Looker-upper Layered Over
Windows
SYNOPSIS
willow [-cf file | - ] [X Toolkit options]
DESCRIPTION
Willow is an X/Motif based general purpose database front-
end. Usage instructions are available via Willow's online
help screens. More information, including a technical report
describing Willow's architecture is available via ftp from
ftp.cac.washington.edu, in the pub/willow directory. Also,
there is Mosaic home page for Willow information, accessible
via URL:
http://www.cac.washington.edu/willow/
There are two Willow mailing lists available -- willow-
announce, is for Willow release announcements only. The
second, willow-info is for release announcements and general
discussion of Willow by the user community. To join, send a
request to
willow-announce-request@cac.washington.edu
or
willow-info-request@cac.washington.edu.
Please send any questions or comments you have about Willow
to willow@cac.washington.edu.
OPTIONS
Willow accepts all of the standard X Toolkit command line
options along with the additional options:
-cf file
This flag indicates that rather than reading the
configurations for available databases from the standard
/usr/lib/X11/willow/db.conf, Willow should look at the
specified file.
-cf -
This flag indicates that the database configurations
should be read from stdin.
CUSTOMIZING WILLOW
When Willow is run directly on the machine which you are
logged into, you can set and save various options via the
Options menu. However, most users (at least at the
University of Washington) access Willow via the campus
anonymous Willow servers. In this case, any customization
must be done via the X resource system, i.e. your .Xdefaults
file. Following are the available resources. This
information also appears in the file willow.X on the ftp
server.
BASIC RESOURCES
Willow*size: default
Willow can be run at four standard sizes: small, medium, large, and
extra-large. The "size" resource has six legal values: default, small,
medium, large, extra-large, and custom. The value "default" is of
course the default. With this value Willow will configure itself to
be large if your screen is at least 1000x700, otherwise it will be
small. If you prefer to always run at one of the other sizes uncomment
the above line, and put in the name of the size you want. The
value "custom" is discussed in the ADVANCED section below.
Willow*printCommand: lpr
This is the unix command string that Willow will use to print results.
The default is lpr. If the value is "none", then printing is disabled.
Users of the UW campus willow servers may find it useful to set
this resource to "prt -queue " followed by the name of the most
convenient printer on the prt system.
Willow*defaultVirtualBindings:\
osfBackSpace : <Key>Delete\n\
osfDelete : <Key>BackSpace\n\
osfLeft : <Key>Left\n\
osfUp : <Key>Up\n\
osfRight : <Key>Right\n\
osfDown : <Key>Down\n\
osfPageUp : <Key>Prior\n\
osfPageDown : <Key>Next\n\
osfCancel : <Key>Escape\n\
Certain systems, such as a Macintosh using MacX and some PC
software combinations do not recognize the backspace key designated
for a unix keyboard. These are the keyboards bindings that should
enable the "delete" (backspace) key on those systems. Note that if
you set any of the key-bindings you must set *all* of them. If you do
not have PageUp and PageDown keys on your keyboard, you might want
to change the <Key>Prior" and "<Key>Next" to "<Key>F11" and
"Key<F12>" (or any other keys you want to use for this purpose).
Willow's color scheme is controlled by a group of resources as
follows. Uncomment and replace any of the color values you wish to
change. The program xrainbow is useful for previewing the available
colors on your system.
Willow*defaultBackground : SkyBlue1
This is the background color of everything that is not otherwise
specified.
Willow*defaultForeground : black
This is the foreground color of everything that is not otherwise
specified.
Willow*menuBarBackground : SkyBlue1
Background color of the Search window's menu bar.
Willow*menuBarForeground : black
Foreground color of the Search window's menu bar.
Willow*textBackground : SlateGray1
Background color of all text display and entry areas.
Willow*textForeground : black
Foreground color of all text display and entry areas.
Willow*imageBackground : white
Background color of all image areas (just the "About" box and the
spinning globe dialog box)
Willow*imageForeground : black
Foreground color of all image areas.
Willow*buttonBackground : SkyBlue1
Background color of all push-buttons.
Willow*buttonForeground : Black
Foreground color of all push-buttons.
Willow*fieldButtonBackground : SkyBlue1
Background color of field-labels, and corresponding date-range
buttons (if any).
Willow*fieldButtonForeground : Black
Foreground color of field-labels, and corresponding date-range
buttons (if any).
Willow*checkMarkBackground : red
Color of selected "check-boxes" (limit fields on Search window, and
currently selected database in Databases menu).
Here is an alternate color scheme for grey-scale displays.
Willow*defaultBackground : grey90
Willow*defaultForeground : black
Willow*menuBarBackground : grey80
Willow*menuBarForeground : black
Willow*textBackground : white
Willow*textForeground : black
Willow*imageBackground : white
Willow*imageForeground : black
Willow*buttonBackground : grey90
Willow*buttonForeground : black
Willow*fieldButtonBackground : grey90
Willow*fieldButtonForeground : black
Willow*checkMarkBackground : grey20
Willow*reverseVideo: False
If you are running Willow on a monochrome display, and you would
prefer a white on black display rather than the standard black on
white, set the this resource to True. It has no effect if
you are on a color display
Willow*saveType: local
This is the type of save that Willow will try to do by default. Legal
values are local (save to your account on the machine that Willow is
running on), email (save via electronic mail), and ftp (network save
via the FTP program). The default is local, unless you are running off
a non-local server, in which case it is email.
Willow*mailAddress:
This is the e-mail address that Willow will use if the save type is
email. By default there is no value.
Willow*mailSubject: Willow Search Results
This is the Subject line that Willow use for results saved via e-mail.
Willow*ftpHost:
This is the machine that Willow will use for ftp saves. By default
there is no value.
Willow*ftpUserID:
This is the user id that Willow will use for ftp saves. By default
there is no value.
Willow*ftpAppend: True
When Willow saves search results via ftp, and the specified file
name already exists on the destination machine, should it append
to the file, or overwrite it?
Willow*includeQuery: False
If this resource is set to True, Willow will include a description
of the query that generated your results with all of your saved or
printed retrievals. Can be turned on and off manually via the
Options menu as well.
Willow*abbreviatedFields: False
This controls whether Willow retrieves summary and full records
with fully expanded field names or two-letter abbreviations
displayed. You can also set this on the fly via the Options menu.
Probably the only use for abbreviated fields is for downloading
results into your own personal database (such as Reference
Manager).
Willow*animationDelay : 200
How many milliseconds Willow waits between each frame of animation
(i.e. the spinning globe). If it is set to 0, animation is turned off.
ADVANCED RESOURCES
Willow*textTranslations:\
Meta<Key>osfDelete: kill-previous-word()\n\
Alt<Key>osfDelete: kill-previous-word()\n\
Ctrl<Key>D: delete-next-character() \n\
Meta<Key>D: kill-next-word() \n\
Alt<Key>D: kill-next-word() \n\
Ctrl<Key>K: kill-to-end-of-line() \n\
Ctrl<Key>U: kill-to-start-of-line() kill-to-end-of-line() \n\
Ctrl<Key>W: kill-selection() \n\
Ctrl<Key>Y: unkill() \n\
Ctrl<Key>F: forward-character() \n\
Ctrl<Key>B: backward-character() \n\
Ctrl<Key>A: beginning-of-line() \n\
Ctrl<Key>E: end-of-line() \n\
Meta<Key>F: forward-word() \n\
Alt<Key>F: forward-word() \n\
Meta<Key>B: backward-word() \n\
Alt<Key>B: backward-word() \n\
The textTranslations resource defines the keyboard shortcuts that
are available for editing text in any of Willow's type-in areas.
The default setup, shown above, is modeled after the standard
bindings for the emacs text editor. See the Open Software
Foundation's Motif documentation for information on the available
action procedures (the section on XmText).
Fonts are controlled by three resources: textFont is the font used
in all text display and entry areas; buttonFont is used on all
pushbuttons; and defaultFont is used everywhere else. The default
values for these resources depend on what size you are running at.
Following are the default values for the three resources at large
size.
Willow*textFont: -adobe-courier-medium-r*140-75*
Willow*buttonFont: -adobe-helvetica-bold-r*140-75*
Willow*defaultFont: -adobe-helvetica-bold-r*140-75*
Note that Willow purposely defaults to using 75dpi fonts. This
guarantees a correct screen layout. Please be very careful about
changing these font resources. If you have a 100dpi screen, you are
better off running Willow in extra-large mode than switching to
100dpi fonts.
Willow*noBasicMode: False
If this resource is set to True, Willow will never go into Basic
Searching mode by itself. However the "Go To Basic Searching"
button will still be available for appropriate databases.
Willow*printDialog: True
If this resource is set to False, Willow will not pop up the
"Printing..." dialog box after you press the "Print" button. This
can be useful if you have set Willow*printCommand to be an X
program with its own interface that pops up.
Willow*echo: False
If this resource is set to True, all interactions with the database
host are echoed to stderr.
Willow*size: custom
Setting the value of the size resource to custom requires that you set
several other resources as well. Following is an example.
You need to set dimensions and positions for each of the four main
program windows.
Willow*Search.geometry: 580x365+0+1
Willow*Summaries.geometry: 880x500+0-0
Willow*List Browser.geometry: 625x375+130+380
Willow*Full-Record.geometry: 750x700-0+1
And the position of the Help window
Willow*HelpShell.geometry: +70+70
Next, you need to set the following resources which control how closely
spaced the various user-interface components are.
Willow*XmForm*verticalSpacing: 4
Willow*XmForm*horizontalSpacing: 5
Vertical and horizontal pixel spacing between items in the four
main Willow windows.
Willow*XmDialogShell*XmForm*verticalSpacing: 8
Willow*XmDialogShell*XmForm*horizontalSpacing: 5
Vertical and horizontal pixel spacing between items in all Willow
pop-up dialog boxes.
Willow*Search*search_box*XmRowColumn.topOffset: 7
Vertical pixel spacing between the field-labels on the Search window.
Finally, you need to make sure that all three of the font resources
discussed above are explicitly set.
Willow*customFields:
This resource is used for pre-setting which fields you would like
to appear in your retrieved full-records for the available
databases. Note that currently only the "uwbrs" driver supports
custom fields, so this resource will not be usable for Z39.50
databases.
The value of the resource consists of individual lines containing a
database identifier, colon, then a comma separated list of field
abbreviations. The following example would cause full records
retrieved in UW Medline to contain only Abstract, Title, and
Author, and full records in UW Books In Print to contain only
Title, Author, and ISBN --
Willow*customFields:\
UW-MDL1:AB,TI,AU\n\
UW-BINP:TI,AU,IB
The database identifier can be found for the current database by
looking under "About this database" in Willow's File menu, and the
field name abbreviations can be found by setting Abbreviated Fields
in the Options menu Record Retrieval dialog, then retrieving a
full-record.
Willow*userInfo:
This resource can be used to pre-set answers to questions from the
database, most often user-id and/or password for databases that
require a manual login. The value of the resource consists of
individual lines containing a database identifier, colon, question
identifier, colon, and the value. For example, suppose you have two
databases in your Database menu which require a user-id and
password, and the databases are identified by "DB-1" and
"DB-2". You could set the resource as follows --
Willow*userInfo:\
DB-1:UserID:MyName\n\
DB-1:Password:MyPassword\n\
DB-2:UserID:MyName\n\
DB-2:Password:MyPassword\n\
The values to use for the database identifier and the question
identifier are displayed in the dialog box title when Willow asks
you the question. Note that it might not be a good idea to put real
passwords into your .Xdefaults file.
AUTHOR
Willow interface and BRS database driver program by Matt
Freedman (mattf@cac.washington.edu), University of
Washington Computing & Communications. Help sub-system by
Jim Fox (fox@cac.washington.edu), UW Computing &
Communications.
Z39.50 driver program by Bill Cattey (wdc@athena.mit.edu),
Massachusetts Institute of Technology Information Systems.
Based Z39.50 API by Harold Finkbeiner
(harold@forsythe.stanford.edu) Stanford University Data
Center.
- Contributed by
- Ronald Joe Record (rr@sco.com)
- Obtained from
- Anonymous ftp from ftp.cac.washington.edu
SkunkWare 5.0 1995